Tenjin Reporting Metrics API
서드파티 데이터 통합으로 생성된 데이터는 클러스터의 소비 데이터양에 포함됩니다
개요
인터페이스 소개
| 인터페이스명 | 타입 | 세분화 | 어트리뷰션 | 비용 | 수익 | 노출 | 클릭 | 전환 |
|---|---|---|---|---|---|---|---|---|
| Reporting Metrics API | API | 집계 지표 | ✅ | ✅ | ✅ | ✅ | ✅ |
Tenjin은 집계 지표 데이터를 수집하는 인터페이스인 Reporting Metrics API도 제공하며, 다음 데이터를 가져올 수 있습니다:
- 비용 데이터: 광고주 데이터로 볼 수 있으며, 비용, 클릭, 노출, 총수익 등의 데이터를 포함합니다
- 수익 데이터: 퍼블리셔 데이터로 볼 수 있으며, 수익화 광고의 노출, 클릭 및 보다 세분화된 수익 데이터를 포함합니다
통합 절차
- Tenjin 백엔드에 로그인하여 Access Token을 가져옵니다
- AE 백엔드에 로그인하여 서드파티 통합 모듈로 이동한 후 Tenjin Reporting Metrics API를 추가하고 관련 설정을 완료합니다
- AE 시스템이 데이터를 정상적으로 수신했는지 확인하고 리포트를 구축합니다
1. Access Token 가져오기
Tenjin 데이터 연동의 첫 단계로, Tenjin 백엔드에 로그인하여 내비게이션 바에서 AUTOMATE -> API Access Tokens를 차례로 클릭합니다.
아래 그림과 같은 페이지에서 Access token 키를 생성하면 됩니다. Token을 생성할 때 이름을 지정할 수 있으며, 해당 Token의 용도를 이름으로 설명해 두면 좋습니다. 이름은 나중에 수정할 수 있으며 사용에는 영향을 주지 않습니다.
Access token 키를 생성한 후에는 이 화면에서 언제든지 키를 복사할 수 있습니다. 액세스 취소도 이 화면에서 수행합니다. 이 Token을 복사하십시오.
2. 계획 설정
Tenjin의 Access Token을 가져온 후 AE 시스템에 로그인하여 서드파티 통합 모듈에서 새 계획을 설정할 수 있습니다. 다음은 Tenjin Reporting Metrics API의 설정 화면입니다. 이 장의 내용에 따라 계획을 생성하십시오
2.1 인증 정보 설정
인증 정보 아래의 인증 정보 설정 버튼을 클릭하고, 팝업 창에 이전 단계에서 가져온 Access Token을 입력합니다:
2.2 동기화
동기화 모듈에서 AE 시스템이 Tenjin Reporting Metrics API 데이터를 정기적으로 수집하는 전략을 설정할 수 있으며, 매일 특정 시각에 일정 기간의 데이터를 수집하도록 선택할 수 있습니다. 수집한 데이터도 데이터양에 포함되므로 너무 긴 기간의 데이터를 정기적으로 수집하지 않는 것을 권장합니다
2.3 저장 설정
데이터를 이벤트 형태로 기록할지 제어할 수 있습니다. 끄면 데이터가 이벤트 테이블에 기록되지 않으므로 이 설정을 끄지 마십시오.
2.4 통합 설정
마지막으로 통합 설정 모듈에서 데이터 수집의 세부 설정을 제어할 수 있습니다. 데이터의 시간 집계 단위, 수집할 지표 필드와 차원, 저장 후 이벤트 이름 등이 포함됩니다.
통합 설정의 내용은 JSON이며, 다음 내용에 따라 커스텀 설정할 수 있습니다:
| 모듈 | 이름 | 의미 |
|---|---|---|
| sink_event | event_mapping | 저장 후의 이벤트 이름, 커스텀 가능, JSON 타입. Key는 리포트 타입에 대응하고 Value는 해당 리포트 타입의 저장 이벤트 이름 |
| source | report_types | 수집할 리포트 타입. Tenjin Reporting Metrics API는 두 가지 리포트 타입을 지원합니다. 리스트 타입이며, 요소를 하나만 입력하여 한 번에 한 리포트의 데이터만 수집할 것을 권장 선택 가능한 값: spend, ad_revenue. 자세한 내용은 아래 내용을 참고하십시오 |
| metrics | 데이터의 지표, 리스트 타입. 리포트 타입마다 지원하는 metrics가 다르므로 입력 시 주의 필요 | |
| group_by | 데이터의 그룹 차원, 리스트 타입. 리포트 타입마다 지원하는 group_by가 다르므로 입력 시 주의 필요 |
리포트 타입마다 데이터 설정이 크게 다르므로 각 계층의 구성 템플릿을 그대로 사용하거나 템플릿을 약간 조정하여 사용하는 것을 권장합니다
2.4.1 Spend 템플릿
Spend 템플릿은 API의 비용 데이터, 즉 광고주 데이터 수집에 대응합니다. 다음은 이 인터페이스의 템플릿으로, 전체를 그대로 통합 설정에 복사할 수 있습니다. 조정이 필요하면 이 절의 내용을 참고하십시오:
{
"sink_event": {
"event_mapping": {
"spend": "tenjin_spend_data",
"ad_revenue": "tenjin_ad_revenue_data"
}
},
"source": {
"group_by": [
"campaign",
"country"
],
"report_types": [
"spend"
],
"metrics": [
"spend",
"cpc",
"cpi",
"tcpi",
"cpm",
"total_rev",
"revenues",
"pub_rev",
"clicks",
"tracked_clicks",
"impressions",
"installs",
"tracked_installs",
"ctr",
"cvr",
"users"
]
}
}
- 분석 차원
비용 데이터는 다음 분석 차원을 제공합니다. 기본적으로 campaign, country를 분석 차원으로 사용하며, 필요에 따라 다른 분석 차원을 선택할 수도 있습니다. 조정하려면 분석 차원을 source.group_by에 입력하십시오:
| 분석 차원 | 포함되는 차원 필드 | 기본 여부 |
|---|---|---|
| app | app_id, bundle_id | |
| channel | ad_network_name, ad_network_id, ad_network_icon_url | |
| country | country | |
| platform | platform | |
| site | site_id | |
| campaign | campaign_name, campaign_id, ad_network_name, ad_network_id, ad_network_icon_url, app_id, app_name, bundle_id, store_id, app_icon_url, channel, platform | |
campaign, country | campaign_name, campaign_id, ad_network_name, ad_network_id, ad_network_icon_url, app_id, app_name, bundle_id, store_id, app_icon_url, channel, platform, country | 예 |
| channel, app | ad_network_name, ad_network_id, ad_network_icon_url, app_id, bundle_id | |
| channel, app, country | ad_network_name, ad_network_id, ad_network_icon_url, app_id, bundle_id, country |
- 포함 지표
일부 핵심 지표에는 보고 값과 추적 값이 있습니다. 기본적으로 보고 값을 사용하며, 추적 값으로 조정하려면 데이터의 논리적 일관성을 위해 이러한 지표를 모두 추적 값으로 조정하는 것을 권장합니다. 연동할 지표를 조정하려면 API 필드 이름을 source.metrics에 입력하십시오:
| API 필드 | 필드 이름 | 의미 | 기본 여부 |
|---|---|---|---|
| spend | 총지출 | 총지출 금액 ($) | 예 |
| cpc | CPC | 평균 CPC ($) | 예 |
| cpi | CPI | 보고된 설치당 비용($) | 예 |
| tcpi | 추적 설치의 CPI | 추적된 설치당 비용 ($) | 예 |
| cpm | CPM | 평균 CPM ($) | 예 |
cp_ksessions_Nd | N일 1,000 Sessions당 평균 비용 | N일 차 1000 Sessions의 평균 비용 ($) N의 범위: 0, 1, 2, 3, 4, 5, 6, 7, 14, 30, 60, 90, 120 | |
| cp_user_Nd | N일 잔존 유저당 비용 | N일 차 잔존 유저의 평균 비용 ($) N의 범위: 0, 1, 2, 3, 4, 5, 6, 7, 14, 30, 60, 90, 120 | |
| roas_Nd | N일 ROAS | N일 차 ROAS (%) N의 범위: 0, 1, 2, 3, 4, 5, 6, 7, 14, 30, 60, 90, 120 | |
| roi_Nd | N일 ROI | N일 차 ROI (%) N의 범위: 0, 1, 2, 3, 4, 5, 6, 7, 14, 30, 60, 90, 120 | |
| total_rev | 총수익 | 총수익 금액 ($) | 예 |
| total_arpu | 총 ARPU 값 | 인앱 구매와 광고를 포함한 ARPU 값 ($) | |
| total_rev_Nd | N일 LTV | N일 차 LTV ($) N의 범위: 0, 1, 2, 3, 4, 5, 6, 7, 14, 30, 60, 90, 120 | |
| rpu_Nd | N일 총수익 LTV / 유저 수 | N일 차 LTV를 DAU로 나눈 값 ($) N의 범위: 0, 1, 2, 3, 4, 5, 6, 7, 14, 30, 60, 90, 120 | |
| revenues | 인앱 구매 수익 | 인앱 구매 수익 ($) | 예 |
| iap_arpu | 인앱 구매 ARPU 값 | 인앱 구매만 포함한 ARPU 값($) | |
| revenues_Nd | N일 인앱 구매 수익 LTV | N일 차 인앱 구매 수익의 LTV ($) N의 범위: 0, 1, 2, 3, 4, 5, 6, 7, 14, 30, 60, 90, 120 | |
| iap_rpu_Nd | N일 인앱 구매 수익 LTV / User | N일 차 IAP만 계산한 LTV 값을 DAU로 나눈 값 ($) N의 범위: 0, 1, 2, 3, 4, 5, 6, 7, 14, 30, 60, 90, 120 | |
| pub_rev | 광고 수익 | 광고 총수익 ($) | 예 |
| pub_arpu | 광고 수익 ARPU 값 | 광고 수익만 포함한 ARPU 값 ($) | |
| pubrev_Nd | N일 광고 수익 LTV | N일 차 광고 수익의 LTV ($) N의 범위: 0, 1, 2, 3, 4, 5, 6, 7, 14, 30, 60, 90, 120 | |
| pub_rpu_Nd | N일 광고 수익 LTV / 유저 수 | N일 차 광고 수익의 LTV를 DAU로 나눈 값 ($) N의 범위: 0, 1, 2, 3, 4, 5, 6, 7, 14, 30, 60, 90, 120 | |
| fraud_purchases | 허위 구매 수 | 허위 구매 횟수 | |
| fraud_revenue | 허위 수익 | 차단된 허위 구매의 수익 ($) | |
| clicks | 보고 클릭 수 | 보고된 총 클릭 수 | 예 |
| clicks_difference | 클릭 차이 수 | 보고 클릭과 추적 클릭의 차이 | |
| clicks_difference_pct | 클릭 차이 비율 | 보고 클릭과 추적 클릭의 차이 비율 (%) | |
| tracked_clicks | 추적 클릭 수 | 추적된 클릭 수 | 예 |
| blocked_clicks | 차단된 클릭 수 | 차단된 클릭 횟수 | |
| impressions | 보고 노출 수 | 보고된 노출 수 | 예 |
| tracked_impressions | 추적 노출 수 | 추적된 노출 수 | |
| installs | 보고 설치 수 | 보고된 설치 수 | 예 |
| installs_difference | 설치 수 차이 | 보고 설치와 추적 설치의 차이 | |
| installs_difference_pct | 설치 차이 비율 | 보고 설치와 추적 설치의 차이 비율(%) | |
| tracked_installs | 추적 설치 수 | 추적된 설치 수 | 예 |
| ctr | CTR | 평균 CTR (%) | 예 |
| cvr | CVR | 평균 CVR (%) | 예 |
| all_fraud | 허위 이벤트 수 | 허위 이벤트 총수 | |
| blocked_device_events | 차단된 디바이스 이벤트 수 | 차단된 디바이스 이벤트 수 | |
| cpr | Completion Rate (CPR) | 평균 CPR Percentage (%) | |
| sessions | Session 수 | 평균 Sessions 수 | |
| sessions_Nd | N일 Session 수 | N일 차 Sessions 수 N의 범위: 0, 1, 2, 3, 4, 5, 6, 7, 14, 30, 60, 90, 120 | |
| users | DAU | 평균 DAU | 예 |
| retention_Nd | N일 잔존율 | N일 차 잔존율(%) N의 범위: 0, 1, 2, 3, 4, 5, 6, 7, 14, 30, 60, 90, 120 | |
| users_Nd | N일 잔존 유저 수 | N일 차 잔존 유저 수 N의 범위: 0, 1, 2, 3, 4, 5, 6, 7, 14, 30, 60, 90, 120 | |
| tracked_cvr | 추적 전환율 | 추적된 전환율 (%) |
- 저장 규칙
데이터의 day 필드, 즉 데이터의 날짜를 집계 데이터의 #event_time으로 설정합니다
템플릿에서 사용하는 이벤트 이름은 -- tenjin_spend_data입니다
2.4.2 Ad Revenue 템플릿
Ad Revenue 템플릿은 API의 수익 데이터, 즉 퍼블리셔 데이터 수집에 대응합니다. 다음은 이 인터페이스의 템플릿으로, 전체를 그대로 통합 설정에 복사할 수 있습니다. 조정이 필요하면 이 절의 내용을 참고하십시오:
{
"sink_event": {
"event_mapping": {
"spend": "tenjin_spend_data",
"ad_revenue": "tenjin_ad_revenue_data"
}
},
"source": {
"group_by": [
"channel",
"app",
"country"
],
"report_types": [
"ad_revenue"
],
"metrics": [
"ad_revenue",
"clicks",
"ecpc",
"ecpm",
"impressions"
]
}
}
- 분석 차원
수익 데이터는 다음 분석 차원을 제공합니다. 기본적으로 channel, app, country를 분석 차원으로 사용하며, 필요에 따라 다른 분석 차원을 선택할 수도 있습니다. 조정하려면 분석 차원을 source.group_by에 입력하십시오:
| 분석 차원 | 기본 여부 |
|---|---|
| app | |
| channel | |
| country | |
| channel, app | |
| channel, app, country | 예 |
| ad_placement |
- 포함 지표
일부 핵심 지표에는 보고 값과 추적 값이 있습니다. 기본적으로 보고 값을 사용하며, 추적 값으로 조정하려면 데이터의 논리적 일관성을 위해 이러한 지표를 모두 추적 값으로 조정하는 것을 권장합니다. 연동할 지표를 조정하려면 API 필드 이름을 source.metrics에 입력하십시오:
| API 필드 | 기본 여부 | 의미 |
|---|---|---|
| ad_revenue | 예 | 총수익 |
| clicks | 예 | 총 클릭 수 |
| ecpc | 예 | eCPC(클릭당 수익) |
| ecpm | 예 | eCPM(1,000회 노출당 수익) |
| impressions | 예 | 총 노출 수 |
- 저장 규칙
데이터의 day 필드, 즉 데이터의 날짜를 집계 데이터의 #event_time으로 설정합니다
템플릿에서 사용하는 이벤트 이름은 -- tenjin_ad_revenue_data입니다
2.5 표준화 필드
데이터에 다음 이벤트 속성이 있으면 자동으로 표준화 처리합니다:
| 원본 필드 | 표준화 필드 | 의미 |
|---|---|---|
| campaign_name | te_ads_object.campaign_name | 캠페인 이름 |
| campaign_id | te_ads_object.campaign_id | 캠페인 ID |
| ad_network_name | te_ads_object.media_source | 미디어 채널 또는 수익화 채널 |
| store_id | te_ads_object.app_id | 앱 ID |
| app_name | te_ads_object.app_name | 앱 이름 |
| platform | te_ads_object.platform | 플랫폼(Android, iOS 등) |
| country | te_ads_object.country | 국가/지역 코드 |
| 【USD】 | te_ads_object.currency | 비용 또는 수익의 통화 |
| impressions | te_ads_object.impressions | 노출 수 |
| clicks | te_ads_object.clicks | 클릭 수 |
| installs | te_ads_object.installs | 전환 수(설치) |
| spend | te_ads_object.cost | UA 비용 |
| ad_revenue | te_ads_object.revenue | 수익화 수익 |