OPPO 마케팅 플랫폼 통합 계획
서드파티 데이터 통합으로 생성된 데이터는 클러스터의 소비 데이터양에 포함됩니다
개요
인터페이스 소개
| 인터페이스명 | 타입 | 세분화 | 어트리뷰션 | 비용 | 수익 | 노출 | 클릭 | 전환 |
|---|---|---|---|---|---|---|---|---|
| 게임 상세 데이터 | API | 집계 지표 | ✅ | ✅ | ✅ | ✅ | ✅ |
현재 AE는 OPPO 마케팅 플랫폼의 게임 상세 데이터 연동을 지원하며, 광고 크리에이티브 레벨의 비용, 클릭, 노출 등 집계 지표 데이터를 가져올 수 있습니다
통합 절차
- OPPO 마케팅 백엔드에 로그인하여 API 키를 가져오고 필요한 인증 정보를 수집합니다
- AE 백엔드에 로그인하여 서드파티 통합 모듈로 이동한 후 OPPO 통합 계획을 추가하고 관련 설정을 완료합니다
- AE 시스템이 데이터를 정상적으로 수신했는지 확인하고 리포트를 구축합니다
1. 인증 정보 가져오기
OPPO 마케팅 플랫폼의 데이터를 연동하기 전에 먼저 데이터 수집에 필요한 기본 정보를 가져와야 합니다. 광고 데이터를 수집할 OPPO 계정으로 OPPO 마케팅 플랫폼에 로그인한 후 도구 상자 - 계정 지원 - API 키 가져오기를 클릭하여 API 키 페이지로 이동합니다. 아직 키를 신청한 적이 없다면 키 가져오기 버튼을 클릭하여 키를 생성하십시오:
키를 생성한 후 광고주 ID, API-ID, API-KEY 세 가지 정보를 기록해 두어야 합니다. 이 정보는 이후 통합 계획을 생성할 때 사용되므로 안전하게 보관하십시오.
2. 계획 설정
OPPO 백엔드에서 인증 정보를 얻은 후 AE 시스템에 로그인하여 서드파티 통합 모듈에서 새 계획의 설정을 완료할 수 있습니다. 아래 그림은 OPPO 게임 상세 데이터의 설정 화면입니다. 이 장의 내용에 따라 계획을 생성하십시오:
2.1 인증 정보 설정
인증 정보 아래의 인증 정보 설정 버튼을 클릭하고 팝업 창에 이전 단계에서 얻은 정보를 입력합니다:
APP ID와 APP Key에는 각각 OPPO 백엔드의 API-ID와 API-KEY를 입력하고, Account ID에는 광고주 ID를 입력합니다
2.2 동기화
동기화 모듈에서 AE 시스템이 OPPO 게임 상세 데이터를 정기적으로 수집하는 전략을 설정할 수 있으며, 매일 특정 시각에 일정 기간의 데이터를 수집하도록 선택할 수 있습니다. 수집한 데이터도 데이터양에 포함되므로 너무 긴 기간의 데이터를 정기적으로 수집하지 않는 것을 권장합니다
2.3 저장 설정
데이터를 이벤트 형태로 기록할지 제어할 수 있습니다. 끄면 데이터가 이벤트 테이블에 기록되지 않으므로 이 설정을 끄지 마십시오.
2.4 통합 설정
마지막으로 통합 설정 모듈에서 데이터 수집의 세부 설정을 제어할 수 있습니다. 데이터의 시간 집계 단위, 수집할 지표 필드와 차원, 저장 후 이벤트 이름 등이 포함됩니다.
통합 설정의 내용은 JSON이며, 다음 내용에 따라 커스텀 설정할 수 있습니다:
| 모듈 | 이름 | 의미 |
|---|---|---|
| sink_event | event_name | 저장 후 이벤트 이름, 커스텀 가능 |
| transfer | fields_whitelist | 저장할 필드 목록, 커스텀 가능. OPPO 게임 상세 데이터는 반환하는 필드가 많으므로 이 필드로 저장할 필드를 필터링합니다. 저장 필드를 조정하려면 아래 내용을 참고하십시오 |
아래는 OPPO 게임 상세 데이터가 반환하는 필드 목록이며, 그중 일부 필드는 저장되지 않습니다. 저장할 필드를 조정하려면 필드 이름을 transfer.fields_whitelist에 입력하십시오:
| 이름 | 저장 여부 | 필드 이름 및 비고 |
|---|---|---|
| fdate | 예 | 데이터 날짜(예: 20210614) |
| app_id | 예 | 앱 id |
| app_name | 예 | 앱 이름 |
| owner_id | 예 | 광고주 Id |
| owner_name | 예 | 광고주 이름 |
| group_id | 예 | 광고 그룹 Id |
| group_name | 예 | 광고 그룹 이름 |
| plan_id | 예 | 계획 id |
| plan_name | 예 | 캠페인 이름 |
| ad_id | 예 | 광고 id |
| ad_name | 예 | 광고 이름 |
| extension_type | 예 | 프로모션 목표: 1 링크 프로모션, 2 앱 프로모션, 3 퀵 앱, 7 WeChat 미니 프로그램 프로모션, 8 라이브 방송 프로모션 |
| global_spec_id | 예 | 통합 규격 id |
| extension_flow | 예 | 프로모션 트래픽: 0 기본값(의미 없음), 1 전체 트래픽 시나리오, 2 자체 트래픽, 3 얼라이언스 트래픽 |
| flow_scene | 예 | 트래픽 시나리오: 0 기본값(의미 없음), 1 전체 트래픽 프로모션, 2 엄선 프로모션, 3 설치 선물, 4 부팅 필수 앱, 5 검색, 6 피드, 7 Banner, 8 스플래시, 9 전면 광고, 10 네이티브, 11 리워드 동영상, 12 얼라이언스 무제한, 13 노출 최적화 |
| total_pay | 예 | 총 결제 매출(펀) |
| ad_new_ssoid | 예 | 가입 유저 수 |
| ad_new_pay_ssoid | 예 | 신규 결제 유저 수 |
| ad_new_pay | 예 | 첫날 결제 매출(단위: 펀) |
| down_cnt | 예 | 다운로드 수(검색 및 배포: 실제 과금 다운로드, 피드 및 얼라이언스: 총 다운로드) |
| expose_nums | 예 | 노출 수 |
| click_nums | 예 | 클릭 수 |
| click_rate | 예 | 클릭률, 소수 |
| down_rate | 예 | 다운로드율, 소수 |
| register_rate | 예 | 가입률, 소수 |
| register_price | 예 | 가입 비용 |
| new_pay_price | 예 | 결제 비용 |
| active_nums | 예 | 활성화 유저 수. UA 다운로드를 통해 최근 180일 이내에 활성화한 유저 |
| active_rate | 예 | 활성화율, 소수 |
| new_pay_rate | 예 | 결제 전환율, 소수 |
| ad_price | 예 | 광고 실제 과금 금액(단위: 펀) |
| new_user_ltv1 | 게임 결제 LTV1(단위: 펀) | |
| new_user_ltv3 | 게임 결제 LTV3(단위: 펀) | |
| new_user_ltv7 | 게임 결제 LTV7(단위: 펀) | |
| new_user_ltv30 | 게임 결제 LTV30(단위: 펀) | |
| buy_user_income0 | 예 | 첫날 광고 수익(단위: 펀) |
| inter_buy_roi1 | 광고 수익화 ROI1 | |
| inter_buy_roi3 | 광고 수익화 ROI3 | |
| inter_buy_roi7 | 광고 수익화 ROI7 | |
| inter_buy_roi30 | 광고 수익화 ROI30 | |
| new_user_roi1 | 게임 결제 ROI1 | |
| new_user_roi3 | 게임 결제 ROI3 | |
| new_user_roi7 | 게임 결제 ROI7 | |
| new_user_roi30 | 게임 결제 ROI30 | |
| ecpm | 예 | |
| click_price | 예 | 평균 클릭 단가(단위: 펀) |
| down_price | 예 | 다운로드 비용(단위: 펀) |
| active_price | 예 | 활성화 비용(단위: 펀) |
| inter_buy_ltv1 | 광고 수익화 LTV1(단위: 펀) | |
| inter_buy_ltv3 | 광고 수익화 LTV3(단위: 펀) | |
| inter_buy_ltv7 | 광고 수익화 LTV7(단위: 펀) | |
| inter_buy_ltv30 | 광고 수익화 LTV30(단위: 펀) | |
| 10per_total_pay | 1-9 배분 결제 매출(단위: 펀) | |
| 50per_total_pay | 5-5 배분 결제 매출(단위: 펀) | |
| pay_retention1 | 익일 리텐션 수(결제) | |
| pay_retention3 | 3일 리텐션 수 | |
| pay_retention7 | 7일 리텐션 수 | |
| pay_retention14 | 14일 리텐션 수 | |
| pay_retention30 | 30일 리텐션 수 | |
| pay_retention1_rate | 익일 리텐션율 | |
| pay_retention3_rate | 3일 리텐션율 | |
| pay_retention7_rate | 7일 리텐션율 | |
| pay_retention14_rate | 14일 리텐션율 | |
| pay_retention30_rate | 30일 리텐션율 | |
| activate_nums | 예 | 앱 실행 유저 수 |
| cash_retention1 | 익일 리텐션 수(수익화) | |
| cash_retention3 | 3일 리텐션 수(수익화) | |
| cash_retention7 | 7일 리텐션 수(수익화) | |
| cash_retention1_rate | 익일 리텐션율(수익화) | |
| cash_retention3_rate | 3일 리텐션율(수익화) | |
| cash_retention7_rate | 7일 리텐션율(수익화) | |
| buy_user_income_active | 예 | UA 광고 수익(단위: 펀) |
| buy_user_income_active_roi | 예 | 광고 수익화 활성 ROI |
| game_app_act_nums | 예 | 게임 핵심 행동 수 |
| game_app_act_price | 예 | 게임 핵심 행동 비용(단위: 펀) |
| pay_nums | 예 | 결제 횟수 |
| pay_per_price | 예 | 결제당 비용(단위: 펀) |
2.5 저장 규칙
- 게임 상세 데이터는 집계 데이터이므로 고정값을 유저 식별자로 사용합니다. 모든 데이터가 하나의 가상 유저에 연결되어 있다고 보면 됩니다
- 데이터의 fdate 필드, 즉 데이터의 집계 시간을 이벤트의 #event_time으로 사용합니다
- 기본 이벤트 이름: oppo_game_offline_data
- transfer.fields_whitelist에 있는 필드는 모두 저장됩니다
2.6 표준화 필드
AE 시스템은 다음 필드를 표준화 처리합니다:
| 원본 필드 | 표준화 필드 | 의미 |
|---|---|---|
| owner_id | te_ads_object.ad_account_id | 광고 계정 ID |
| plan_id | te_ads_object.campaign_id | 캠페인 ID |
| plan_name | te_ads_object.campaign_name | 캠페인 이름 |
| group_id | te_ads_object.ad_group_id | 광고 그룹 ID |
| group_name | te_ads_object.ad_group_name | 광고 그룹 이름 |
| ad_id | te_ads_object.ad_id | 광고 ID |
| ad_name | te_ads_object.ad_name | 광고 이름 |
| app_name | te_ads_object.app_name | 앱 이름 |
| expose_nums | te_ads_object.impressions | 노출 수 |
| click_nums | te_ads_object.clicks | 클릭 수 |
| down_cnt | te_ads_object.installs | 전환 수 |
| ad_price | te_ads_object.cost | UA 비용. 100으로 나눈 값이며 단위는 위안 |
| buy_user_income_active | te_ads_object.revenue | 수익화 수익. 100으로 나눈 값이며 단위는 위안 |