본문으로 건너뛰기

AppLovin Basic Reporting API

최근 업데이트 2026. 10. 03.
팁

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

개요​

인터페이스 소개​

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

유저 단위의 수익 데이터 외에도 AppLovin은 집계 지표 API인 Basic Reporting API를 제공합니다.

통합 절차​

  1. AppLovin 백엔드에 로그인하여 Report Key를 가져옵니다
  2. AE 백엔드에 로그인하여 서드파티 통합 모듈로 이동한 후 AppLovin Basic Reporting API 계획을 추가하고 관련 설정을 완료합니다
  3. AE 시스템이 데이터를 정상적으로 수신했는지 확인하고 리포트를 구축합니다

1. Report Key 가져오기​

AppLovin Basic Reporting API 데이터를 연동하려면 먼저 Report Key를 가져와야 합니다. AppLovin 백엔드에 로그인하여 Account - Key에서 Report Key를 가져오고, 이 Key를 안전하게 보관하십시오

2. 계획 설정​

Report Key를 가져온 후 AE 시스템에 로그인하여 서드파티 통합 모듈에서 새 계획을 설정할 수 있습니다. 다음은 AppLovin Basic Reporting API의 설정 화면입니다. 이 장의 내용에 따라 계획을 생성하십시오:

2.1 인증 정보 설정​

인증 정보 아래의 인증 정보 설정 버튼을 클릭하고, 팝업 창에 인증 작업에서 가져온 정보를 입력합니다

API Key는 방금 가져온 Report Key입니다

2.2 동기화​

동기화 모듈에서 AE 시스템이 AppLovin Basic Reporting API 데이터를 정기적으로 수집하는 전략을 설정할 수 있으며, 매일 특정 시각 또는 매시간 일정 기간의 데이터를 수집하도록 선택할 수 있습니다.

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

이벤트 테이블 저장 설정 스위치를 켜면 수집한 데이터가 모두 이벤트 테이블에 기록됩니다. 이벤트 데이터 저장을 활성화할 것을 권장합니다.

2.4 통합 설정​

통합 설정 모듈에서 데이터 수집의 세부 설정을 제어할 수 있습니다. 여기에는 데이터의 시간 집계 단위, 수집할 지표 필드와 차원, 저장 후 이벤트 이름 등이 포함됩니다.

통합 설정의 내용은 JSON이며, 다음 내용에 따라 커스텀 설정할 수 있습니다:

모듈이름의미
sink_eventevent_name저장 후 이벤트 이름, 커스텀 가능
source

report_types

데이터를 수집할 계층, 리스트 타입. 요소를 하나만 입력하여 한 번에 한 계층의 데이터만 수집할 것을 권장

선택 가능한 값: advertiser, publisher

metrics데이터의 지표, 리스트 타입. 계층마다 지원하는 metrics가 다르므로 입력 시 주의 필요
group_by데이터의 그룹 차원, 리스트 타입. 계층마다 지원하는 group_by가 다르므로 입력 시 주의 필요

Basic Reporting API는 완전히 다른 두 가지 리포트, 즉 광고주 리포트(advertiser)와 퍼블리셔 리포트(publisher)를 제공합니다. 다음 절에서 두 리포트의 설정 방법을 각각 소개합니다:

2.4.1 광고주 리포트(advertiser)​

광고주 리포트의 템플릿은 다음과 같습니다:

{
    "sink_event":
    {
        "event_name": "applovin_advertiser"
    },
    "source":
    {
        "group_by":
        [
            "day",
            "campaign",
            "campaign_id_external",
            "creative_set",
            "creative_set_id",
            "ad_id",
            "ad",
            "ad_type",
            "campaign_ad_type",
            "campaign_package_name",
            "campaign_store_id",
            "campaign_type",
            "country",
            "device_type",
            "external_placement_id",
            "platform",
            "size",
            "traffic_source"
        ],
        "report_types":
        [
            "advertiser"
        ],
        "metrics":
        [
            "impressions",
            "clicks",
            "ctr",
            "conversions",
            "conversion_rate",
            "average_cpa",
            "average_cpc",
            "cost",
            "sales"
        ]
    }
}
  • 템플릿의 시간 단위는 일별이며(광고주 리포트는 시간별 집계를 지원하지 않음), 시스템은 데이터의 day 필드, 즉 데이터의 날짜를 데이터의 시간으로 사용합니다
  • 템플릿에서 사용하는 이벤트 이름은 -- applovin_advertiser입니다
  • 나머지 필드는 모두 저장됩니다
  • 선택 가능한 차원

다음은 광고주 리포트에서 선택 가능한 차원입니다. 실제 필요에 따라 조정할 수 있으며, 필요한 필드의 필드명을 source.group_by에 입력하십시오

필드 이름기본 여부의미
day예리포트 날짜
campaign예Campaign 이름
campaign_id_external예Campaign의 고유 식별자
creative_set예광고 그룹 이름
creative_set_id예광고 그룹 ID
ad_id예광고 ID
ad예광고 이름
ad_type예광고 유형, 값 예시: GRAPHIC, VIDEO, REWARD 또는 PLAY
application트래픽 App 이름
campaign_ad_type예User Acquisition Campaign이면 값은 ua, Retargeting Campaign이면 값은 rt
campaign_package_name예홍보 App의 패키지명, Android는 package name, iOS는 Bundle ID
campaign_store_id예홍보 App의 앱 마켓 ID, Android는 package name, iOS는 iTunes ID의 숫자 부분
campaign_type예Campaign의 최적화 목표(PP, CPE, IAP ROAS, ad ROAS, or ROAS)
custom_page_id광고 그룹에 연결된 iOS 커스텀 제품 페이지 또는 Android 스토어 등록정보 페이지
country예영문 두 글자 Country Code
device_type예기기 유형, 값 예시: phone, tablet 또는 other
external_placement_id예인코딩된 앱 ID
optimization_day_targetCampaign의 목표 최적화 일자(예: day 0 또는 day 7)
platform예기기 플랫폼, 값 예시: android, ios, fireos, tvos
size예광고 크기, 값 예시: INTER, BANNER, MREC, LEADER 또는 NATIVE
target_eventCampaign의 과금 이벤트(CPE Campaign에만 유효)
traffic_source예트래픽 소스, 값은 AppLovin 또는 기타 exchange 채널 이름
  • 선택 가능한 지표

다음은 광고주 리포트에서 선택 가능한 지표입니다. 실제 필요에 따라 조정할 수 있으며, 필요한 필드의 필드명을 source.metrics에 입력하십시오

필드 이름기본 여부의미
average_cpa예평균 CPA(설치)
average_cpc예평균 CPC
clicks예클릭 수
conversions예전환 수(즉 설치 수)
conversion_rate예전환율(설치 수 / 클릭 수)
cost예광고 비용
ctr예클릭률
campaign_bid_goalCampaign의 입찰 목표
campaign_roas_goalCampaign의 ROAS 목표
first_purchase첫 인앱 구매 유저 수(Revenue 콜백 설정 필요)
impressions예노출 수
sales예인앱 구매 횟수(Revenue 콜백 설정 필요)

2.4.2 퍼블리셔 리포트(publisher)​

퍼블리셔 리포트의 템플릿은 다음과 같습니다:

{
    "sink_event":
    {
        "event_name": "applovin_publisher"
    },
    "source":
    {
        "group_by":
        [
            "day",
            "hour",
            "country",
            "ad_type",
            "size",
            "device_type",
            "platform",
            "application",
            "package_name",
            "store_id",
            "placement",
            "application_is_hidden",
            "zone",
            "zone_id",
            "bidding_integration"
        ],
        "report_types":
        [
            "publisher"
        ],
        "metrics":
        [
            "impressions",
            "clicks",
            "ctr",
            "revenue",
            "ecpm"
        ]
    }
}
  • 템플릿의 시간 단위는 시간별이며, 데이터의 day + hour 필드를 데이터의 시간으로 사용합니다
  • 템플릿에서 사용하는 이벤트 이름은 -- applovin_publisher입니다
  • 나머지 필드는 모두 저장됩니다
  • 선택 가능한 차원

다음은 퍼블리셔 리포트에서 선택 가능한 차원입니다. 실제 필요에 따라 조정할 수 있으며, 필요한 필드의 필드명을 source.group_by에 입력하십시오

필드 이름기본 여부의미
day예리포트 날짜
hour예리포트의 시간 값(최근 30일 데이터만 수집 가능). 이 필드를 사용하지 않으면 데이터 시간은 day만 사용
country예영문 두 글자 Country Code
ad_type예광고 유형, 값 예시: GRAPHIC, PLAY, VIDEO, REWARD 또는 MRAID
size예광고 크기, 값 예시: INTER, BANNER, MREC, LEADER 또는 NATIVE
device_type예기기 유형, 값 예시: phone, tablet 또는 other
platform예기기 플랫폼, 값 예시: android, ios, fireos, tvos
application예App 이름
package_name예App의 패키지명, Android는 package name, iOS는 Bundle ID
store_id예App의 앱 마켓 ID, Android는 package name, iOS는 iTunes ID의 숫자 부분이며 가져올 수 없으면 Bundle ID 사용
placement예Placement 이름
application_is_hidden예해당 App이 AppLovin 대시보드에서 숨겨졌는지 여부
zone예Zone 이름(계정에서 Zones를 활성화한 경우에만)
zone_id예Zone ID(계정에서 Zones를 활성화한 경우에만)
bidding_integration예통합된 입찰 방식(값 예시: MAX 또는 Admob Open Bidding)
  • 선택 가능한 지표

다음은 퍼블리셔 리포트가 반환하는 필드입니다. 실제 필요에 따라 반환할 필드를 선택할 수 있습니다

필드 이름기본 여부의미
impressions예노출 수
clicks예클릭 수
ctr예클릭률
revenue예수익화 총수익
ecpm예ECPM

2.5 표준화 필드​

다음은 AppLovin Basic Reporting API의 표준화 필드입니다:

  • 광고주 리포트
원본 필드표준화 필드의미
traffic_sourcete_ads_object.media_source수익화 채널
campaignte_ads_object.campaign_name캠페인 이름
campaign_id_externalte_ads_object.campaign_id캠페인 ID
creative_sette_ads_object.ad_group_name광고 그룹 이름
creative_set_idte_ads_object.ad_group_id광고 그룹 ID
adte_ads_object.ad_name광고 이름
ad_idte_ads_object.ad_id광고 ID
campaign_package_namete_ads_object.app_name앱 이름
campaign_store_idte_ads_object.app_id앱 ID
countryte_ads_object.country국가/지역 코드
platformte_ads_object.platform플랫폼(Android, iOS 등)
USD 고정값te_ads_object.currency광고 집행 통화
impressionste_ads_object.impressions노출 수
clickste_ads_object.clicks클릭 수
conversionste_ads_object.installs전환 수(설치)
costte_ads_object.costUA 비용
  • 퍼블리셔 리포트
원본 필드표준화 필드의미
countryte_ads_object.country국가/지역 코드
platformte_ads_object.platform플랫폼(Android, iOS 등)
applicationte_ads_object.app_name앱 이름
package_namete_ads_object.app_id앱 ID
placementte_ads_object.placement광고 위치
USD 고정값te_ads_object.currency수익화 수익의 통화
impressionste_ads_object.impressions노출 수
clickste_ads_object.clicks클릭 수
revenuete_ads_object.revenue수익화 수익
이 문서가 도움이 되었나요?
이 페이지의 내용