TradPlus 종합 리포트 조회 API
서드파티 데이터 통합으로 생성된 데이터는 클러스터의 소비 데이터양에 포함됩니다
개요
인터페이스 소개
| 인터페이스명 | 타입 | 세분화 | 어트리뷰션 | 비용 | 수익 | 노출 | 클릭 | 전환 |
|---|---|---|---|---|---|---|---|---|
| 종합 리포트 조회 API | API | 집계 지표 | ✅ | ✅ | ✅ |
종합 리포트 조회 API는 광고 수익화의 집계 지표 데이터를 제공하며, 광고 노출 횟수, 클릭 수, 수익 등의 지표가 포함됩니다.
통합 절차
- TradPlus 백엔드에 로그인하여 Access Token과 앱 ID를 가져옵니다
- AE 백엔드에 로그인하여 서드파티 통합 모듈로 이동한 후 TradPlus 종합 리포트 조회 API 통합 계획을 추가합니다
- AE 시스템이 데이터를 정상적으로 수신했는지 확인하고 리포트를 구축합니다
1. TradPlus 백엔드 정보 가져오기
먼저 TradPlus 백엔드에 로그인하여 Access Token과 앱 ID를 가져와야 합니다
- Access token은 TradPlus 백엔드의 My Account - Report API Key에서 키 생성 버튼을 클릭하여 가져올 수 있습니다
- 앱 ID는 App Management의 앱 및 광고 위치 화면에서 확인할 수 있습니다
2. 계획 설정
Access Token과 앱 ID를 가져온 후 AE 시스템에 로그인하여 서드파티 통합 모듈에서 새 계획을 설정할 수 있습니다. 다음은 TradPlus 종합 리포트 조회 API의 설정 화면입니다. 이 장의 내용에 따라 계획을 생성하십시오:
2.1 인증 정보 설정
인증 정보 아래의 인증 정보 설정 버튼을 클릭하고, 팝업 창에 인증 작업에서 가져온 정보를 입력합니다
2.2 동기화
동기화 모듈에서 AE 시스템이 TradPlus 종합 리포트 조회 API 데이터를 정기적으로 수집하는 전략을 설정할 수 있으며, 매일 특정 시각 또는 매시간 일정 기간의 데이터를 수집하도록 선택할 수 있습니다. 수집한 데이터도 데이터양에 포함되므로 너무 긴 기간의 데이터를 정기적으로 수집하지 않는 것을 권장합니다
2.3 데이터 수집 시간대
수집할 데이터의 시간대도 설정할 수 있으며, 기본값은 UTC+8입니다
2.4 이벤트 테이블 저장 설정
이벤트 테이블 저장 설정 스위치를 켜면 콜백 데이터가 모두 이벤트 테이블에 기록됩니다. 이벤트 데이터 저장을 활성화할 것을 권장합니다.
2.5 통합 설정
통합 설정 모듈에서 데이터 수집의 세부 설정을 제어할 수 있습니다. 여기에는 수집할 지표 필드와 차원, 저장 후 이벤트 이름 등이 포함됩니다.
통합 설정의 내용은 JSON이며, 다음 내용에 따라 커스텀 설정할 수 있습니다:
| 모듈 | 이름 | 의미 |
|---|---|---|
| sink_event | event_name | 저장 후 이벤트 이름, 커스텀 가능 |
| source | metrics | 데이터의 지표, 리스트 타입. 계층마다 지원하는 metrics가 다르므로 입력 시 주의 필요 |
| group_by | 데이터의 그룹 차원, 리스트 타입. 계층마다 지원하는 group_by가 다르므로 입력 시 주의 필요 |
- 그룹 차원
아래 표는 종합 리포트 조회 API가 지원하는 모든 그룹 차원입니다. 일부 차원을 추가하면 일부 지표 필드를 조회하지 못할 수 있습니다. 조정하려면 그룹 항목을 source.group_by에 추가하십시오:
| 그룹 항목 | 필드 | 기본값 | 비고 |
|---|---|---|---|
| date | date | 예 | 날짜, 형식: YYYY-mm-dd |
| appId | app_id | 예 | 앱 ID (TradPlus) |
| platform | 예 | 앱의 시스템 플랫폼 (1 Android, 2 iOS) | |
| package_name | 예 | 패키지 이름 | |
| placementId | placement_id | 예 | 광고 위치 ID (TradPlus) |
| placement_name | 예 | 광고 위치 이름 (TradPlus) | |
| adFormat | ad_format | 예 | 광고 위치 유형 |
| ad_format_name | 예 | 광고 위치 유형 이름 | |
| area | area | 예 | 국가/지역 코드(ISO 3166-1 2자리 국가/지역 코드) |
| network | network | 예 | 광고 네트워크 ID |
| network_name | 예 | 광고 네트워크 이름 | |
| networkPlacementId | network_placement_id | 예 | 광고 네트워크의 광고 위치 ID 정보 |
| network_placement_name | 예 | 광고 네트워크의 광고 소스 이름 (TradPlus) | |
| network_placement_info | 예 | 광고 네트워크의 광고 위치 상세 정보 | |
| adSceneId | ad_scene_id | 광고 시나리오 ID | |
| ad_scene_name | 광고 시나리오 이름 | ||
| sdk | sdk | SDK 버전 | |
| channel | channel | 채널 | |
| appVersion | app_version | 앱 버전 | |
| idfa | idfa | IDFA 권한 부여 | |
| bucketId | bucket_id | A/B 테스트 그룹 |
- 지표 필드
기본적으로 일부 필드를 저장합니다. 조정이 필요하면 지표 필드 이름을 source.metrics에 입력하십시오:
| 지표 필드 | 저장명 | 기본값 | 비고 |
|---|---|---|---|
| dau | dau | 예 | TradPlus가 집계한 일간 활성 유저 수(app 수준) |
| deu | deu | 예 | TradPlus가 집계한 일별 광고 시청 유저 수 |
| arpu | arpu | 예 | TradPlus가 집계한 유저당 평균 수익 |
| newUsers | new_users | 예 | TradPlus가 집계한 신규 유저(app 수준) |
| newUserRate | new_user_rate | 예 | TradPlus가 집계한 신규 유저 비율(app 수준) |
| bidRequestApi | bid_request_api | 서드파티 광고 네트워크의 입찰 요청 수 | |
| bidResponseApi | bid_response_api | 서드파티 광고 네트워크의 입찰 응답 수 | |
| bidResponseRateApi | bid_response_rate_api | 서드파티 광고 네트워크의 입찰 응답률 | |
| bidWinRateApi | bid_win_rate_api | 서드파티 광고 네트워크의 입찰 낙찰률 | |
| requestApi | request_api | 예 | 서드파티 광고 네트워크의 요청 수 |
| fillApi | fill_api | 예 | 서드파티 광고 네트워크의 채움 수 |
| fillrateApi | fillrate_api | 예 | 서드파티 광고 네트워크의 채움률 |
| impressionApi | impression_api | 예 | 서드파티 광고 네트워크의 노출 수 |
| clickApi | click_api | 예 | 서드파티 광고 네트워크의 클릭 수 |
| ctrApi | ctr_api | 예 | 서드파티 광고 네트워크의 클릭률 |
| ecpmApi | ecpm_api | 예 | 서드파티 광고 네트워크의 ECPM |
| revenue | revenue | 예 | 서드파티 광고 네트워크의 수익 |
| appRequest | app_request | TradPlus가 집계한 앱 요청 수 | |
| enterAdScene | enter_ad_scene | TradPlus가 집계한 광고 시나리오 진입 횟수 | |
| enterAdSceneUsers | enter_ad_scene_users | TradPlus가 집계한 광고 시나리오 진입 유저 수 | |
| bidRequest | bid_request | TradPlus가 집계한 입찰 요청 수 | |
| bidResponse | bid_response | TradPlus가 집계한 입찰 응답 수 | |
| bidResponseRate | bid_response_rate | TradPlus가 집계한 입찰 응답률 | |
| bidWinRate | bid_win_rate | TradPlus가 집계한 입찰 낙찰률 | |
| request | request | 예 | TradPlus가 집계한 요청 수 |
| fill | fill | 예 | TradPlus가 집계한 채움 수 |
| fillrate | fillrate | 예 | TradPlus가 집계한 채움률 |
| impression | impression | 예 | TradPlus가 집계한 노출 횟수 |
| impressionRatio | impression_ratio | 예 | TradPlus가 집계한 노출 비율 |
| click | click | 예 | TradPlus가 집계한 클릭 횟수 |
| clickUsers | click_users | 예 | TradPlus가 집계한 클릭 유저 수 |
| ctr | ctr | 예 | TradPlus가 집계한 클릭률 |
| estimateRevenue | estimate_revenue | 예 | TradPlus가 집계한 예상 수익 |
| eventRevenue | event_revenue | 예 | TradPlus가 집계한 이벤트 트래킹 수익 |
2.6 데이터 저장 규칙
기본적으로 수집한 데이터는 이벤트 형태로 AE 프로젝트에 기록됩니다:
- 데이터의 date 필드, 즉 데이터의 날짜를 이벤트의 #event_time으로 사용합니다
- 데이터 이벤트 이름은 -- tradplus_allreport입니다
- 나머지 필드는 모두 저장됩니다
2.7 표준화 필드
TradPlus 디바이스 수준 데이터 리포트의 일부 필드는 AE 시스템에서 표준화 처리됩니다
| 원본 필드 | 표준화 필드 | 의미 |
|---|---|---|
| network_name | te_ads_object.media_source | 수익화 채널 |
| package_name | te_ads_object.app_id | 앱 ID |
| platform | te_ads_object.platform | 플랫폼(Android, iOS 등) |
| package_name | te_ads_object.placement | 광고 위치 |
| area | te_ads_object.country | 국가/지역 코드 |
| impression | te_ads_object.impressions | 노출 수 |
| click | te_ads_object.clicks | 클릭 수 |
| revenue | te_ads_object.revenue | 수익화 수익 |