Kuaishou 광고주 데이터
서드파티 데이터 통합으로 생성된 데이터는 클러스터의 소비 데이터양에 포함됩니다
개요
인터페이스 소개
| 인터페이스명 | 타입 | 세분화 | 어트리뷰션 | 비용 | 수익 | 노출 | 클릭 | 전환 |
|---|---|---|---|---|---|---|---|---|
| 광고주 데이터 | API | 집계 지표 | ✅ | ✅ | ✅ | ✅ |
광고주 데이터는 광고주 단위의 각종 지표를 제공하며, 광고 노출, 클릭, 전환, UA 비용 및 기타 다양한 지표가 포함됩니다.
통합 절차
- Kuaishou 개발자 계정을 등록하고 앱을 생성합니다
- AE 백엔드에 로그인하여 서드파티 통합 모듈로 이동한 후 Kuaishou 광고주 데이터 계획을 추가하고 관련 설정을 완료합니다
- AE 백엔드에서 인증 콜백 주소를 가져온 후 Kuaishou 오픈 플랫폼에 로그인하여 이전에 생성한 앱에 해당 콜백 주소를 입력합니다
- AE 백엔드에서 인증 주소를 열어 인증을 완료합니다
- AE 시스템이 데이터를 정상적으로 수신했는지 확인하고 리포트를 구축합니다
1. 인증에 필요한 정보 가져오기
1.1 Kuaishou 개발자 계정 등록
Kuaishou Marketing API를 호출하기 전에 Kuaishou 개발자 계정을 준비해야 합니다. 먼저 Magnetic Engine 오픈 플랫폼에 로그인합니다
다음으로 개발자로 등록을 클릭합니다:
담당자 이름 등을 입력하여 담당자 정보를 완성합니다:
이어서 개발자 자격 정보를 완성해야 합니다. 회사 법인 또는 대리인이 등록을 신청할 수 있으며, 어느 경우든 신청자의 실명 본인 인증이 필요합니다
개발자 역할에서 광고주를 선택해야 합니다
1.2 앱 생성
Kuaishou 개발자 계정 등록을 마친 후 앱 관리에서 새 앱을 생성해야 합니다
앱을 생성할 때 다음 정보를 입력해야 합니다:
- 앱 이름, 앱 아이콘, 앱 설명: 자유롭게 지정할 수 있습니다
- 콜백 주소: 우선 www.thinkingdata.cn을 사용하며, 앱 생성과 AE 플랫폼의 계획 생성을 마친 후 다시 조정해야 합니다
다음으로 아래 그림에서 녹색 상자와 녹색 화살표로 표시된 APP ID와 Secret을 가져와야 합니다
1.3 인증할 계정의 Kuaishou ID 가져오기
마지막으로 광고 데이터를 수집할 Kuaishou 계정의 Kuaishou ID를 가져와야 합니다. 일반적으로 Kuaishou 백엔드의 오른쪽 상단에서 확인할 수 있습니다:
2. 계획 설정
앱을 생성한 후 AE 시스템 백엔드에 로그인하여 서드파티 통합 모듈에서 Kuaishou 광고주 데이터 계획을 설정해야 합니다. 다음은 Kuaishou 광고 데이터의 설정 화면입니다:
2.1 인증 정보 설정
인증 정보 아래의 인증 정보 설정 버튼을 클릭하고, 팝업 창에 인증 작업에서 가져온 정보를 입력합니다
APP ID, Secret, User ID에는 각각 앱 생성 시 얻은 APP ID, Secret, 그리고 인증할 계정의 Kuaishou ID를 입력합니다
Advertiser ID List에는 수집할 광고 계정 ID 목록을 입력하며, 여러 개는 ","로 구분할 수 있습니다. 입력하지 않으면 AE 시스템이 인증된 모든 광고 계정의 데이터를 가져옵니다. 입력하면 AE 시스템은 입력한 광고 계정의 데이터만 가져옵니다
2.2 동기화
동기화 모듈에서 AE 시스템이 Kuaishou 광고주 데이터를 정기적으로 수집하는 전략을 설정할 수 있으며, 매일 특정 시각 또는 매시간 일정 기간의 데이터를 수집하도록 선택할 수 있습니다. 수집한 데이터도 데이터양에 포함되므로 너무 긴 기간의 데이터를 정기 수집하지 않는 것을 권장합니다
2.3 이벤트 테이블 저장 설정
이벤트 테이블 저장 설정 스위치를 켜면 콜백 데이터가 모두 이벤트 테이블에 기록됩니다. 이벤트 데이터 저장을 활성화할 것을 권장합니다.
2.4 통합 설정
마지막으로 통합 설정 모듈에서 데이터 수집의 세부 설정을 제어할 수 있습니다. 여기에는 데이터의 시간 집계 단위, 저장 후 이벤트 이름 등이 포함됩니다.
통합 설정의 내용은 JSON이며, 다음 내용에 따라 커스텀 설정할 수 있습니다:
| 모듈 | 이름 | 의미 |
|---|---|---|
| sink_event | event_name | 저장 후 이벤트 이름. 커스텀 가능, 문자열 타입. 수신한 데이터는 모두 이 이름을 이벤트 이름으로 사용합니다. |
| source | time_granularity | 데이터의 시간 집계 단위. 즉 수집한 데이터를 일 단위로 집계할지 시간 단위로 집계할지 지정 선택 가능한 값: DAILY / HOURLY |
| transfer | double_columns | 지표 필드. 수정하지 마십시오 |
광고주 데이터의 지표에는 다양한 업종(예: 온라인 쇼핑몰, 라이브 커머스 등)의 지표 데이터가 포함됩니다. 아래에는 자주 사용하는 일부 지표만 표시하며, 전체 지표 목록은 광고주 데이터 문서에서 확인할 수 있습니다. 기본적으로 모든 데이터를 저장합니다
- 지표 필드
| 지표 | 설명 |
|---|---|
| charge | 비용(위안) |
| show | 커버 노출 수 |
| photo_click | 커버 클릭 수 |
| aclick | 소재 노출 수 |
| bclick | 행동 수 |
| photo_click_ratio | 커버 클릭률 |
| impression_1k_cost | 1,000회 노출당 평균 비용(위안) |
| photo_click_cost | 평균 클릭 단가(위안) |
| action_cost | 평균 행동 단가(위안) |
| share | 공유 수 |
| comment | 댓글 수 |
| like | 좋아요 수 |
| follow | 신규 팔로우 수 |
| cancel_follow | 팔로우 취소 수 |
| report | 신고 수 |
| block | 차단 수 |
| negative | 이런 콘텐츠 줄이기 수 |
| download_started | 앱 다운로드 데이터-Android 다운로드 시작 수 |
| download_completed | 앱 다운로드 데이터-Android 다운로드 완료 수 |
| activation | 앱 다운로드 데이터-활성화 수 |
| event_pay_first_day | 앱 다운로드 데이터-첫날 결제 횟수 |
| event_pay_purchase_amount_first_day | 앱 다운로드 데이터-첫날 결제 금액 |
| event_pay_first_day_roi | 앱 다운로드 데이터-첫날 ROI |
| event_pay | 앱 다운로드 데이터-결제 횟수 |
| event_pay_purchase_amount | 앱 다운로드 데이터-결제 금액 |
| event_pay_roi | 앱 다운로드 데이터-ROI |
| event_register | 앱 다운로드 데이터-가입 수 |
| event_register_cost | 앱 다운로드 데이터-가입 비용 |
| event_register_ratio | 앱 다운로드 데이터-가입률 |
| event_order_paid | 앱 다운로드 데이터-주문 결제 성공 수 |
| event_order_paid_purchase_amount | 앱 다운로드 데이터-주문 결제 성공 금액 |
| event_order_paid_cost | 앱 다운로드 데이터-건당 주문 결제 비용 |
| played_end | 재생 완료 |
| played_three_seconds | 유효 재생 수 |
| click_1k_cost | 1,000회 소재 노출당 평균 비용(위안) |
| event_button_click | 버튼 클릭 수 |
| event_button_click_cost | 버튼 클릭 비용: 당일 지출 / 버튼 클릭 수 |
| event_button_click_ratio | 버튼 클릭률: 버튼 클릭 수 / 행동 수 |
| play_end_ratio | 재생 완료율 |
| event_watch_app_ad | 광고 시청 |
| event_ad_watch_times | 광고 시청 횟수 |
| event_ad_watch_times_ratio | 광고 시청 횟수 전환율 |
| event_ad_watch_times_cost | 광고 시청 횟수 비용 |
| ad_show | 광고 노출 |
| click_conversion_ratio | 클릭 활성화율 |
| conversion_cost | 활성화 단가 |
| download_completed_cost | Android 다운로드 완료 단가(위안) |
| download_completed_ratio | Android 다운로드 완료율 |
| download_conversion_ratio | 다운로드 완료 대비 활성화율 |
| download_started_cost | Android 다운로드 시작 단가(위안) |
| download_started_ratio | Android 다운로드 시작률 |
| conversion_num | 전환 수(콜백 시간 기준 어트리뷰션) |
| conversion_num_cost | 전환 비용(콜백 시간 기준 어트리뷰션) |
| conversion_ratio | 전환율(콜백 시간 기준 어트리뷰션) |
- 차원 필드
| 차원 | 설명 |
|---|---|
| advertiser_id | 광고 계정 ID |
| campaign_id | 캠페인 ID |
| campaign_name | 캠페인 이름 |
| unit_id | 광고 그룹 ID |
| unit_name | 광고 그룹 이름 |
| creative_id | 광고 소재 ID |
| creative_name | 광고 크리에이티브 이름 |
| status | 1 - 집행 중; 2 - 일시 중지됨; 3 - 삭제됨 |
2.5 이벤트 저장 규칙
- 데이터의 stat_date와 stat_hour 필드, 즉 날짜와 시간을 이어 붙인 값을 데이터의 #event_time으로 사용합니다
- 데이터 이벤트 이름은 -- kuaishou_ads_account_report입니다
- 나머지 필드는 모두 저장됩니다
2.6 인증 완료
설정을 마친 후 오른쪽 상단의 저장 및 인증을 클릭하여 계획 설정을 저장할 수 있습니다. 이어서 마지막 인증 작업을 완료해야 합니다:
먼저 팝업된 인증 정보 페이지에서 첫 번째 단계의 주소를 복사합니다
다음으로 Magnetic Engine 오픈 플랫폼에 로그인하여 이전에 생성한 앱으로 이동한 후, 아래 그림의 콜백 주소란에 인증 콜백 주소를 입력합니다
그런 다음 AE 화면으로 돌아와 권한 설정으로 이동을 클릭하면 Magnetic Engine의 인증 페이지가 열립니다
인증 화면이 표시되면 사용자 기반 인증을 선택하고, 인증 페이지에 표시된 Kuaishou ID가 앞서 AE 시스템에서 설정한 계획의 User ID와 일치하는지 확인합니다. 이어서 이용 약관 동의에 체크한 후 권한 부여 확인을 클릭하여 인증 작업을 완료합니다
2.7 표준화 필드
Kuaishou 광고주 데이터의 일부 필드는 AE 시스템에서 표준화 처리합니다:
| 필드 이름 | 표준화 필드 | 의미 |
|---|---|---|
| advertiser_id | te_ads_object.ad_account_id | 광고주 ID |
| campaign_name | te_ads_object.campaign_name | 캠페인 이름 |
| campaign_id | te_ads_object.campaign_id | 캠페인 ID |
| unit_name | te_ads_object.ad_group_name | 광고 그룹 이름 |
| unit_id | te_ads_object.ad_group_id | 광고 그룹 ID |
| creative_name | te_ads_object.ad_name | 크리에이티브 이름 |
| creative_id | te_ads_object.ad_id | 크리에이티브 ID |
| CNY(고정값) | te_ads_object.currency | 비용 또는 수익의 통화 |
| show | te_ads_object.impressions | 노출 수 |
| photo_click | te_ads_object.clicks | 클릭 수 |
| conversion_num | te_ads_object.installs | 클릭 설치 수 |
| charge | te_ads_object.cost | 총 지출 |