Tencent 일간 리포트
서드파티 데이터 통합으로 생성된 데이터는 클러스터의 소비 데이터양에 포함됩니다
개요
인터페이스 소개
| 인터페이스명 | 타입 | 세분화 | 어트리뷰션 | 비용 | 수익 | 노출 | 클릭 | 전환 |
|---|---|---|---|---|---|---|---|---|
| 일간 리포트 | API | 집계 데이터 | ✅ | ✅ | ✅ | ✅ | ✅ |
Tencent Ads의 일간 리포트는 지출, 클릭, 노출 등의 지표를 포함한 집계 데이터의 반환을 지원합니다
통합 절차
Tencent Ads와의 데이터 통합 절차는 다음과 같습니다:
- AE 백엔드에 로그인하여 서드파티 통합 모듈로 이동한 후 Tencent Ads 일간 리포트 통합 계획을 추가하고 관련 설정을 완료한 다음 인증 콜백 주소를 복사합니다
- Tencent Ads 개발자 플랫폼에 접속하여 개발자로 등록하고 앱을 생성한 후 Client ID와 Client Secret을 가져옵니다
- AE 백엔드로 돌아와 이전의 Tencent Ads 일간 리포트 통합 계획을 수정하여 앱의 Client ID와 Secret을 입력하고, 인증 링크를 열어 인증을 완료합니다
- AE 시스템이 데이터를 정상적으로 수신했는지 확인하고 리포트를 구축합니다
1. 통합 방안 설정
Tencent Ads 데이터를 연동하기 전에 먼저 AE 백엔드에서 해당 통합 계획을 생성하고 인증 콜백 주소를 가져와야 합니다. 이 문서에 따라 통합 계획을 생성하십시오
1.1 임시 인증 정보 입력
먼저 인증 정보 영역의 인증 정보 설정 버튼을 클릭하고, 표시되는 인증 정보 팝업 창에 임시 인증 정보로 아무 값이나 입력합니다. 이후 Tencent Ads 개발 플랫폼에서 앱 생성을 완료한 후 다시 수정해야 합니다.
1.2 동기화
동기화 모듈에서 AE 시스템이 Tencent Ads 일간 리포트 데이터를 정기적으로 수집하는 전략을 설정할 수 있으며, 매일 특정 시각에 일정 기간의 데이터를 수집하도록 선택할 수 있습니다. 수집한 데이터도 데이터양에 포함되므로 너무 긴 기간의 데이터를 정기적으로 수집하지 않는 것을 권장합니다
1.3 저장 설정
데이터를 이벤트 형태로 기록할지 제어할 수 있습니다. 끄면 데이터가 이벤트 테이블에 기록되지 않으므로 이 설정을 끄지 마십시오.
1.4 통합 설정
마지막으로 통합 설정 모듈에서 데이터 수집의 세부 설정을 제어할 수 있습니다. 데이터의 시간 집계 단위, 수집할 지표 필드와 차원, 저장 후 이벤트 이름 등이 포함됩니다.
통합 설정의 내용은 JSON이며, 다음 내용에 따라 커스텀 설정할 수 있습니다:
| 모듈 | 이름 | 의미 |
|---|---|---|
| sink_event | event_name | 저장 후 이벤트 이름, 커스텀 가능 |
| source | metrics | 수집할 데이터의 필드, 리스트 타입, 커스텀 가능 |
| group_by | 수집할 데이터의 집계 조건, 리스트 타입, 커스텀 가능 | |
| extra_params | level | 수집할 데이터의 리포트 타입 레벨, 커스텀 가능 |
- 리포트 타입 레벨 및 집계 조건
리포트 타입 레벨과 집계 조건은 일간 리포트의 데이터 세분화 수준을 결정합니다. 예를 들어 광고 그룹 단위로 데이터를 집계할지, 소재 단위로 집계할지를 결정합니다. 한 번의 조회에서는 하나의 리포트 타입 레벨만 선택할 수 있으며, 리포트 타입 레벨마다 지원하는 집계 조건이 다릅니다. 아래에는 자주 사용하는 일부 레벨과 각 레벨에서 지원하는 집계 조건을 표시하며, 자세한 내용은 공식 문서에서 확인할 수 있습니다. 기본 리포트 타입 레벨과 집계 조건은 각각 REPORT_LEVEL_AD와 "date","ad_id","site_set"입니다. 조정이 필요한 경우 리포트 타입 레벨은 extra_params에, 집계 조건은 source.group_by에 입력합니다:
| 리포트 타입 레벨 | 설명 | 기본값 | 지원하는 집계 조건 |
|---|---|---|---|
| REPORT_LEVEL_ADVERTISER | 광고주 레벨 리포트 | "date" | |
| REPORT_LEVEL_CAMPAIGN | 프로모션 계획 레벨 리포트 | "date", "campaign_id" | |
| REPORT_LEVEL_ADGROUP | 광고 그룹 레벨 리포트 | "date", "adgroup_id", "site_set" | |
| REPORT_LEVEL_AD | 광고 레벨 리포트 | 예 | "date", "ad_id", "site_set" |
| REPORT_LEVEL_MATERIAL_VIDEO | 동영상 소재 리포트 | "date", "material_id", "site_set" | |
| REPORT_LEVEL_MATERIAL_IMAGE | 이미지 소재 리포트 | "date", "material_id", "site_set" |
- 수집 필드
아래는 일간 리포트에서 기본으로 수집하는 그룹 필드입니다. 그룹 필드는 수집 차원의 영향을 받습니다. 세분화 수준이 높은 집계 조건에서는 그보다 세분화 수준이 낮은 집계 조건의 그룹 필드도 지원합니다. 예를 들어 "ad_id"를 집계 조건으로 사용하면 "campaign_name", "adgroup_id" 등 세분화 수준이 낮은 그룹 필드를 수집할 수 있습니다. 조정이 필요한 경우 필요한 그룹 필드 이름을 source.metrics에 입력하십시오:
| 그룹 필드 | 설명 |
|---|---|
| campaign_name | 캠페인 이름 |
| campaign_id | 캠페인 ID |
| adgroup_name | 광고 그룹 이름 |
| adgroup_id | 광고 그룹 ID |
| ad_name | 광고 이름 |
| ad_id | 광고 ID |
| account_id | 광고 계정 ID |
아래는 일간 리포트에서 지원하는 일부 지표입니다. 이 리포트는 지표가 매우 많으므로 여기서는 자주 사용하는 일부 지표만 표시합니다. 전체 지표는 공식 문서에서 확인하십시오. 조정이 필요한 경우 필드 이름을 source.metrics에 입력하십시오:
| 필드 | 설명 |
|---|---|
| view_count | 노출 수 |
| download_count | APP 다운로드 완료 수 |
| activated_count | APP 활성화 총수 |
| activated_rate | APP 다운로드 활성화율 |
| thousand_display_price | 1,000회 노출당 평균 비용 |
| valid_click_count | 클릭 수 |
| ctr | 클릭률 |
| cpc | 평균 클릭 단가 |
| cost | 비용 |
| key_page_view_cost | 핵심 페이지 방문 비용 |
| coupon_click_count | (게임) 선물 패키지 교환 버튼 클릭 |
| coupon_issue_count | (게임) 선물 패키지(쿠폰) 발급 수 |
| coupon_get_count | (게임) 선물 패키지(쿠폰) 수령 수 |
| download_rate | APP 다운로드율 |
| download_cost | APP 다운로드 비용 |
| install_count | APP 설치 수 |
| install_cost | APP 설치 비용 |
| click_activated_rate | APP 클릭 활성화율 |
| activated_cost | APP 활성화 비용 |
| app_register_count | 가입 수(APP) |
| register_by_display_count | 가입 수(노출 어트리뷰션) |
| app_register_cost | 가입 비용(APP) |
| app_order_cost | 주문 비용(APP) |
| app_checkout_count | 결제 행동 수(APP) |
| app_checkout_by_display_count | 결제 행동 수(노출 어트리뷰션) |
| app_checkout_cost | 결제 행동 비용(APP) |
| app_ad_paying_users | 광고 수익화 유저 수(APP) |
| ad_pur_val_app | 광고 수익화 금액(APP) |
| game_create_role_count | 게임 내 캐릭터 생성 수 |
| game_authorize_count | 게임 인증 수 |
| game_tutorial_finish_count | 게임 튜토리얼 완료 수 |
| app_checkout_rate | 클릭 결제 행동률(APP) |
| app_activated_checkout_rate | 활성화 결제 행동률(APP) |
| app_register_rate | 가입률(APP) |
| install_rate | APP 설치율 |
| first_pay_count | 첫 결제 행동 유저 수 |
| first_pay_rate | 첫 활성화 결제율 |
| wechat_app_register_uv | WeChat 미니 게임 가입 유저 수 |
| no_interest_count | 관심 없음 클릭 수 |
| mini_game_register_users | 미니 게임 가입 유저 수 |
| mini_game_register_cost | 미니 게임 가입 비용 |
| mini_game_register_rate | 미니 게임 가입률 |
| mini_game_ad_monetization_users | 미니 게임 광고 수익화 유저 수 |
| mini_game_paying_count | 미니 게임 결제 횟수 |
| mini_game_paying_amount | 미니 게임 결제 금액 |
| mini_game_first_paying_users | 미니 게임 첫 결제 유저 수 |
| mini_game_create_role_users | 게임 내 캐릭터 생성 유저 수 |
| mini_game_create_role_cost | 게임 내 캐릭터 생성 비용 |
| mini_game_key_page_viewers | 미니 게임 핵심 페이지 방문 유저 수 |
| mini_game_key_page_view_cost | 미니 게임 핵심 페이지 방문 비용 |
| mini_game_ad_monetization_amount | 미니 게임 광고 수익화 금액 |
| key_page_view_rate | 핵심 페이지 방문율 |
| activate_register_rate | 활성화 가입률 |
| key_behavior_conversions_count | 핵심 행동 전환 수 |
| key_behavior_conversions_cost | 핵심 행동 전환 비용 |
| key_behavior_conversions_rate | 핵심 행동 전환율 |
| mini_game_ad_monetization_cost | 미니 게임 광고 수익화 비용 |
| mini_game_bf_uv | 미니 게임 복귀 유저 수 |
| mini_game_bf_cost | 미니 게임 복귀 비용 |
| mini_game_bf_income_uv | 미니 게임 복귀 광고 수익화 유저 수 |
| mini_game_bf_income_amount | 미니 게임 복귀 광고 수익화 금액 |
| mini_game_bf_income_d1_uv | 미니 게임 첫날 복귀 광고 수익화 유저 수 |
| mini_game_bf_income_d1_amount | 미니 게임 첫날 복귀 광고 수익화 금액 |
| mini_game_bf_income_d1_cost | 미니 게임 첫날 복귀 광고 수익화 비용 |
1.5 인증 콜백 주소 가져오기
위 설정을 완료한 후 오른쪽 상단의 저장 및 인증을 클릭하여 인증 정보를 가져옵니다. 첫 번째 단계의 인증 콜백 주소를 복사하여 잘 보관하십시오. 그런 다음 권한 부여 안 함을 클릭하여 팝업 창을 닫습니다:
저장 및 인증을 클릭하면 계획이 이미 저장되므로 따로 저장할 필요가 없습니다. 이로써 AE 백엔드의 설정 작업을 일단 마쳤습니다. 다음으로 Tencent Ads 백엔드에서 관련 설정을 완료하십시오.
2. 개발자 등록 및 앱 생성
다음으로 Tencent Ads 개발자 백엔드에 로그인하여 다른 QQ 번호로 개발자로 등록합니다.
개발자로 등록한 후 애플리케이션 관리 패널에서 새 앱 만들기를 클릭합니다.
이어서 앱 생성 페이지에서 앱 생성을 완료합니다:
- 앱 유형은 서드파티 앱을 선택합니다
- 앱 아이콘, 앱 이름, 앱 소개는 자유롭게 지정할 수 있습니다
- 콜백 주소에는 AE 시스템에서 가져온 인증 정보 주소를 입력하십시오
권한 선택에서 최소한 광고 인사이트(Ads Insight) 권한을 선택하십시오
앱을 생성한 후 앱의 client id와 client_secret을 가져와 기록해 두십시오
3. AE 백엔드로 돌아와 인증 완료
Tencent 앱을 생성한 후 AE 백엔드로 돌아와 앞서 생성한 Tencent 통합 계획으로 이동하여 인증 정보 아래의 인증 정보 설정 버튼을 클릭합니다:
다음으로 Tencent 앱의 Client ID와 Client Secret을 해당 위치에 입력하고, Login ID에는 인증 시 로그인할 QQ 번호 또는 WeChat ID를 입력합니다. Account ID List에는 데이터를 수집할 광고 계정의 ID를 입력할 수 있으며, 여러 ID는 ","로 구분합니다. 입력하지 않으면 인증된 모든 광고 계정의 데이터를 수집합니다. 편집을 마친 후 저장 버튼을 클릭합니다:
이어서 오른쪽 상단의 저장 및 인증을 클릭하여 인증 정보 팝업 창으로 다시 이동합니다. 이때 권한 설정으로 이동을 클릭하면 Tencent 플랫폼의 인증 페이지가 열립니다
인증 페이지에서 광고 계정으로 로그인하고 최소한 광고 인사이트 데이터 권한을 선택한 후 인증 동의 버튼을 클릭하면 인증이 완료됩니다
참고로, 로그인하여 인증한 계정이 QQ 직접 고객 계정이면 현재 고객의 프로모션 계정에 대한 데이터 권한만 얻습니다. 로그인하여 인증한 계정이 QQ 비즈니스 매니저 계정이면 매니저 계정 아래의 모든 프로모션 계정에 대한 데이터 권한을 얻을 수 있습니다.
인증을 완료한 후 인증 정보에서 왼쪽 하단의 위의 두 단계를 완료했습니다를 클릭한 다음 오른쪽 하단의 인증 완료를 클릭하여 설정을 마칩니다. 이로써 Tencent 플랫폼의 데이터 통합이 완료됩니다.
4. 데이터 저장
4.1 저장 규칙
- 데이터의 start_date 필드, 즉 데이터의 집계 시간을 이벤트의 #event_time으로 사용합니다
- 기본 이벤트 이름: tencent_ads_daily_report
- 나머지 필드는 모두 저장됩니다
4.2 표준화 필드
Tencent 일간 리포트 데이터의 일부 필드는 AE 시스템에서 표준화 처리합니다:
| 원본 필드 | 표준화 | 설명 |
|---|---|---|
| campaign_name | te_ads_object.campaign_name | 캠페인 이름 |
| campaign_id | te_ads_object.campaign_id | 캠페인 ID |
| adgroup_name | te_ads_object.ad_group_name | 광고 그룹 이름 |
| adgroup_id | te_ads_object.ad_group_id | 광고 그룹 ID |
| ad_name | te_ads_object.ad_name | 광고 이름 |
| ad_id | te_ads_object.ad_id | 광고 ID |
| account_id | te_ads_object.account_id | 광고 계정 ID |
| view_count | te_ads_object.impressions | 노출 수 |
| valid_click_count | te_ads_object.clicks | 클릭 수 |
| cost | te_ads_object.cost | 비용 |
| install_count | te_ads_object.installs | APP 설치 수 |