Ocean Engine 광고 업그레이드 버전 데이터 리포트
서드파티 데이터 통합으로 생성된 데이터는 클러스터의 소비 데이터양에 포함됩니다
개요
인터페이스 소개
| 인터페이스명 | 타입 | 세분화 | 어트리뷰션 | 비용 | 수익 | 노출 | 클릭 | 전환 |
|---|---|---|---|---|---|---|---|---|
| 광고 업그레이드 버전 데이터 리포트 | API | 집계 데이터 | ✅ | ✅ | ✅ | ✅ |
광고 업그레이드 버전 데이터 리포트는 Ocean Engine에 새로 추가된 광고 데이터 리포트로, Ocean Engine Ads 업그레이드 버전의 광고 집행 데이터를 수집할 수 있습니다.
통합 절차
- Ocean Engine 오픈 플랫폼에 로그인하여 개발자 계정과 앱을 생성합니다
- 앱의 APP_ID, Secret 및 로그인 사용자 ID를 가져옵니다
- AE 백엔드에 로그인하여 서드파티 통합 모듈로 이동한 후 Ocean Engine 광고 업그레이드 버전 데이터 리포트 통합 계획을 추가합니다
- 인증 링크를 열고, 데이터를 수집할 광고 계정이 속한 Ocean Engine 계정으로 로그인하여 인증을 완료합니다
- AE 시스템이 데이터를 정상적으로 수신했는지 확인하고 리포트를 구축합니다
1. 인증 정보 가져오기
1.1 개발자 계정 및 앱 생성
Ocean Engine 데이터를 연동하기 전에 Ocean Engine 개발자 계정을 신청하고 앱을 하나 생성해야 합니다
- 먼저 Ocean Engine 계정에 로그인하거나 가입해야 합니다. 이 링크를 클릭하여 로그인/가입 페이지로 이동한 후, Ocean Engine 계정이 있다면 왼쪽 하단에서 로그인을 선택하여 해당 계정으로 로그인합니다. 계정이 없다면 이메일 또는 휴대폰 번호로 Ocean Engine 계정을 가입합니다
- 로그인을 마치면 Ocean Engine 오픈 플랫폼으로 이동합니다. 페이지 오른쪽 상단의 개발자 관리 백엔드 버튼을 클릭하여 개발자 백엔드로 들어갑니다
-
개발자 계정을 생성하지 않았다면 이때 개발자 정보 입력과 자격 심사를 완료해야 합니다. 하나의 회사 정보로는 개발자 계정을 하나만 등록·인증할 수 있으므로 반드시 회사 이메일로 신청하고 해당 계정을 안전하게 보관하십시오. 구체적인 신청 절차는 공식 문서를 참고하십시오.
- 개발자 유형은 광고주/대행사 중에서 실제 상황에 맞게 하나를 선택해야 합니다. 두 유형의 차이는 다음과 같습니다:
- 광고주: 개발자 계정과 동일한 회사 주체의 종횡 조직 계정 인증만 신청할 수 있습니다
- 대행사: 개발자 계정과 동일한 회사 주체의 대행사 계정 인증만 신청할 수 있습니다
-
개발자 계정 인증을 통과하면 개발자 공식 사이트의 APPID 관리 페이지로 이동하여 광고 관리 유형의 앱을 생성합니다
- 앱 이름, 앱 아이콘, 앱 설명은 실제 필요에 따라 작성할 수 있으며, 앱 설명에는 Ocean Engine 광고 집행 데이터를 자사 플랫폼으로 콜백하는 용도라고 작성합니다
- 콜백 주소에는 www.thinkingdata.cn을 입력하십시오. 이 주소는 임시 주소이며, 계획 설정을 마친 후 다시 조정해야 합니다
- 권한 신청에서는 최소한 데이터 리포트 권한을 선택해야 합니다
-
신청을 제출하면 Ocean Engine이 영업일 기준 1일 이내에 앱 생성(APPID) 신청 심사를 완료합니다
1.2 App ID, App Secret 가져오기
앱 신청을 마친 후 개발자 백엔드로 이동하여 왼쪽 사이드바에서 앱 관리 - 기본 앱을 찾고, 생성한 앱을 선택한 후 편집을 클릭하여 기본 정보 페이지로 들어가 APP_ID와 Secret을 찾아 기록해 둡니다.
1.3 로그인 사용자 ID 가져오기
다음으로 로그인 사용자의 ID를 가져와야 합니다. Ocean Engine 오픈 플랫폼으로 이동하여 오른쪽 상단의 점 9개 아이콘을 클릭하고 Ocean Engine Ads를 클릭하여 백엔드로 들어간 후, 계정 개요 페이지에서 로그인 사용자 ID를 찾아 기록해 둡니다
1.4 요약
이로써 필요한 인증 정보를 모두 가져왔습니다. 이제 다음 정보를 확보했을 것입니다:
- App ID
- App Secret
- 로그인 사용자 ID
2. 계획 설정
모든 인증 정보를 얻은 후 AE 시스템에 로그인하여 서드파티 통합 모듈에서 새 계획의 설정을 완료할 수 있습니다. 아래 그림은 Ocean Engine 광고 업그레이드 버전 데이터 리포트의 설정 화면입니다. 이 장의 내용에 따라 계획을 생성하십시오:
2.1 인증 정보 설정
인증 정보 아래의 인증 정보 설정 버튼을 클릭하고 팝업 창에 이전 단계에서 얻은 정보를 입력합니다:
참고:
- APP ID: 앱의 APP ID
- APP Secret: 앱의 APP Secret
- Login ID: 로그인 사용자 ID
- Account ID List: 데이터를 수집할 광고 계정 ID. 입력하지 않으면 인증된 사용자 아래의 모든 광고 계정 데이터를 수집합니다
2.2 동기화
동기화 모듈에서 AE 시스템이 Ocean Engine 광고 업그레이드 버전 데이터 리포트를 정기적으로 수집하는 전략을 설정할 수 있으며, 매일 특정 시각에 일정 기간의 데이터를 수집하도록 선택할 수 있습니다. 수집한 데이터도 데이터양에 포함되므로 너무 긴 기간의 데이터를 정기적으로 수집하지 않는 것을 권장합니다
2.3 저장 설정
데이터를 이벤트 형태로 기록할지 제어할 수 있습니다. 끄면 데이터가 이벤트 테이블에 기록되지 않으므로 이 설정을 끄지 마십시오.
2.4 통합 설정
마지막으로 통합 설정 모듈에서 데이터 수집의 세부 설정을 제어할 수 있습니다. 데이터의 시간 집계 단위, 수집할 지표 필드와 차원, 저장 후 이벤트 이름 등이 포함됩니다.
통합 설정의 내용은 JSON이며, 다음 내용에 따라 커스텀 설정할 수 있습니다:
| 모듈 | 이름 | 의미 |
|---|---|---|
| sink_event | event_name | 저장 후 이벤트 이름. 커스텀 가능, 문자열 타입. 수신한 데이터는 모두 이 이름을 이벤트 이름으로 사용합니다. |
| source | metrics | 데이터의 지표, 리스트 타입, 커스텀 가능 |
| group_by | 데이터의 그룹 차원, 리스트 타입, 커스텀 가능 | |
time_granularity | 데이터의 시간 집계 단위, 즉 수집한 데이터를 일 단위로 집계할지 시간 단위로 집계할지 여부 선택 가능한 값: day, hour |
필요에 따라 통합 설정을 수정할 수 있습니다
2.4.1 분석 차원
아래는 광고 업그레이드 버전 데이터 리포트에서 지원하는 차원입니다. 시간 단위 세분화 수준과 일부 차원은 상호 배타적입니다. 다른 분석 차원을 추가하려면 필드 이름을 source.group_by에 입력하면 됩니다
| 필드 이름 | 한국어 이름 | 기본값 | 비고 |
|---|---|---|---|
| advertiser_id(항상 포함, 입력 불필요) | 광고 계정 ID | 예 | |
| cdp_project_id | 프로젝트 ID | 예 | |
| cdp_project_name | 프로젝트 이름 | 예 | |
| cdp_promotion_id | 광고 ID | 예 | |
| cdp_promotion_name | 광고 이름 | 예 | |
| package_name | 패키지 이름 | ||
| platform | 플랫폼 | 다음 차원과 상호 배타적
시간 단위 세분화 수준에서 사용 불가 | |
| gender | 성별 | ||
| age | 나이 | ||
| ac | 네트워크 | ||
| province_name | 성(Province) | 다음 차원과 상호 배타적
시간 단위 세분화 수준에서 사용 불가 | |
| city_name | 도시 | ||
| image_mode | 소재 유형 | ||
| landing_type | 프로모션 목적 | ||
| external_action | 전환 목표 | ||
| pricing | 과금 유형 | ||
| deep_external_action | 심층 전환 목표 | ||
| ad_platform_cdp_project_download_type | 다운로드 방식 | ||
| ad_platform_cdp_project_download_url | 다운로드 링크 | ||
| ad_platform_cdp_project_action_track_url | 전환 모니터링 주소 | ||
| delivery_mode | 광고 집행 모드 | ||
| ad_platform_cdp_promotion_bid | 광고 입찰가 | ||
| ad_platform_cdp_promotion_deep_cpa_bid | 심층 전환 입찰가 | ||
| ad_platform_cdp_promotion_roi_goal | ROI 계수 | ||
| app_code | 우선 게재 위치 |
2.4.2 포함 지표
아래 표는 광고 업그레이드 버전 데이터 리포트에서 지원하는 자주 사용하는 일부 지표입니다. 전체 지표가 너무 많아 여기에 모두 표시할 수 없습니다. 다른 지표를 추가하려면 지표 이름을 source.metrics에 입력하면 됩니다
| 지표명 | 한국어 이름 | 기본값 | 비고 |
|---|---|---|---|
| stat_cost | 지출 | 예 | |
| show_cnt | 노출 수 | 예 | |
| cpm_platform | 1,000회 노출당 평균 비용 | 예 | |
| click_cnt | 클릭 수 | 예 | |
| ctr | 클릭률 | 예 | |
| cpc_platform | 평균 클릭 단가 | 예 | |
| convert_cnt | 전환 수 | 예 | |
| conversion_cost | 평균 전환 비용 | 예 | |
| conversion_rate | 전환율 | 예 | |
| deep_convert_cnt | 심층 전환 수 | ||
| deep_convert_cost | 심층 전환 비용 | ||
| deep_convert_rate | 심층 전환율 | ||
| active | 활성화 수 | 예 | |
| active_cost | 활성화 비용 | 예 | |
| active_rate | 활성화율 | 예 | |
| active_register | 가입 수 | 예 | |
| active_register_cost | 가입 비용 | 예 | |
| active_register_rate | 가입률 | 예 | |
| game_addiction | 핵심 행동 수 | ||
| game_addiction_cost | 핵심 행동 비용 | ||
| game_addiction_rate | 핵심 행동률 | ||
| total_play | 재생 수 | 예 | |
| valid_play | 유효 재생 수 | 예 | |
| valid_play_cost | 유효 재생 비용 | 예 | |
| valid_play_rate | 유효 재생률 | 예 | |
| valid_play_of_mille | 1,000회 유효 재생 수 | 예 | |
| valid_play_cost_of_mille | 1,000회 유효 재생 비용 | 예 | |
| play_25_feed_break | 25% 진행 재생 수 | 다음 분석 차원과 호환되지 않음:
| |
| play_50_feed_break | 50% 진행 재생 수 | ||
| play_75_feed_break | 75% 진행 재생 수 | ||
| play_99_feed_break | 99% 진행 재생 수 | ||
| average_play_time_per_play | 평균 1회 재생 시간 | ||
| play_over_rate | 재생 완료율 | ||
| wifi_play_rate | WiFi 재생 비율 | ||
| card_show | 3초 카드 노출 수 | ||
| play_duration_3s | 3초 재생 수 |
2.4.3 데이터 저장 규칙
- 데이터의 dimensions_stat_time_hour 또는 dimensions_stat_time_day 필드, 즉 데이터의 날짜를 집계 데이터의 #event_time으로 설정합니다
- 데이터 이벤트 이름은 oceanengine_custom_data입니다
- 나머지 필드는 모두 저장됩니다
2.5 인증 완료
설정을 마친 후 오른쪽 상단의 저장 및 인증을 클릭하여 계획 설정을 저장할 수 있습니다. 이어서 마지막 인증 작업을 완료해야 합니다:
먼저 팝업된 인증 정보 페이지에서 첫 번째 단계의 주소를 복사합니다
Ocean Engine 개발자 백엔드로 돌아가 앞서 생성한 앱의 기본 정보 페이지로 이동한 후, 방금 복사한 주소를 콜백 주소란에 입력합니다
그런 다음 AE 화면으로 돌아와 권한 설정으로 이동을 클릭하면 Ocean Engine의 인증 페이지가 열립니다
인증 화면이 표시되면 현재 사용자의 전체 계정을 선택하고, 현재 로그인 사용자가 데이터를 수집할 광고 계정을 보유하고 있는지 확인합니다. 빨간색 상자 안의 로그인 사용자 ID가 계획 설정에서 입력한 로그인 사용자 ID인지 확인하십시오. 확인을 마치면 인증 동의를 클릭하여 인증 작업을 완료합니다.
인증을 완료한 후 인증 정보에서 왼쪽 하단의 위의 두 단계를 완료했습니다를 클릭한 다음 오른쪽 하단의 인증 완료를 클릭하여 설정을 마칩니다. 이로써 Ocean Engine 광고 업그레이드 버전 데이터 리포트의 통합이 완료됩니다.
2.6 표준화 필드
Ocean Engine 광고 업그레이드 버전 데이터 리포트의 일부 필드는 AE 시스템에서 표준화 처리합니다:
| 필드 이름 | 표준화 필드 | 의미 |
|---|---|---|
| advertiser_id | te_ads_object.ad_account_id | 광고주 ID |
| cdp_project_name | te_ads_object.ad_group_name | 캠페인 이름 |
| cdp_project_id | te_ads_object.ad_group_id | 캠페인 ID |
| cdp_promotion_name | te_ads_object.ad_name | 크리에이티브 이름 |
| cdp_promotion_id | te_ads_object.ad_id | 크리에이티브 ID |
| package_name | te_ads_object.app_name | 앱 이름 |
| platform | te_ads_object.platform | 플랫폼(Android, iOS 등) |
| CNY(고정값) | te_ads_object.currency | 비용 또는 수익의 통화 |
| show_cnt | te_ads_object.impressions | 노출 수 |
| click_cnt | te_ads_object.clicks | 클릭 수 |
| convert_cnt | te_ads_object.installs | 클릭 설치 수 |
| stat_cost | te_ads_object.cost | 총 지출 |