# Adjust Report Service API
WARNING
주의. 플랫폼 데이터 통합을 통해 생성된 데이터는 클러스터의 데이터 소비량으로 계산됨을 유의하십시오.
# 개요
API 이름 | 통합 유형 | 데이터 세분성 | 어트리뷰션 | 비용 | 수익 | 노출 | 클릭 | 전환 |
|---|---|---|---|---|---|---|---|---|
Report Service API | API | 집계 | ✅ | ✅ | ✅ | ✅ | ✅ |
Adjust의 Report Service API는 비용, 수익, 노출 횟수, 클릭 수, 전환 등 다양한 데이터를 포함한 집계된 메트릭 데이터를 제공합니다.
# 통합 절차
Adjust Report Service API 데이터 접근 절차는 다음과 같습니다:
- Adjust 백엔드에서 Adjust API 식별 코드와 앱 식별 코드를 획득합니다.
- TE 백엔드에 로그인하고, 서드파티 통합 모듈로 이동하여, Apple Search Ads 통합 솔루션을 추가하고 관련 설정을 완료합니다.
- TE 시스템이 데이터를 정상적으로 수신하고, 보고서 구축이 완료되었는지 확인합니다.
# Adjust API의 식별 코드와 앱 식별 코드를 획득하기
# 1.1 Adjust API의 식별 코드 획득
Report Service API를 사용하기 전에, 먼저 Adjust API의 토큰을 획득해야 합니다.
이 토큰은 Adjust Suite의 백엔드에서 [계정 설정] - [내 프로필]에서 얻을 수 있습니다.
클래식 컨트롤 패널에서는, [내 계정] - [데이터] 탭의 [사용자 상세] 섹션에서 [기어 버튼]을 클릭하여 얻을 수 있습니다.
아래는 Adjust Suite 인터페이스에서, API 식별 코드는 이미지 내의 API 토큰입니다:
# 1.2 앱 식별 코드 획득
다음으로, Adjust의 앱 식별 코드를 획득해야 합니다. 이를 통해 데이터의 출처가 어떤 Adjust 프로젝트인지 결정할 수 있습니다.
Adjust 백엔드로 이동하여 앱을 검색한 후 앱 옵션의 삽입 기호(^)를 클릭합니다. 왼쪽의 프로젝트 카드에는 앱 식별 코드(App Token)가 표시됩니다. 또한, '모든 설정'을 클릭하고 '앱 세부 정보 보기'를 클릭하여 앱 식별 코드를 획득할 수 있습니다.
# 계획 구성
Adjust의 API 식별 코드와 앱 식별 코드를 획득한 후, TE 시스템에 로그인하여 '서드파티 통합' 모듈에서 새로운 계획의 구성을 할 수 있습니다. 아래는 Adjust Report Service API의 구성 화면입니다.
# 2.1 인증 정보 설정
[설정] 버튼을 클릭하고 팝업 내에 API 식별 코드와 앱 식별 코드를 입력해 주세요.
# 동기화
[동기화] 에서, TE 시스템이 Adjust Report Service API 데이터를 정기적으로 가져오는 규칙을 설정할 수 있습니다. 특정 시간대마다 매일 또는 매시간 데이터를 가져올 수 있습니다. 가져온 데이터도 데이터 양에 포함되므로, 긴 시간 데이터의 정기적인 가져오기는 피하는 것이 좋습니다.
# 2.3 수집 시간대
데이터를 가져올 때, 시간대를 설정할 수도 있습니다.
# 2.4 저장 설정
데이터가 이벤트 형태로 기록되는지 여부를 제어할 수 있습니다. 이벤트 데이터 저장을 켜는 것이 좋습니다.
# 2.5 통합 구성
마지막으로, 데이터 가져오기의 세부 설정을 '통합 구성' 모듈에서 제어할 수 있습니다. 이에는 데이터의 시간 집계 세분성, 가져올 필드나 차원, 그리고 이벤트 이름 등이 포함됩니다.
통합 설정의 내용은 JSON 형식이며, 아래 내용에 따라 사용자 정의 설정을 할 수 있습니다:
모듈 | 이름 | 의미 |
|---|---|---|
sink_event | event_name | 저장 후의 이벤트 이름, 커스텀 가능 |
source | metrics | 데이터 내의 지표, 리스트 타입으로, 커스텀 가능 |
group_by | 데이터의 그룹화 차원, 리스트 타입으로 커스텀 가능 |
필요에 따라 통합 구성을 변경할 수 있습니다.
# 2.5.1 지원 지표
source.metrics에는 통합 설정에서 대응하는 지표가 포함되어 있습니다. Report Service가 지원하는 지표는 매우 다양합니다. 상세한 지표 목록에 대해서는 Adjust 공식 웹사이트의 문서 (opens new window)를 참조해 주세요.
# 2.5.2 그룹 차원
Report Service에서 지원하는 그룹화 차원은 다음과 같습니다. 이는 통합 설정의 source.groupby에 해당합니다. 시간의 세분성(하나만 선택 가능)과 그룹화 차원(여러 개 선택 가능)이 포함됩니다. 메트릭을 변경할 경우, source.groupby에 필요한 지표의 필드 이름을 입력해 주세요.
- 시간 세분성
세분성 | 데이터 타입 | 설명 | 예시시 | 기본 사용 |
|---|---|---|---|---|
hour | 시간 | ISO 형식의 날짜 값: YYYY-MM-DDTHH:MM:SS | 2021-05-11T17:00:45 | |
day | 시간 | 날짜 형식：YYYY-MM-DD | 2021-05-11 | Yes |
세분성 | 데이터 타입 | 설명 | 예시 | 기본 사용 |
|---|---|---|---|---|
os_name | 문자열 | OS | 값: android, Bada, blackberry, iOS, Linux, Mac OS, server, symbian, unknown, WebOS, Windows, windows-phone | Yes |
device_type | 문자열 | 디바이스 타입 | 값: bot, console, iPod, Mac, PC, phone, server, simulator, tablet, TV, unknown | Yes |
app | 문자열 | 앱 이름 | - | Yes |
app_token | 문자열 | Adjust 내의 앱ID | - | Yes |
store_id | 문자열 | 스토어ID | com.random.app | Yes |
store_type | 문자열 | 설치 스토어 | google_play | Yes |
app_network | 문자열 | 앱 식별 |
형식: | Yes |
currency | 문자열 | 통화 | Euro | Yes |
currency_code | 문자열 | 3자리 ISO 4217 통화 코드 | EUR | Yes |
network | 문자열 | 광고 채널 이름 | 값: Organic, AppLovin, Facebook Installs, Instagram Installs | |
campaign | 문자열 | 캠페인 이름과 ID | - | Yes |
campaign_network | 문자열 | 채널의 캠페인 이름 | - | Yes |
campaign_id_network | 문자열 | 채널의 캠페인ID | - | Yes |
adgroup | 문자열 | 광고 그룹 이름과 ID | - | Yes |
adgroup_network | 문자열 | 채널의 광고 그룹 이름 | - | Yes |
adgroup_id_network | 문자열 | 채널의 광고 그룹 ID | - | Yes |
source_network | 문자열 | 채널에 따른 선택 가능한 값, 일반적으로 adgroup_network와 동일 | - | Yes |
source_id_network | 문자열 | source_app 값 | - | Yes |
creative | 문자열 | 소재 이름과 ID | - | Yes |
creative_network | 문자열 | 채널 소재 이름 | - | Yes |
creative_id_network | 문자열 | 채널 소재ID | - | Yes |
country | 문자열 | 국가/지역 이름 | United States of America | Yes |
country_code | 문자열 | 2자리 ISO 3166 국가/지역 코드 | US | Yes |
region | 문자열 | 리전 | APAC | Yes |
partner_name | 문자열 | Adjust 파트너 이름 조정 | AppLovin | Yes |
partner_id | 문자열 | Adjust 파트너ID 조정 | 34 | Yes |
# 2.5.3 저장 규칙
아래는 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 | OS 이름, 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 | 비용 |
revenue | te_ads_object.revenue | 수익 |
# 후속 사용
# 3.1 데이터 저장 확인
[데이터 관리] 페이지에서, 이벤트 adjust_report_service_ad_spend가 데이터베이스에 저장되어 있는지 확인할 수 있습니다.
# 3.2 한 번에 데이터 가져오기
이전 특정 기간의 데이터, 예를 들어 과거 데이터나 가져오기에 실패한 데이터 등을 포함시키기 위해서는 데이터를 저장한 후 프로젝트 페이지로 다시 들어가 상단 우측의 '단일 수집' 버튼을 클릭하고 특정 시간 범위를 설정하여 데이터를 수집할 수 있습니다. 하지만 주의해야 할 점이 있습니다. 수집하려는 데이터의 기간이 이전에 수집된 기간과 중복될 경우(예: 2023년 8월 1일 데이터를 수집하려고 했지만, 해당 날짜의 데이터가 이미 수집된 상태라면), 최신의 수집 결과가 이전 데이터를 덮어쓰게 됩니다.