본문으로 건너뛰기

TopOn 디바이스 수준 데이터 리포트

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

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

개요​

인터페이스 소개​

인터페이스명타입세분화어트리뷰션비용수익노출클릭전환
디바이스 수준 데이터 리포트API유저 수준✅✅✅

디바이스 수준 데이터 리포트는 유저 차원의 데이터를 가져올 수 있으며, 일정 기간 동안 유저의 총 노출, 클릭 및 수익 데이터가 포함됩니다. 따라서 AE 시스템은 각 유저의 일별 데이터, 즉 유저 한 명의 일별 광고 노출 수, 클릭 수 및 수익 현황을 개별적으로 수집합니다.

TopOn 데이터 연동을 시작하기 전에 AE 시스템의 유저 식별 규칙을 읽고, AE가 #distinct_id와 #account_id로 유저를 식별하는 방식을 이해했는지 확인하십시오

통합 절차​

  1. TopOn 클라이언트 SDK와 AE SDK를 연동하고, TopOn SDK에 AE의 유저 식별 ID를 설정합니다
  2. TopOn 백엔드에 로그인하여 Publisher Key와 APP ID를 가져옵니다
  3. AE 백엔드에 로그인하여 서드파티 통합 모듈로 이동한 후 TopOn 통합을 추가하고 통합 계획을 생성합니다
  4. AE 시스템이 데이터를 정상적으로 수신했는지 확인하고 리포트를 구축합니다

1. 클라이언트 SDK 설정​

TopOn 데이터 통합의 첫 단계는 클라이언트에서 AE SDK와 TopOn SDK를 연결하여 TopOn SDK에 AE 시스템의 유저 식별 ID를 설정하는 것입니다

1.1 방안 1(자동 통합)​

  • Android, iOS SDK를 연동한 경우

  • Unity SDK 버전 2.4.0 이상, Unreal SDK 버전 1.5.0 이상을 연동한 경우 이 방안을 바로 사용할 수 있습니다

팁

AE SDK 초기화와 자동 통합 활성화 코드는 반드시 TopOn SDK 초기화 전에 완료해야 합니다. 다음 단계에 따라 진행하십시오:

1. AE SDK를 초기화합니다.

2. `enableThirdPartySharing`을 호출하여 게스트 ID를 자동으로 설정합니다.

3. TopOn SDK를 초기화합니다.

// 1. Android SDK 초기화
TDConfig config = TDConfig.getInstance(this, APPID, TE_SERVER_URL);
TDAnalytics.init(config);
// 2. enableThirdPartySharing 인터페이스를 호출하여 ta_distinct_id를 TopOn 이벤트에 설정
TDAnalytics.enableThirdPartySharing(TDThirdPartyType.TOP_ON);
// 3. TopOn SDK 초기화
//  ...
노트

게스트 ID를 변경한 후에는 enableThirdPartySharing()을 다시 호출하여 데이터를 동기화해야 합니다.

이 방안의 원리는 내부에서 ATSDK의 initCustomMap 메서드를 자동으로 호출하여 ATCustomRuleKeys.USER_ID를 전달하며, 그 값으로 TA 프로젝트의 게스트 ID를 전달하는 것입니다.

1.2 방안 2(수동 통합)​

TopOn의 App 전역 커스텀 규칙 설정을 통해 AE의 distinct_id를 TopOn SDK의 custom_rule 내 user_id에 전달합니다. 호출 방법과 코드 예시는 이 문서를 참고하십시오.

팁

AE SDK 초기화와 initCustomMap 인터페이스 호출은 반드시 TopOn SDK 초기화 전에 완료해야 합니다. 다음 단계에 따라 진행하십시오:

1. AE SDK를 초기화합니다.

2. `initCustomMap`을 호출하여 게스트 ID를 설정합니다.

3. TopOn SDK를 초기화합니다.

다음은 각 플랫폼 SDK의 수동 통합 코드 예시입니다:

// 1. Android SDK 초기화
TDConfig config = TDConfig.getInstance(this, APPID, TE_SERVER_URL);
TDAnalytics.init(config);
// 2. AE의 게스트 ID 가져오기(AE의 #distinct_id에 해당)
String distinctId = TDAnalytics.getDistinctId();
// 3. 게스트 ID를 TopOn 수집 이벤트에 설정
Map<String, String> customMap = new HashMap<>(); 
customMap.put(ATCustomRuleKeys.USER_ID,distinctId); 
ATSDK.initCustomMap(customMap);
// 4. TopOn SDK 초기화
//  ...

2. TopOn 백엔드 정보 가져오기​

SDK 설정을 마친 후 TopOn 백엔드에 로그인하여 데이터 수집에 필요한 인증 정보를 가져와야 합니다.

인증 정보를 가져오려면 먼저 TopOn 담당자에게 디바이스 수준 데이터 리포트 API 권한 개통을 신청해야 합니다. 개통되면 개발자 백엔드의 계정 관리 페이지에서 Publisher Key를 가져올 수 있습니다.

다음으로 TopOn 백엔드의 앱 페이지로 이동하여 데이터를 연동할 앱의 앱 ID를 가져옵니다

3. 계획 설정​

SDK 설정을 완료하고 Publisher Key와 App ID를 가져온 후 AE 시스템에 로그인하여 서드파티 통합 모듈에서 새 계획을 설정할 수 있습니다. 다음은 TopOn 디바이스 수준 데이터 리포트의 설정 화면입니다. 이 장의 내용에 따라 계획을 생성하십시오:

3.1 인증 정보 설정​

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

참고:

  • APP ID: 방금 가져온 앱 ID

  • Publisher Key: 방금 가져온 Publisher Key

  • Brand: 기존 TopOn은 산하 비즈니스를 분리했습니다(자세한 내용은 이 글 참고). 사용 중인 구체적인 비즈니스 브랜드를 입력해야 합니다

    • Taku를 사용하는 경우(공식 웹사이트 주소: takuad.com) taku를 입력합니다(입력하지 않아도 taku로 간주)
    • TopOn을 사용하는 경우(공식 웹사이트 주소: www.toponad.com) topon을 입력합니다

3.2 동기화​

동기화 모듈에서 AE 시스템이 TopOn 디바이스 수준 데이터 리포트를 정기적으로 수집하는 전략을 설정할 수 있으며, 매일 특정 시각 또는 매시간 일정 기간의 데이터를 수집하도록 선택할 수 있습니다. 수집한 데이터도 데이터양에 포함되므로 너무 긴 기간의 데이터를 정기적으로 수집하지 않는 것을 권장합니다

3.3 데이터 수집 시간대​

수집할 데이터의 시간대도 설정할 수 있으며, 기본값은 UTC+8입니다

3.4 유저 식별 필드​

TopOn 디바이스 수준 데이터 리포트는 유저 수준 데이터이므로 유저 식별 규칙, 즉 TopOn SDK에 설정한 AE 시스템의 유저 식별 ID를 설정해야 합니다. AE 시스템은 이 설정에 따라 콜백 데이터를 변환할 때 해당 필드를 데이터의 유저 식별 필드로 설정합니다.

이 문서의 이전 단계에 따라 클라이언트 SDK를 설정한 경우 다음 설정을 사용하십시오:

  • 계정 ID 연관 필드: 없음
  • 게스트 ID 연관 필드: user_id

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

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

3.6 유저 속성 저장 규칙​

기본적으로 AE 시스템은 TopOn 디바이스 수준 데이터 리포트의 데이터를 유저 속성에 기록하지 않습니다. 일부 필드를 유저 테이블에 기록하려면 먼저 규칙을 켜서 실행한 다음, 속성 매핑 기능으로 유저 테이블에 기록할 필드를 추가하십시오. 소스 속성명에는 필드의 저장 후 이름을 입력해야 합니다:

3.7 통합 설정​

통합 설정 모듈에서 데이터 수집의 세부 설정을 제어할 수 있습니다. 예를 들어 저장 후 이벤트 이름 등이 있습니다

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

모듈이름의미
sink_eventevent_name저장 후 이벤트 이름, 커스텀 가능
transferdouble_columns지표 필드. 수정하지 마십시오

3.8 이벤트 저장 규칙​

  • AE 시스템은 매일 0시를 이벤트의 #event_time으로 사용합니다
  • 기본 이벤트 이름은 -- ta_ad_revenue_topon입니다
  • 기타 필드는 모두 저장되며, 다음은 저장되는 모든 이벤트 속성입니다
필드비고
placement_id광고 위치 ID
placement_name광고 위치 이름
placement_format

광고 유형:

0: native; 1: rewarded_video; 2: banner; 3: interstitial;

4: splash

android_id디바이스 ID, androidid
gaidGoogle의 광고 디바이스 ID
idfaiOS의 디바이스 ID
area국가
impression노출 수
click클릭 수
revenue수익. 서드파티 광고 플랫폼의 수익을 디바이스 수준으로 분할한 값이며, 통화 단위는 개발자 백엔드 설정과 동일

ecpm

TopOn이 수익 API를 기반으로 디바이스 노출별로 분할한 수익과 TopOn이 집계한 디바이스 노출로 계산한 eCPM. 계산 공식: (디바이스 수익/TopOn이 집계한 디바이스 노출) * 1000. 참고: eCPM은 2일 지연되어 제공
is_abtest

대조군 또는 테스트군:

0: 대조군 또는 A/B 테스트 미사용; 1: 테스트군

traffic_group_id대조군 또는 테스트군 id
segment_id트래픽 그룹 ID
segment_name트래픽 그룹 이름
idfviOS의 디바이스 ID
oaidAndroid의 디바이스 ID
user_id개발자의 커스텀 유저 ID
network_firm_id광고 플랫폼 ID
network_firm광고 플랫폼 이름
currency개발자 계정 통화. USD는 미국 달러, CNY는 위안화
os_versioniOS 디바이스의 운영 체제 버전
att_status

iOS 디바이스의 ATT 권한 부여 상태:

0: Not determined(권한 부여 여부 미결정); 1: Restricted (제한됨); 2: Denied(거부됨); 3: Authorize(권한 부여됨)

imeiAndroid 디바이스 식별 코드
device_type

IOS 디바이스 유형, 열거값 설명:

0: IOS가 아닌 디바이스; 1: iphone; 2: ipad

brand디바이스 브랜드 이름
model디바이스 모델
app_vn앱 버전 이름
app_vc앱 버전 번호
new_user_type

신규 유저 유형, 열거값 설명:

1: 신규 유저임; 2: 신규 유저 아님

channel채널. 개발자가 TopOn SDK를 통해 전달한 채널
estimate_revenue예상 수익. 입찰 광고 소스는 실시간 광고 노출 가격을 합산하여 예상 수익을 산출하고, 비입찰 광고 소스는 수동으로 입력한 eCPM 가격 * TopOn이 집계한 노출을 합산하여 예상 수익을 산출

3.9 표준화 필드​

TopOn 디바이스 수준 데이터 리포트의 일부 필드는 AE 시스템에서 표준화 처리됩니다

원본 필드표준화 필드의미
network_firmte_ads_object.media_source수익화 채널
placement_namete_ads_object.placement광고 위치
areate_ads_object.country국가/지역 코드
currencyte_ads_object.currency비용 또는 수익의 통화
impressionte_ads_object.impressions노출 수
clickte_ads_object.clicks클릭 수
revenuete_ads_object.revenue수익화 수익
이 문서가 도움이 되었나요?
이 페이지의 내용