AppLovin Asset Reporting API

최근 업데이트 2026. 10. 05.

팁

서드파티 데이터 통합으로 생성된 데이터는 클러스터의 소비 데이터양에 포함됩니다

개요

인터페이스 소개

인터페이스명	타입	세분화	어트리뷰션	비용	수익	노출	클릭	전환
Asset Reporting API	API	소재 집계 데이터		✅		✅	✅

AppLovin Asset Reporting API는 소재 수준의 광고 집행 집계 데이터를 가져오는 데 사용되며, 소재, 캠페인, 광고 그룹, 노출, 클릭, 비용 등의 정보를 포함합니다.

현재 통합은 AppLovin의 날짜 기반 Asset Reporting API를 사용합니다:

GET https://r.applovin.com/assetAnalyticsReport

AppLovin에 따르면 전날 데이터는 UTC 06:00 이후에 안정됩니다. 인터페이스는 최근 45일의 데이터만 요청할 수 있습니다.

통합 절차

AppLovin 백엔드에 로그인하여 Report Key를 가져옵니다.
AE 백엔드에 로그인하여 서드파티 통합 모듈로 이동한 후 AppLovin Asset Reporting API 계획을 새로 만들고 설정을 완료합니다.
단일 수집을 실행하거나 예약 작업을 기다려 이벤트 테이블이 데이터를 정상적으로 수신했는지 확인합니다.
소재, 캠페인, 광고 그룹, 비용, 노출, 클릭 등의 필드를 기반으로 분석 리포트를 구축합니다.

1. Report Key 가져오기

Asset Reporting API를 연동하기 전에 먼저 Report Key를 가져와야 합니다. AppLovin 백엔드에 로그인하여 Account - Keys에서 가져온 후 안전하게 보관하십시오.

AppLovin 后台 Account → Keys 页，箭头指向 Report Key

2. 계획 설정

AppLovin Asset Reporting API 集成方案配置页，含授权信息、定时拉取和入库设置

2.1 인증 정보 설정

인증 정보 아래의 인증 정보 설정 버튼을 클릭하고 팝업 창에 AppLovin Report Key를 입력합니다.

授权信息弹窗，在 API Key 栏填写 AppLovin Report Key

2.2 동기화

동기화 모듈에서 데이터 수집 전략을 설정할 수 있습니다. 매일 UTC+8 16:00에 지난 1일의 데이터를 수집하는 것을 권장합니다. 이 시점에는 AppLovin의 전날 데이터가 안정되는 시각인 UTC 06:00이 이미 지났습니다.

2.3 이벤트 테이블 저장 설정

Asset Reporting API 데이터는 이벤트 테이블 분석에 사용됩니다. 계획을 생성할 때 이벤트 테이블 저장 설정을 활성화하십시오. 수집한 데이터는 설정한 이벤트 이름으로 기록됩니다.

2.4 통합 설정

통합 설정은 JSON 객체이며, 저장 이벤트 이름, 요청 열, 수치 필드 타입 및 인터페이스 필터 파라미터를 설정할 수 있습니다.

모듈	이름	타입	의미
`sink_event`	`event_name`	문자열	저장 후 이벤트 이름, 커스텀 가능
`source`	`group_by`	문자열 리스트	요청하는 소재 및 광고 계층 차원
`source`	`metrics`	문자열 리스트	요청하는 수치 지표
`transfer`	`double_columns`	문자열 리스트	수치 타입으로 기록하는 지표 필드
최상위 파라미터	`limit`	문자열	날짜별 요청에서 반환하는 최대 행 수
최상위 파라미터	`offset`	문자열	날짜별 요청에서 데이터를 읽기 시작하는 오프셋
최상위 파라미터	`not_zero`	정수	`1`로 설정하면 모든 수치 지표가 0인 결과를 제외
최상위 파라미터	`allPurpose`	JSON 문자열	차원 필터, 제외 필터, 수치 임곗값 필터

기본 템플릿

{
  "sink_event": {
    "event_name": "applovin_asset_report"
  },
  "sink_user": [],
  "source": {
    "group_by": [
      "asset_id",
      "asset_name",
      "asset_url",
      "campaign",
      "campaign_id",
      "campaign_package_name",
      "creative_set",
      "creative_set_id"
    ],
    "metrics": [
      "clicks",
      "cost",
      "ctr",
      "impressions"
    ]
  },
  "transfer": {
    "double_columns": [
      "clicks",
      "cost",
      "ctr",
      "impressions"
    ]
  }
}

템플릿 설명:

source.group_by와 source.metrics는 AppLovin 요청의 columns 파라미터로 병합됩니다.
clicks, cost, ctr, impressions는 수치 타입으로 기록되도록 transfer.double_columns에도 함께 설정해야 합니다.
템플릿의 이벤트 이름은 applovin_asset_report이며, 필요에 따라 수정할 수 있습니다.
시스템은 항상 format=json으로 요청하며, 항상 sort_impressions=DESC를 사용하여 노출 수 내림차순으로 정렬합니다.

필터 및 페이지 파라미터를 포함한 전체 예시

다음 예시는 지정한 두 소재 이름으로 필터링하고, cost > 10이면서 impressions > 2000인 데이터만 유지하며, 모든 수치 지표가 0인 결과를 제외하고, 날짜마다 1번째 행부터 최대 100행을 읽는다는 의미입니다.

{
  "limit": "100",
  "offset": "0",
  "not_zero": 1,
  "allPurpose": "{\"asset_name\":\"소재A.mp4,소재B.html\",\"greater_than_cost\":10,\"greater_than_impressions\":2000}",
  "sink_event": {
    "event_name": "applovin_asset_report"
  },
  "sink_user": [],
  "source": {
    "group_by": [
      "asset_id",
      "asset_name",
      "asset_url",
      "campaign",
      "campaign_id",
      "campaign_package_name",
      "creative_set",
      "creative_set_id"
    ],
    "metrics": [
      "clicks",
      "cost",
      "ctr",
      "impressions"
    ]
  },
  "transfer": {
    "double_columns": [
      "clicks",
      "cost",
      "ctr",
      "impressions"
    ]
  }
}

2.5 선택 가능한 차원 및 지표

선택 가능한 차원

필요한 차원을 source.group_by에 입력하십시오.

필드 이름	기본 여부	의미
`asset_id`	예	소재 ID
`asset_name`	예	소재 이름
`asset_url`	예	처리 전 원본 소재의 URL
`campaign`	예	Campaign 이름
`campaign_id`	예	Campaign 고유 식별자, Basic Reporting API의 `campaign_id_external`에 대응
`campaign_package_name`	예	Campaign에서 홍보하는 앱의 패키지명
`creative_set`	예	Creative Set 이름, 즉 광고 그룹 이름
`creative_set_id`	예	Creative Set ID, 이름이 바뀌어도 ID는 유지됨

선택 가능한 지표

필요한 지표를 source.metrics에 입력하고, 수치 필드는 transfer.double_columns에도 함께 입력하십시오.

필드 이름	기본 여부	의미
`clicks`	예	클릭 수
`cost`	예	광고주 지출
`ctr`	예	클릭 수를 노출 수로 나눈 값
`impressions`	예	노출 수

3. 표준화 필드

다음 필드는 te_ads_object의 해당 플랫폼 표준 필드에 기록됩니다:

원본 필드	표준화 필드	타입	의미
`campaign`	`te_ads_object.campaign_name`	string	캠페인 이름
`campaign_id`	`te_ads_object.campaign_id`	string	캠페인 ID
`campaign_package_name`	`te_ads_object.app_name`	string	홍보 앱 패키지명
`creative_set`	`te_ads_object.ad_group_name`	string	광고 그룹 이름
`creative_set_id`	`te_ads_object.ad_group_id`	string	광고 그룹 ID
`cost`	`te_ads_object.cost`	double	광고 비용
`clicks`	`te_ads_object.clicks`	double	클릭 수
`impressions`	`te_ads_object.impressions`	double	노출 수

이 문서가 도움이 되었나요?

개요​

인터페이스 소개​

통합 절차​

1. Report Key 가져오기​

2. 계획 설정​

2.1 인증 정보 설정​

2.2 동기화​

2.3 이벤트 테이블 저장 설정​

2.4 통합 설정​

기본 템플릿​

필터 및 페이지 파라미터를 포함한 전체 예시​

2.5 선택 가능한 차원 및 지표​

선택 가능한 차원​

선택 가능한 지표​

3. 표준화 필드​

개요