웹 리포팅 API

이 Reporting API를 사용하여 집계된 웹 캠페인 데이터를 JSON 또는 CSV 형식으로 가져옵니다.

이 엔드포인트를 통해 기여 모드(attribution mode)를 지정할 수 있습니다.

요청 형식

다음 기본 URL로 HTTP GET 요청을 전송하여 리포트 요청을 생성합니다:

https://r.applovin.com/webReport

필수 파라미터

파라미터	용도
`api_key`	귀하의 Report Key AppLovin dashboard 우측 상단의 계정을 클릭하고 Keys를 선택하여 Report Key를 찾을 수 있습니다.
`start`¹	리포트 시작일 `«YYYY-MM-DD»` 형식의 날짜 또는 Unix 타임스탬프를 허용합니다. 예: `2012-10-05` 또는 `1336608000`.
`end`¹	리포트 종료일 `«YYYY-MM-DD»` 형식의 날짜 또는 Unix 타임스탬프를 허용합니다. 예: `2012-10-05`, `1336608000` 또는 `now`.
`format`	리포트 형식 `json` 또는 `csv`를 허용합니다.
`columns`	쉼표로 구분된 리포트 열(column) 목록 아래의 허용되는 열을 참조하십시오. 예: `day,campaign`.
`report_type`	`advertiser` (필수)
`attribution_mode`	리포트의 기여 모드(attribution mode) `click`(click-through 기여만 해당) 또는 `click_and_view`(click-through 및 view-through 기여)를 허용합니다.

¹ 이 API의 요청 기간은 90일입니다. 날짜 파라미터가 최근 90일 이내인지 확인하십시오.

선택적 파라미터

파라미터	용도
`day_column`	메트릭은 기본적으로 실시간(realtime)입니다. 코호트(cohort) 하에서 메트릭을 가져오려면 이를 `day`로 설정하십시오(메트릭은 노출 시간으로 소급 기여됩니다).
`limit`	반환되는 행 수의 제한. 예: `500`
`offset`	행을 가져오기 시작할 오프셋. 예: `100`
`having`	숫자 값에 대한 복잡한 필터링을 허용합니다. 이 파라미터는 숫자 열, 비교 연산자 및 논리 연산자의 URL 인코딩된 값을 허용합니다. 예: `impressions%20%3E%200%20AND%20cost%20%3E%200` ("impressions > 0 AND cost > 0"). 참고: 이로 인해 응답이 느려지고 타임아웃 발생 가능성이 높아집니다.
`not_zero`	모든 수치 메트릭의 값이 0인 결과를 필터링하려면 이를 `1`로 설정하십시오.

권장 열

열 이름	포함 내용
`campaign`	캠페인 이름
`campaign_id_external`	캠페인에 대한 고유 참조 캠페인 이름이 변경되어도 이 값은 변경되지 않습니다. `{CAMPAIGN_ID}` 클릭 매크로와 동일한 값입니다.
`cost`	광고주 지출액
`country`	두 자리 국가 코드
`creative_set`	크리에이티브 세트 이름
`creative_set_id`	크리에이티브 세트 ID. 크리에이티브 세트 이름이 변경되어도 이 값은 변경되지 않습니다.
`day`	리포팅 데이터의 날짜
`hour`	리포팅 데이터의 시간 (지난 30일 동안의 데이터만 사용 가능)

선택적 열

열 이름	포함 내용
`ad_id`	광고 ID
`audience_strategy`	캠페인 오디언스 최적화 전략 (`universal`, `prospecting` 또는 `discovery`)
`average_cpc`	평균 CPC
`campaign_bid_goal`	CPP 및 CPE 캠페인의 캠페인 입찰 목표(달러($) 값으로 표시). 이 열을 요청할 때는 `campaign` 열도 함께 요청해야 합니다.
`campaign_type`	캠페인 최적화 유형 (`CPP`, `CPE` 또는 `ROAS`)
`chka_usd_«x»`¹	특정 기간 동안 기여된 총 체크아웃 매출 (`«x»`는 `0d`, `1d`, `3d`, `7d`, `14d`, `28d` 중 하나)
`clicks`	클릭 수
`cpp_«x»`¹	특정 기간 동안의 구매당 비용 (`«x»`는 `0d`, `1d`, `3d`, `7d`, `14d`, `28d` 중 하나)
`ctr`	클릭 수 ÷ impression 수
`impressions`	impression 수
`optimization_day_target`	캠페인 타겟으로 선택한 최적화 일수 (예: `0`일 또는 `7`일)
`placement_type`	`INTER`, `REWARDED_INTER` 또는 `CTV`
`platform`	`android`, `ios`, `fireos`, `tvos` 또는 `ctv`
`roas_«x»`¹	특정 기간 동안의 총 ROAS (`«x»`는 `0d`, `1d`, `3d`, `7d`, `14d`, `28d` 중 하나)
`sales`	기여된 판매(sales) 이벤트 수
`sales_«x»`¹	특정 기간 동안의 판매 (`«x»`는 `0d`, `1d`, `3d`, `7d`, `14d`, `28d` 중 하나)

¹기간은 impression 시간 기준 롤링 윈도우로 지정됩니다. 0d는 impression 시간 이후 24시간 이내의 이벤트를 의미하며, 1d는 48시간, 3d는 96시간 등을 의미합니다.

신규 고객 데이터 열

열 이름	포함 내용
`nc_d0_checkouts`	impression 이후 24시간 동안 신규 고객이 수행한 체크아웃 수.
`nc_d0_checkout_rev`	impression 이후 24시간 동안 측정된 신규 고객의 총 매출.
`nc_d0_cpp`	지출액을 신규 고객 D0 체크아웃 수로 나눈 값.
`nc_d0_roas`	신규 고객 D0 체크아웃 매출을 지출액으로 나눈 값.
`nc_percent_d0_checkouts`	신규 고객이 생성한 D0 체크아웃의 비율.
`nc_percent_d0_checkout_rev`	신규 고객이 생성한 D0 체크아웃 매출의 비율.
`nc_d7_checkouts`	impression 이후 192시간 동안 신규 고객이 수행한 체크아웃 수.
`nc_d7_checkout_rev`	impression 이후 192시간 동안 측정된 신규 고객의 총 매출.
`nc_d7_cpp`	지출액을 신규 고객 D7 체크아웃 수로 나눈 값.
`nc_d7_roas`	신규 고객 D7 체크아웃 매출을 지출액으로 나눈 값.
`nc_percent_d7_checkouts`	신규 고객이 생성한 D7 체크아웃의 비율.
`nc_percent_d7_checkout_rev`	신규 고객이 생성한 D7 체크아웃 매출의 비율.
`new_visitor_rate`	웹사이트 방문 중 신규 방문자의 비율.

리드(Leads) 열

열 이름	포함 내용
`generate_lead_«x»`	주어진 기간 동안 최소 하나의 리드를 생성한 impression 수 (`«x»`는 `0d`, `1d`, `3d`, `7d`, `14d`, `28d` 중 하나).
`cost_per_lead_«x»`	특정 기간 동안의 지출액을 리드 수로 나눈 값 (`«x»`는 `0d`, `1d`, `3d`, `7d`, `14d`, `28d` 중 하나).
`lead_roas_«x»`	특정 기간 동안 생성된 리드 가치를 광고 지출액으로 나눈 값 (`«x»`는 `0d`, `1d`, `3d`, `7d`, `14d`, `28d` 중 하나).

열 필터링

모든 열을 기준으로 리포트를 필터링할 수 있습니다. 필터링 시 필터 중 하나와 정확히 일치하는 항목을 검색합니다.

열 기준으로 필터링하려면 다음 URL 파라미터를 추가하십시오: filter_columnname=«onefilter,anotherfilter,thirdfilter»

예를 들어 Android 플랫폼의 데이터만 보려면 다음 URL 파라미터를 설정하십시오: filter_platform=Android

모든 열 목록은 위의 표를 참조하십시오.

일부 열은 filter_not_columnname=«onefilter,anotherfilter»를 통한 부정 필터(negative filter)를 지원합니다.

열 정렬

리포트 필터링과 유사한 방식으로 리포트를 정렬할 수 있습니다.

예를 들어 리포트를 campaign 기준으로 정렬하려면 다음 URL 파라미터를 추가하십시오: sort_campaign=ASC

허용되는 값은 오름차순의 경우 ASC, 내림차순의 경우 DESC입니다. 모든 정렬은 사전식 정렬(lexicographical sort)입니다.

리포트 형식

JSON 또는 CSV의 두 가지 형식으로 리포트를 요청할 수 있습니다.

시간대

리포팅 API의 모든 데이터는 UTC(협정 세계시) 기준입니다.

요청 예시

https://r.applovin.com/webReport?api_key=«your-report-key»&start=2024-04-20&end=now&columns=day,campaign,impressions,clicks,ctr,cost,sales&format=json&report_type=advertiser&attribution_mode=click

서드파티 피드 연동

Lead gen용 Conversion API

운영정책 이용약관 퍼블리셔 정책 디맨드 파트너 정책 플랫폼 규제 프라이버시 Your Privacy Choices

쿠키설정