Adjust Report Service API
서드파티 데이터 통합으로 생성된 데이터는 클러스터의 소비 데이터양에 포함됩니다
개요
인터페이스 소개
| 인터페이스명 | 타입 | 세분화 | 어트리뷰션 | 비용 | 수익 | 노출 | 클릭 | 전환 |
|---|---|---|---|---|---|---|---|---|
| Report Service API | API | 집계 지표 | ✅ | ✅ | ✅ | ✅ | ✅ |
Adjust의 Report Service API는 집계된 지표 데이터를 제공하며, 비용, 수익, 노출, 클릭, 전환 등 다양한 데이터를 포함합니다.
통합 절차
Adjust Report Service API 데이터의 연동 절차는 다음과 같습니다:
- Adjust 백엔드에서 Adjust API 토큰과 앱 토큰을 가져옵니다
- AE 백엔드에 로그인하여 서드파티 통합 모듈로 이동한 후 Adjust Report Service API 통합 계획을 추가하고 관련 설정을 완료합니다
- AE 시스템이 데이터를 정상적으로 수신했는지 확인하고 리포트를 구축합니다
1. Adjust API 토큰과 앱 토큰 가져오기
1.1 Adjust API 토큰 가져오기
Report Service API에서 데이터를 가져오기 전에 먼저 Adjust API 토큰을 가져와야 합니다. 이 토큰은 Adjust Suite 백엔드의 Account settings - My profile에서 확인할 수 있습니다. 클래식 대시보드에서는 My account - Your data 탭에서 User details를 찾은 후 하단의 톱니바퀴 버튼을 클릭하여 확인할 수 있습니다.
아래 그림은 Adjust Suite 화면이며, 그림의 API Token이 API 토큰입니다:
1.2 앱 토큰 가져오기
다음으로 Adjust의 앱 토큰도 가져와야 합니다. 앱 토큰으로 수집할 데이터가 어느 Adjust 프로젝트에서 오는지 결정합니다.
Adjust 백엔드에서 앱을 찾아 앱 옵션의 캐럿 기호(^)를 클릭하면 왼쪽 프로젝트 카드에 앱 토큰(App Token)이 표시됩니다. 또한 프로젝트 카드에서 All Settings를 클릭한 후 View app details를 클릭해도 앱 토큰을 확인할 수 있습니다.
2. 계획 설정
Adjust의 API 토큰과 앱 토큰을 가져온 후 AE 시스템에 로그인하여 서드파티 통합 모듈에서 새 계획을 설정할 수 있습니다. 아래 그림은 Adjust Report Service API의 설정 화면입니다. 이 장의 내용에 따라 계획을 생성하십시오:
2.1 인증 정보 설정
인증 정보 아래의 인증 정보 설정 버튼을 클릭하고 팝업 창에 App ID(Adjust의 앱 ID)와 API Token을 입력합니다
2.2 동기화
동기화 모듈에서 AE 시스템이 Adjust Report Service API 데이터를 정기적으로 수집하는 정책을 설정할 수 있으며, 매일 특정 시각 또는 매시간 일정 기간의 데이터를 수집하도록 선택할 수 있습니다. 수집한 데이터도 데이터양에 포함되므로 너무 긴 기간의 데이터를 정기적으로 수집하지 않는 것을 권장합니다
2.3 데이터 수집 시간대
수집할 데이터의 시간대도 설정할 수 있으며, 기본값은 UTC+8입니다
2.4 저장 설정
데이터를 이벤트 형태로 기록할지 제어할 수 있습니다. 이벤트 데이터 저장을 활성화하는 것을 권장합니다.
2.5 통합 설정
마지막으로 통합 설정 모듈에서 데이터 수집의 세부 설정을 제어할 수 있습니다. 데이터의 시간 집계 단위, 수집할 지표 필드와 차원, 저장 후 이벤트 이름 등이 포함됩니다.
통합 설정의 내용은 JSON이며, 다음 내용에 따라 커스텀 설정할 수 있습니다:
| 모듈 | 이름 | 의미 |
|---|---|---|
| sink_event | event_name | 저장 후 이벤트 이름, 커스텀 가능 |
| source | metrics | 데이터의 지표, 리스트 타입, 커스텀 가능 |
| group_by | 데이터의 그룹 차원, 리스트 타입, 커스텀 가능 | |
| time_granularity | 데이터의 시간 집계 단위, 문자열 타입, 값은 2.5.2 그룹 차원의 시간 단위 참조, 템플릿 기본값은 day |
필요에 따라 통합 설정을 수정할 수 있습니다
2.5.1 포함 지표
포함 지표는 통합 설정의 source.metrics에 대응합니다. Report Service가 지원하는 지표는 매우 다양하므로 이 절에서는 자주 사용하는 일부 지표만 소개합니다. 자세한 지표 목록은 Adjust 공식 문서를 참고하십시오. 지표를 수정하려면 필요한 지표의 필드 이름을 source.metrics에 입력하면 됩니다.
- 전환 지표
| 필드 | 정의 | 수식 | 필드 이름 | 템플릿 기본 사용 |
|---|---|---|---|---|
| 평균 DAUs | 선택한 기간의 평균 일간 활성 유저 | (D0 DAU + D1 DAU + DAY N DAU) / 선택한 기간의 일수 | daus | 예 |
| 평균 MAUs | 선택한 기간의 평균 MAU | (M0 MAU + M1 MAU + MONTH N MAU) / 선택한 기간의 월수 | maus | 예 |
| 평균 WAUs | 선택한 기간의 평균 WAU | (W0 WAU + W1 WAU + WEEK N WAU) / 선택한 기간의 주수 | waus | 예 |
기본 Sessions 수 | 설치와 재어트리뷰션을 제외한 유저의 sessions 수 | - | base_sessions | 예 |
| 클릭 수 | 추적된 클릭 수 | - | clicks | 예 |
| 클릭 수 (채널) | 채널 API에서 보고한 클릭 수 | - | network_clicks | 예 |
| 클릭 전환율 (CCR) | 클릭 수 대비 설치 수의 비율 | 설치 수 / 클릭 수 | click_conversion_rate | 예 |
| 클릭률(CTR) | 노출 대비 클릭의 비율 | 클릭 수 / 노출 수 | ctr | 예 |
| 디어트리뷰션 | 디어트리뷰션이 발생한 횟수 | - | deattributions | 예 |
| GDPR 잊힐 권리를 행사한 유저 수 | EU GDPR의 잊힐 권리를 행사한 유저 수. Adjust는 이 유저들의 개인 데이터를 영구 삭제합니다 | - | gdpr_forgets | 예 |
| 노출 수 | 추적된 광고 노출 수 | - | impressions | 예 |
| 노출 수 (채널) | 채널 API에서 보고한 광고 노출 수 | - | network_impressions | 예 |
| 노출 대비 설치율 | 노출 수 대비 설치 수의 비율 | 설치 수 / 노출 수 | impression_conversion_rate | 예 |
| 설치 수 | 추적된, 앱을 설치한 유저 수 | - | installs | 예 |
| 설치 수 (채널) | 채널 API에서 보고한 설치 수 | - | network_installs | 예 |
| 설치 수 차이 | 설치 수와 채널 API에서 보고한 설치 수의 차이 | 설치 수 - 설치 수 (채널) | network_installs_diff | 예 |
| 노출 1000회당 설치 수 (IPM) | 광고 노출 1000회당 발생한 설치 수 | 1000 * 노출 대비 설치율 | installs_per_mile | 예 |
| 추적 제한 디바이스의 설치 수 | 추적 제한(LAT)을 켠 디바이스의 설치 수 | - | limit_ad_tracking_installs | 예 |
| 추적 제한 디바이스의 설치 비율 | 추적 제한 디바이스의 설치 수와 전체 설치 수의 비율 | 추적 제한 디바이스의 설치 수 / 설치 수 | limit_ad_tracking_install_rate | 예 |
| 추적 제한 디바이스의 재어트리뷰션 수 | 추적 제한(LAT)을 켠 디바이스의 재어트리뷰션 수 | - | limit_ad_tracking_reattributions | 예 |
| 추적 제한 디바이스의 재어트리뷰션 비율 | 추적 제한 디바이스의 재어트리뷰션 수와 전체 재어트리뷰션 수의 비율 | 추적 제한 디바이스의 재어트리뷰션 수 / 재어트리뷰션 수 | limit_ad_tracking_reattribution_rate | 예 |
| 비오가닉 설치 수 | 오가닉으로 어트리뷰션되지 않은 유저의 설치 수 | - | non_organic_installs | 예 |
| 오가닉 설치 수 | 오가닉으로 어트리뷰션된 유저의 설치 수 | - | organic_installs | 예 |
| 재어트리뷰션 수 | 재어트리뷰션된 유저 수 | - | reattributions | 예 |
| 재어트리뷰션 재설치 수 | 재어트리뷰션된 유저의 재설치 수 | - | reattribution_reinstalls | |
| 재설치 수 | 재설치 횟수 Uninstall and Reinstall Growth Solution 구매 필요 | - | reinstalls | |
| 총 Sessions 수 | 총 Sessions 수에는 설치와 재어트리뷰션이 포함됩니다 | base_sessions + installs + reattributions | sessions | 예 |
- 비용 지표
| 필드 | 정의 | 수식 | 필드 이름 | 템플릿 기본 사용 |
|---|---|---|---|---|
| 광고 지출 | 광고 총지출(수집 파라미터에 따라 결정) | 클릭 지출 + 노출 지출 + 설치 지출 | cost | 예 |
| 광고 지출(어트리뷰션) | Adjust가 추적한 광고 지출 | 클릭 지출 + 노출 지출 + 설치 지출 | adjust_cost | 예 |
광고 지출(채널) | 채널 API에서 보고한 광고 지출 | 클릭 지출 + 노출 지출 + 설치 지출 | network_cost | 예 |
| 광고 지출 차이 | 광고 지출(어트리뷰션)과 광고 지출(채널)의 차이 | 광고 지출(어트리뷰션) - 광고 지출(채널) | network_cost_diff | 예 |
| 클릭 비용 | 광고 클릭에 소요된 비용 지출 | - | click_cost | 예 |
| 유료 클릭 수 | 광고 지출이 발생한 광고 클릭 수 | - | paid_clicks | 예 |
| eCPI (전체 설치) | 전체 설치의 평균 유효 지출 | 광고 지출 / 설치 | ecpi_all | 예 |
| eCPI (채널) | 채널 API에서 보고한 설치의 평균 유효 지출 | 채널 API에서 보고한 광고 지출 / 채널 API에서 보고한 설치 수 | network_ecpi | 예 |
| eCPI (유료 설치) | 유료 설치의 평균 유효 지출 | 채널 API에서 보고한 광고 지출 / 유료 설치 수 | ecpi | 예 |
| eCPM (어트리뷰션) | 어트리뷰션 데이터에서 보고한 eCPM 데이터 | (광고 지출 / 유료 노출 수) * 1000 | ecpm | 예 |
| eCPM (채널) | 채널 API에서 보고한 eCPM 데이터 | (채널 지출 / 채널 유료 노출) * 1000 | network_ecpm | 예 |
| eCPC | 클릭당 평균 유효 지출 | 광고 지출 / 유료 클릭 수 | ecpc | 예 |
| 노출 비용 | 노출에 소요된 비용 지출 | - | impression_cost | 예 |
| 유료 노출 수 | 광고 지출이 발생한 유료 노출 수 | - | paid_impressions | 예 |
| 설치 비용 | 설치에 소요된 비용 지출 | - | install_cost | 예 |
| 유료 설치 수 | 광고 지출이 발생한 유료 설치 수 | - | paid_installs | 예 |
- 수익 지표
| 필드 | 정의 | 수식 | 필드 이름 | 템플릿 기본 사용 |
|---|---|---|---|---|
| 광고 노출 수 | 광고의 총 노출 수 | - | ad_impressions | 예 |
| 광고 수익 | 광고 총수익 | - | ad_revenue | 예 |
| 코호트 누적 광고 수익 | 선택한 기간에 설치한 유저의 현재까지 광고 수익 예: 선택 기간이 1/1부터 1/31까지이고 오늘이 5/1이면, 1/1부터 1/31까지 설치한 유저의 5/1까지 광고 수익을 계산합니다 | - | cohort_ad_revenue | 예 |
| 노출 1000회당 광고 수익 | 광고 노출 1000회당 평균 수익 | (광고 수익 / 광고 노출) * 1000 | ad_rpm | 예 |
| 인앱 구매 수익 | 인앱 구매 수익 | - | revenue | 예 |
| 코호트 누적 인앱 구매 수익 | 선택한 기간에 설치한 유저의 현재까지 인앱 구매 수익 예: 선택 기간이 1/1부터 1/31까지이고 오늘이 5/1이면, 1/1부터 1/31까지 설치한 유저의 5/1까지 인앱 구매 수익을 계산합니다 | - | cohort_revenue | 예 |
| 총수익 | 광고 수익과 인앱 구매 수익을 포함한 총수익 | 광고 수익 + 인앱 구매 수익 | all_revenue | 예 |
| 코호트 누적 총수익 | 선택한 기간에 설치한 유저의 현재까지 총수익 예: 선택 기간이 1/1부터 1/31까지이고 오늘이 5/1이면, 1/1부터 1/31까지 설치한 유저의 5/1까지 총수익을 계산합니다 | 코호트 누적 인앱 구매 수익 + 코호트 누적 광고 수익 | cohort_all_revenue | 예 |
| ARPU (전체) | 모든 수익을 포함한 활성 유저당 평균 수익 | 총수익 / 총 DAU | arpdau | 예 |
| ARPU(광고만) | 광고 수익만 포함한 활성 유저당 평균 수익 | 광고 수익 / 총 DAU | arpdau_ad | 예 |
| ARPU (인앱 구매만) | 인앱 구매 수익만 포함한 활성 유저당 평균 수익 | 인앱 구매 수익 / 총 DAU | arpdau_iap | 예 |
| 매출 총이익 | 총수익에서 총비용을 뺀 값 | 총수익 - 총비용 | gross_profit | 예 |
| 코호트 매출 총이익 | 선택한 기간에 설치한 유저의 매출 총이익 | 코호트의 총수익 - 비용 | cohort_gross_profit | 예 |
| 코호트 ROI | 선택한 기간에 설치한 유저의 매출 총이익을 비용으로 나눈 값 | 코호트의 매출 총이익 / 비용 | return_on_investment | 예 |
| 인앱 구매 수 | 추적된 인앱 구매 이벤트 수 | - | revenue_events | 예 |
| 수익 비용 비율 (RCR) | 선택한 기간에 설치한 유저의 수익과 비용의 비율 | 코호트의 총수익 / 총비용 | revenue_to_cost | 예 |
| ROAS (총수익) | 총수익으로 계산한 ROAS | (광고 수익 + 인앱 구매 수익) / 비용 | roas | 예 |
| ROAS (광고 수익) | 광고 수익만으로 계산한 ROAS | 광고 수익 / 비용 | roas_ad | 예 |
| ROAS (인앱 구매 수익) | 인앱 구매 수익만으로 계산한 ROAS | 인앱 구매 수익 / 비용 | roas_iap | 예 |
2.5.2 그룹 차원
다음은 Report Service가 지원하는 그룹 차원으로, 시간 단위(하나만 선택 가능, 통합 설정의 source.time_granularity에 대응, 템플릿 기본값은 day)와 그룹 차원(다중 선택 가능, 통합 설정의 source.group_by에 대응)이 포함됩니다. 차원을 수정하려면 필요한 차원의 필드 이름을 source.group_by에 입력하면 됩니다.
- 시간 단위
| 차원 | 데이터 타입 | 설명 | 예시 | 템플릿 기본 사용 |
|---|---|---|---|---|
hour | 날짜 | ISO 형식 날짜 값: YYYY-MM-DDTHH:MM:SS | 2021-05-11T17:00:45 | |
| day | 날짜 | 날짜 값 형식: YYYY-MM-DD | 2021-05-11 | 예 |
- 그룹 차원
| 차원 | 데이터 타입 | 설명 | 예시 | 템플릿 기본 사용 |
|---|---|---|---|---|
os_name | 문자열 | 운영 체제 | 값: android, Bada, blackberry, iOS, Linux, Mac OS, server, symbian, unknown, WebOS, Windows, windows-phone | 예 |
device_type | 문자열 | 디바이스 타입 | 값: bot, console, iPod, Mac, PC, phone, server, simulator, tablet, TV, unknown | 예 |
| app | 문자열 | 앱 이름 | - | 예 |
| app_token | 문자열 | Adjust의 앱 ID | - | 예 |
| store_id | 문자열 | 스토어 앱 ID | com.random.app | 예 |
| store_type | 문자열 | 앱을 설치한 출처 스토어 | google_play | 예 |
app_network | 문자열 | 앱 식별자 | 형식: <store_type>:<store_id> 예: google_play:com.random.app | 예 |
| currency | 문자열 | 통화 | Euro | 예 |
| currency_code | 문자열 | 3자리 ISO 4217 통화 코드 | EUR | 예 |
network | 문자열 | 광고 채널 이름 | 값: Organic, AppLovin, Facebook Installs, Instagram Installs | |
| campaign | 문자열 | 캠페인 이름과 ID 포함 | - | 예 |
| campaign_network | 문자열 | 채널의 캠페인 이름 | - | 예 |
| campaign_id_network | 문자열 | 채널의 캠페인 ID | - | 예 |
| adgroup | 문자열 | 광고 그룹 이름과 ID 포함 | - | 예 |
| adgroup_network | 문자열 | 채널의 광고 그룹 이름 | - | 예 |
| adgroup_id_network | 문자열 | 채널의 광고 그룹 ID | - | 예 |
| source_network | 문자열 | 채널에 따라 선택 가능한 값, 일반적으로 adgroup_network와 동일 | - | 예 |
| source_id_network | 문자열 | source_app 값 | - | 예 |
| creative | 문자열 | 소재 이름과 ID 포함 | - | 예 |
| creative_network | 문자열 | 채널 소재 이름 | - | 예 |
| creative_id_network | 문자열 | 채널 소재 ID | - | 예 |
| country | 문자열 | 국가/지역 이름 | United States of America | 예 |
| country_code | 문자열 | 2자리 ISO 3166 국가/지역 코드 | US | 예 |
| region | 문자열 | 비즈니스 지역 | APAC | 예 |
| partner_name | 문자열 | Adjust 시스템의 파트너 이름 | AppLovin | 예 |
| partner_id | 문자열 | Adjust 시스템의 파트너 ID | 34 | 예 |
2.5.3 저장 규칙
- 데이터의 day 또는 hour 필드, 즉 데이터의 날짜를 집계 데이터의 #event_time으로 설정합니다
- 템플릿에서 사용하는 이벤트 이름은 -- adjust_report_service_ad_spend이며, 수정하려면 sink_event.event_name을 조정하십시오
- 나머지 지표와 차원 필드는 모두 저장됩니다
2.6 표준화 필드
다음은 Report Service API의 표준화 필드입니다:
| 원본 필드 | 표준화 필드 | 의미 |
|---|---|---|
| campaign_network | te_ads_object.campaign_name | 캠페인 이름 |
| campaign_id_network | te_ads_object.campaign_id | 캠페인 ID |
| adgroup_network | te_ads_object.ad_group_name | 광고 그룹 이름, 수익화 광고의 Unit 이름 |
| adgroup_id_network | te_ads_object.ad_group_id | 광고 그룹 ID, 수익화 광고의 Unit ID |
| creative_network | te_ads_object.ad_name | 광고 이름 |
| creative_id_network | te_ads_object.ad_id | 광고 ID |
| partner_name | te_ads_object.media_source | 미디어 채널 또는 수익화 채널 |
| store_id | te_ads_object.app_id | 앱 ID |
| app | te_ads_object.app_name | 앱 이름 |
| os_name | te_ads_object.platform | 플랫폼(Android, iOS 등) |
| country_code | te_ads_object.country | 국가/지역 코드 |
| currency_code | te_ads_object.currency | 비용 또는 수익의 통화 |
| impressions | te_ads_object.impressions | 노출 수 |
| clicks | te_ads_object.clicks | 클릭 수 |
| installs | te_ads_object.installs | 전환 수(설치) |
| cost | te_ads_object.cost | UA 비용 |
| revenue | te_ads_object.revenue | 수익화 수익 |
3. 후속 사용
3.1 데이터 저장 확인
데이터 관리 페이지에서 이벤트 adjust_report_service_ad_spend가 저장되었는지 확인할 수 있습니다
3.2 단일 수집
과거 데이터나 수집에 실패한 데이터를 보완하는 등 이전 일정 기간의 데이터를 연동하려면, 계획을 저장한 후 계획 페이지에 다시 들어가 오른쪽 상단의 단일 수집 버튼을 클릭하여 지정한 기간의 데이터를 한 번 수집할 수 있습니다. 수집하는 데이터의 기간이 이전과 겹치는 경우, 예를 들어 2023-08-01 데이터를 수집했는데 이 날짜의 데이터를 이전에 이미 수집한 적이 있다면 가장 최근에 수집한 데이터가 이전 데이터를 덮어씁니다:
3.3 ad_spend_mode 파라미터 기능
https://help.adjust.com/zh/article/how-ad-spend-source-affects-your-data
새로운 API 기능에 맞추어 AE에서 기본으로 사용하는 파라미터가 cost_mode에서 ad_spend_mode로 변경되었으며, 파라미터의 기본값은 network입니다.
ad_spend_source를 mixed로 설정하면 광고 지출 값은 다음과 같이 결정됩니다:
- 파트너가 Adjust의 광고 지출 API 연동을 사용하는 경우 광고 지출 = 광고 지출 (채널)입니다. 이 경우 연결 페이지에서 계정을 추가해야 합니다. 그렇지 않으면 값이 0으로 표시됩니다.
- 파트너가 Adjust와 API 연동을 하지 않은 그 밖의 모든 경우에는 광고 지출 = 광고 지출 (어트리뷰션)입니다.