Unity Ads Advertising Statistics API
서드파티 데이터 통합으로 생성된 데이터는 클러스터의 소비 데이터양에 포함됩니다
개요
인터페이스 소개
| 인터페이스명 | 타입 | 세분화 | 어트리뷰션 | 비용 | 수익 | 노출 | 클릭 | 전환 |
|---|---|---|---|---|---|---|---|---|
| Advertising Statistics API | API | 집계 지표 | ✅ | ✅ | ✅ | ✅ |
Unity Ads 광고 집행 데이터를 Advertising Statistics API를 통해 Thinking Analytics(이하 AE 시스템)로 전송하는 방안으로, 이 방안은 다음을 지원합니다:
- Unity Ads의 비용, 클릭, 노출 등 기본 리포트 지표를 AE 시스템으로 전송
통합 절차
- Unity Dashboard 백엔드에 로그인하여 데이터를 연동할 프로젝트의 Organization ID와 API Key를 가져옵니다
- AE 백엔드에 로그인하여 서드파티 통합 모듈로 이동한 후 Unity 통합 계획을 추가하고 관련 설정을 완료합니다
- AE 시스템이 데이터를 정상적으로 수신했는지 확인하고 리포트를 구축합니다
1. 인증 정보 가져오기
1.1 Organization ID 가져오기
Unity Dashboard 백엔드로 이동하여 왼쪽 사이드바의 Growth 페이지 아래에 있는 Settings 페이지를 선택하고, Organization 표에서 Organization ID를 찾아 복사해 저장합니다(Organization Core ID가 아닌 점에 유의하십시오).
1.2 API Key 가져오기
다시 왼쪽 사이드바의 Growth 페이지 아래에 있는 API Management 탭을 선택하고, Stats API Access 표에서 API Key를 찾아 복사해 저장합니다.
2. 계획 설정
Unity 백엔드에서 인증 정보를 가져온 후 AE 시스템에 로그인하여 서드파티 통합 모듈에서 새 계획을 설정할 수 있습니다. 아래 그림은 Unity Ads Advertising Statistics API의 설정 화면입니다. 이 장의 내용에 따라 계획을 생성하십시오:
2.1 인증 정보 설정
인증 정보 아래의 인증 정보 설정 버튼을 클릭하고 팝업 창에 이전 단계에서 얻은 정보를 입력합니다:
2.2 동기화
동기화 모듈에서 AE 시스템이 Unity Ads Advertising Statistics API 데이터를 정기적으로 수집하는 정책을 설정할 수 있으며, 매일 특정 시각에 일정 기간의 데이터를 수집하도록 선택할 수 있습니다. 수집한 데이터도 데이터양에 포함되므로 너무 긴 기간의 데이터를 정기적으로 수집하지 않는 것을 권장합니다
2.3 저장 설정
데이터를 이벤트 형태로 기록할지 제어할 수 있습니다. 끄면 데이터가 이벤트 테이블에 기록되지 않으므로 이 설정을 끄지 마십시오.
2.4 통합 설정
마지막으로 통합 설정 모듈에서 데이터 수집의 세부 설정을 제어할 수 있습니다. 데이터의 시간 집계 단위, 수집할 지표 필드와 차원, 저장 후 이벤트 이름 등이 포함됩니다.
통합 설정의 내용은 JSON이며, 다음 내용에 따라 커스텀 설정할 수 있습니다:
| 모듈 | 이름 | 의미 |
|---|---|---|
| sink_event | event_name | 저장 후 이벤트 이름, 커스텀 가능, 문자열 타입. |
| source | time_granularity | 데이터 수집의 시간 단위. 다음 중에서 선택할 수 있습니다:
|
| metrics | 해당 인터페이스의 지표 필드, 리스트 타입, 커스텀 가능 | |
| group_by | 데이터의 그룹 차원, 리스트 타입, 커스텀 가능 | |
| transfer | double_columns | 데이터의 지표, 리스트 타입. 여기에 포함된 필드는 데이터 수신 시 숫자 타입으로 저장되고, 나머지 필드는 문자열(또는 시간)로 저장됩니다. 조정하지 않는 것을 권장 |
- 그룹 차원
다음은 Unity Advertising Statistics API가 지원하는 그룹 차원입니다. 조정하려면 필요한 그룹 차원의 차원 이름을 source.group_by에 입력하십시오
| 차원명 | 설명 | 저장 필드명 | 기본 수집 여부 |
|---|---|---|---|
campaignSet | Campaign Set 기준 그룹화 | campaign_set_id | 예 |
| campaign_set_name | 예 | ||
| campaign | Campaign 기준 그룹화 | campaign_id | 예 |
| campaign_name | 예 | ||
| creativePack | Creative Pack 기준 그룹화 | creative_pack_id | 예 |
| creative_pack_name | 예 | ||
| target | 대상 게임 기준 그룹화 | target id | 예 |
| target store id | 예 | ||
| target name | 예 | ||
| adType | 광고 타입별 그룹화 | ad_type | 예 |
| sourceAppId | 소스 게임 기준 그룹화 | source_app_id | 예 |
| store | 앱 스토어 기준 그룹화 | store | 예 |
| country | 국가(지역)별 그룹화 | country | 예 |
| platform | 플랫폼 기준 그룹화 | platform | 예 |
| osVersion | 시스템 버전 기준 그룹화 | os_version | 예 |
| skadConversionValue | SKAdNetwork 전환 값 기준 그룹화 | skad_conversion_value |
- 지표 필드
그룹 차원 외에도 Unity Ads Advertising Statistics API는 다음 지표 필드를 제공합니다. 조정하려면 필요한 지표 이름을 source.metrics에 입력하십시오.
| 지표명 | 저장 필드명 | 필드 설명 | 기본 수집 여부 |
|---|---|---|---|
| timestamp | timestamp | 이벤트 시간 | 예 |
| starts | starts | 광고 노출 횟수 | 예 |
| views | views | 광고 완료 재생 횟수 | 예 |
| clicks | clicks | 광고 클릭 수 | 예 |
| installs | installs | 광고 조회 후 설치 횟수 | 예 |
| spend | spend | 비용 | 예 |
| skadInstalls | skad_installs | SKAdNetwork 설치 | |
| skadCpi | skad_cpi | SKAdNetwork CPI | |
skadConversion | skad_conversion | SKAdNetwork 전환 |
2.5 이벤트 저장 규칙
- 데이터의 timestamp 필드, 즉 데이터 집계 시간 필드를 집계 데이터의 #event_time으로 설정합니다
- 이름을 변경하지 않은 경우 데이터의 이벤트 이름은 -- unity_ads_api_data입니다
- 나머지 필드는 모두 저장됩니다
2.6 표준화 필드
Unity Ads Advertising Statistics API 데이터의 일부 필드는 AE 시스템에서 표준화 처리합니다:
| 필드 | 표준화 필드 | 의미 |
|---|---|---|
| campaign_name | te_ads_object.campaign_name | 캠페인 이름 |
| campaign_id | te_ads_object.campaign_id | 캠페인 ID |
| creative_pack_name | te_ads_object.ad_group_name | 광고 그룹 이름 |
| creative_pack_id | te_ads_object.ad_group_id | 광고 그룹 ID |
| country | te_ads_object.country | 국가/지역 코드 |
| platform | te_ads_object.platform | 플랫폼(Android, iOS 등) |
| starts | te_ads_object.impressions | 노출 수 |
| clicks | te_ads_object.clicks | 클릭 수 |
| installs | te_ads_object.installs | 전환 수(설치) |
| spend | te_ads_object.cost | UA 비용 |