리포트 API - 광고주
광고주가 탭조이 오퍼월의 리포트 API에 액세스하여 상세한 데이터를 검색하고, 앱 성과를 모니터링하고 이를 평가하고, 리포트 쿼리를 최적화하여 더 나은 캠페인 분석 정보를 얻을 수 있습니다.
읽는 시간 4분최근 업데이트: 2일 전
광고주는 리포트 API 사용하여 오퍼월에서 게재되는 광고에 대한 리포트 데이터를 가져올 수 있습니다.
필수 조건
API로 인증해야 합니다.- 리포트 API를 통해 캠페인을 관리하는 방법에 대한 자세한 내용은 캠페인 관리를 참고하십시오.
- 리포트 API로 오류 처리 및 제한 사항에 관한 내용을 알아보려면 리포트 API 베스트 프랙티스를 참고하십시오.
광고주 리포트 지표
리포트 API 사용하여 수익, 노출, 전환 등의 지표를 비롯한 광고 세트와 멀티 리워드 이벤트의 퍼포먼스 데이터를 요청할 수 있습니다. 모든 사용 가능한 광고주 리포트 지표는 아래 차트에 나와 있습니다. 광고주는 퍼포먼스 지표를 검색하는 데 다음 기본 쿼리로 시작하는 것이 좋습니다.query { adSet(id: "00000000-0000-0000-0000-000000000000") { insights(timeRange: {from: "YYYY-MM-DDT00:00:00Z", until: "YYYY-MM-DDT00:00:00Z"}) { timestamps reports { impressions } } }}
광고주 지표 | 설명 |
|---|---|
| amount | 이 이벤트에 대한 입찰가입니다. |
| averageBid | 총 지출을 총 전환 수로 나눈 값입니다. |
| callToActionClicks | CTA가 있는 경우 사용자가 이를 클릭한 횟수입니다. |
| clickToConversionTime | 여러 방식으로 세분화된 전환 시간 데이터를 클릭합니다. CTCT 지표는 매일 첫 UTC 시간에만 리포트됩니다. |
| conversions | 광고 목표에 따른 전환 수입니다. |
| csConversions | 광고 목표에 따른 고객 서비스 전환 수입니다. |
| csSpend | 총 고객 지원 지출액입니다. |
| ecpi | 총 지출을 총 참여 수로 나눈 값입니다. |
| engagementInstalls | 참여를 통해 추론된 설치 수입니다. |
| iaaRevenue | 선택한 기간 동안 오퍼에서 창출한 총 광고 수익입니다. |
| iapRevenue | 선택한 기간 동안 오퍼에서 창출한 총 IAP 수익입니다. |
| impressions | 오퍼월에서 광고를 클릭한 횟수입니다. 이 지표는 |
| offerwallAverageRank | 광고가 게재된 평균적인(가중치 반영) 오퍼월 위치입니다. 값은 1부터 오름차순으로, 1은 오퍼월의 최상위 포인트를 나타냅니다. 값이 0이면 선택한 기간 동안 오퍼가 오퍼월에 표시되지 않았음을 의미합니다. |
| offerwallImpressions | 오퍼월에 광고가 표시된 횟수입니다. 광고는 오퍼월에 표시되지만 사용자가 보지 못할 수 있습니다. 즉, 사용자가 광고가 표시될 만큼 화면을 스크롤하지 않았습니다. 광고주가 아래의 |
| offerwallTrueImpressions | 오퍼월에서 사용자가 광고를 본 횟수입니다. 각 보기는 진정성 있는 노출로 등록됩니다. |
| returnOnAdSpend | 매일 설치한 사용자의 ROAS(광고 비용 대비 수익률)입니다. ROAS 지표는 매일 첫 UTC 시간에만 리포트됩니다. |
| dayXRoas | 설치 후 |
| dayXRoasAdRevenue | 선택한 기간 동안 오퍼를 설치한 사용자가 설치 후 |
| dayXRoasEngagements | 설치 후 |
| dayXRoasIapRevenue | 선택한 기간 동안 오퍼를 설치한 사용자가 설치 후 |
| dayXRoasRevenue | 선택한 기간 동안 오퍼를 설치한 사용자가 설치 후 |
| dayXRoasSpend | 설치 후 광고주가 |
| spend | 총 지출액입니다. |
| totalRevenue | 선택한 기간 동안 오퍼를 통해 창출한 총 수익(IAP + 광고 수익)입니다. 이 값은 |
- CVR(전환율)
- 명령 CVR
- 전환/노출
- CTR(Click-through Rate)
- 총 지출 기준 ROAS(리포트 API는 복합 지출 기준 ROAS를 반환함)
지표 세그먼트
API는 쿼리에 세그먼트 필드를 추가하여 이벤트, 퍼블리셔 앱, 국가 등으로 세분화된 퍼포먼스 데이터를 반환할 수 있습니다. 리포트 API는 다음과 같은 세분화를 지원합니다.- country
- attributionSource
- language
- platform
- id(퍼블리셔 앱 ID)
- id(광고 세트/오퍼 ID)
- multiRewardEngagementEvent
세분화 예시
국가, 어트리뷰션 소스, 언어별 세그먼트
graphql title="Query" { adSet(id: "00000000-0000-0000-0000-000000000000") { insights(timeRange: {from: "2024-08-01T00:00:00Z", until: "2024-08-01T11:59:59Z"}, timeIncrement: DAILY) { timestamps reports { country attributionSource language conversions } } } }
플랫폼별 세그먼트
graphql title="Query" { advertiser{ id campaigns(first: 2){ nodes{ insights{ reports{ impressions platform } } } } } }
퍼블리셔 앱별 세그먼트
graphql title="Query" query { adSet(id: "00000000-0000-0000-0000-000000000000") { ads { id insights(timePreset: TODAY) { reports { app { bundleId } impressions conversions spend } } } } }
광고 세트/캠페인별 세그먼트
graphql title="Query" query { advertiser { adSets(first: 50, configuredStatus: ACTIVE) { edges { node { id insights(timeRange: {from: "2024-11-15T00:00:00Z", until: "2024-11-16T00:00:00Z"}) { timestamps reports { conversions spend } } } } } } }
멀티 리워드 참여 이벤트별 세그먼트
graphql title="Query" { adSet(id: "00000000-0000-0000-0000-000000000000") { id insights(timeRange: {from: "2024-11-15T00:00:00Z", until: "2024-11-15T11:59:59Z"}, timeIncrement: DAILY) { timestamps reports { conversions returnOnAdSpend { day0Roas } multiRewardEngagementEvent { eventName } } } } }
필터링 기능
API는 쿼리에 필터를 추가하여 지정된 소스의 퍼포먼스 지표만 반환합니다. 리포트 API는 다음 필터링 기능을 지원합니다.- adSet(단일 광고 세트)
- adSets(여러 광고 세트)
- appIds(퍼블리셔 앱)
- configuredStatus(ACTIVE, ARCHIVED, PAUSED)
- countries
- timePreset
- timeRange
필터링 예시
광고 세트로 필터링
이렇게 하면 결과가 단일 _adSet_로 제한됩니다.query { adSet(id: "00000000-0000-0000-0000-000000000000") { insights(timeRange: {from: "2024-08-06T00:00:00Z", until: "2024-08-07T00:00:00Z"}) { timestamps reports { impressions conversions spend offerwallAverageRank } } }}
여러 광고 세트로 필터링
이렇게 하면 결과가 _first_나 last x개 광고 세트로 제한됩니다.query { advertiser { adSets(first: 2) { edges { node { insights(timePreset:TODAY) { reports { conversions } } } } } }}
퍼블리셔 앱으로 필터링
이렇게 하면 결과가 지정된 퍼블리셔 앱 ID로 제한됩니다.query { adSet(id: "00000000-0000-0000-0000-000000000000") { insights(filter:{appIds: ["00000000-0000-0000-0000-000000000000", "00000000-0000-0000-0000-000000000000"]}) { timestamps reports { conversions } } }}
설정된 상태로 필터링
이렇게 하면 결과가 지정된 상태의 광고 세트나 캠페인으로 제한됩니다. 옵션:ACTIVEARCHIVEDPAUSEDquery { advertiser { adSets(first: 2, configuredStatus: ACTIVE) { edges { node { insights(timePreset:TODAY) { reports { conversions } } } } } }}
국가로 필터링
이렇게 하면 결과가 지정된 국가로 제한됩니다.query { adSet(id: "00000000-0000-0000-0000-000000000000") { insights(filter:{countries: [JP, US]}) { timestamps reports { conversions } } }}
프리셋 기간으로 필터링
이렇게 하면 결과가 프리셋 기간으로 제한됩니다. 상대적인 기간이며, 결과는 쿼리가 실행되는 시점에 따라 달라집니다. 옵션:LAST 30DLAST WEEKTODAYYESTERDAY참고
데이터 집계 레벨을 정의하려면 timeIncrement를 포함합니다. 이는 DAILY, HOURLY, MONTHLY 값을 가질 수 있습니다. timeIncrement는 선택 사항 파라미터이며 _ALL_로 기본 설정됩니다. query { adSet(id: "00000000-0000-0000-0000-000000000000") { insights(timePreset:LAST_30D, timeIncrement: DAILY) { reports { impressions } } }}
절대 시간 범위로 필터링
이렇게 하면 결과가 지정된 절대 기간으로 제한됩니다. 최대 범위는 3개월이며, 최초 날짜는 지난 2년까지 지원됩니다.참고
데이터 집계 레벨을 정의하려면 timeIncrement를 포함합니다. 이는 DAILY, HOURLY, MONTHLY 값을 가질 수 있습니다. timeIncrement는 선택 사항 파라미터이며 _ALL_로 기본 설정됩니다. query { adSet(id: "00000000-0000-0000-0000-000000000000") { insights(timeRange: {from: "2024-11-15T00:00:00Z", until: "2024-11-17T00:00:00Z"}, timeIncrement: DAILY) { reports { impressions } } }}
사용 중단 예정인 측정 항목
다음 레거시 측정 항목은 2025년 2월 3일에 리포트 API에서 제거되었습니다. API 쿼리를 통해 탭조이의 오퍼월에서 데이터를 가져올 때 오류를 방지하기 위해 아래의 굵은 글씨로 된 측정 항목을 참조하지 마십시오.- Enums > TargetConnectionType > MOBILE
- Enums > TargetDeviceType > WINDOWS