Kuaishou 광고 데이터 연동 솔루션

최근 업데이트 2026. 10. 07.

최종 업데이트 날짜: 2022-07-27

1. 통합 계획 소개

팁

서드파티 데이터 통합으로 생성된 데이터는 클러스터의 소비 데이터양에 포함됩니다

개요

이 문서에서는 Kuaishou Magnetic Engine 광고 데이터를 Agentic Engine(이하 AE 시스템)으로 콜백하는 방법을 소개합니다. 이 계획은 다음을 지원합니다:

Kuaishou Marketing API로 집계 지표 데이터를 콜백하며, 노출, 클릭, 설치, 비용, 전환 지표를 포함합니다

Kuaishou 광고 데이터 연동을 시작하기 전에 AE 시스템의 데이터 규칙을 읽고 AE의 데이터 구조를 이해했는지 확인하십시오. 또한 데이터 수집에 필요한 정보를 저희 고객 성공 매니저에게 전달하는 것을 권장합니다. 형식은 데이터 연동 설정 정보 템플릿을 참고하십시오.

절차

Kuaishou 개발자 계정을 등록하고 앱을 생성합니다
ThinkingAI 담당자에게 Kuaishou 앱의 APP_ID와 연동할 AE 프로젝트의 APP ID를 제공합니다. ThinkingAI 담당자가 콜백 링크를 제공하면 이 링크를 Kuaishou 앱의 콜백 링크로 설정합니다
ThinkingAI 담당자가 제공한 인증 주소를 열어 인증을 완료합니다
데이터 수집 방식을 확정합니다:
1. 광고주 데이터
2. 광고 크리에이티브 데이터(커스텀)
3. 프로그래매틱 크리에이티브 2.0 데이터
4. 트래픽 부스트 주문 데이터
수집할 데이터 차원, 지표 타입, 수집 빈도 및 수집 기간을 확정합니다
ThinkingAI 담당자가 데이터 수집 개발 작업을 완료합니다
AE 백엔드에서 대시보드와 리포트를 구축하고 데이터 검증을 완료합니다

2. 통합 전 준비 작업

2.1 Kuaishou 개발자 계정 등록

Kuaishou Marketing API를 호출하기 전에 Kuaishou 개발자 계정을 준비해야 합니다. Kuaishou 공식 문서의 절차에 따라 개발자 계정 등록을 완료하는 것을 권장합니다.

2.2 콜백 주소 설정 및 인증 완료

Kuaishou 개발자 계정 등록을 마친 후 앱 관리에서 앱 정보를 입력하여 해당 앱을 생성해야 합니다
앱 정보에는 인증 콜백 링크가 포함됩니다. 앱을 신청한 후 Kuaishou에서 반환한 앱 app_id와 연동할 AE 프로젝트의 APP ID를 ThinkingAI 담당자에게 제공해야 합니다. ThinkingAI 담당자가 콜백 링크를 제공하면 이 주소를 Kuaishou 앱 관리의 해당 위치에 입력하십시오.
설정을 마치면 ThinkingAI 담당자가 인증 링크를 제공합니다. 인증 링크를 클릭하면 다음 페이지가 표시됩니다. 여기에 표시된 Kuaishou ID를 기록하여 ThinkingAI 담당자에게 제공하십시오. 이어서 사용자 기반 인증을 클릭하고 이용 약관 동의에 체크한 후 권한 부여 확인을 클릭하여 인증 작업을 완료합니다

3. 데이터 수집

Kuaishou Marketing API는 다양한 데이터 타입을 제공하며, 현재 AE 시스템이 지원하는 데이터 타입은 다음과 같습니다:

광고주 데이터
광고 크리에이티브 데이터(커스텀)
프로그래매틱 크리에이티브 2.0 데이터
트래픽 부스트 주문 데이터

3.1 광고주 데이터

인터페이스 기본 정보

인터페이스명	API 타입	제품화	데이터 세분화	어트리뷰션 데이터	비용 데이터	수익 데이터	노출 데이터	클릭 데이터	전환 데이터
광고주 데이터	풀 방식	아니요	집계 데이터		예		예	예	예

3.1.1 인터페이스 파라미터

광고주 계정:
- 데이터를 수집할 광고주 계정 ID를 지정해야 합니다
시간:
- 일 단위 또는 시간 단위의 데이터
- 지표의 시간 단위는 일 단위 또는 시간 단위 중에서 선택할 수 있습니다

3.1.2 포함 필드

광고주 데이터의 지표에는 다양한 업종(예: 온라인 쇼핑몰, 라이브 커머스 등)의 지표 데이터가 포함됩니다. 이 절에서는 자주 사용하는 일부 지표만 소개하며, 전체 지표 목록은 광고주 데이터 문서에서 확인할 수 있습니다:

지표 필드

지표	설명
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 - 삭제됨

3.1.3 저장 규칙

기본적으로 수집한 데이터는 이벤트 형태로 AE 프로젝트에 기록됩니다:

광고주 데이터는 집계 데이터이므로 고정값을 유저 식별자로 사용합니다. 모든 데이터가 하나의 가상 유저에 연결되어 있다고 보면 됩니다
데이터의 stat_date와 stat_hour 필드, 즉 날짜와 시간을 이어 붙인 값을 데이터의 #event_time으로 사용합니다
데이터 이벤트 이름은 -- kuaishou_ads_account_report입니다
나머지 필드는 모두 저장됩니다

3.2 광고 크리에이티브 데이터(커스텀)

인터페이스 기본 정보

인터페이스명	API 타입	제품화	데이터 세분화	어트리뷰션 데이터	비용 데이터	수익 데이터	노출 데이터	클릭 데이터	전환 데이터
광고 크리에이티브 데이터(커스텀)	풀 방식	아니요	집계 데이터		예		예	예	예

Magnetic Engine 백엔드에서 크리에이티브 제작 방식이 커스텀인 광고를 설정한 경우 이 인터페이스로 데이터를 가져올 수 있습니다:

3.2.1 인터페이스 파라미터

광고주 계정:
- 데이터를 수집할 광고주 계정 ID를 지정해야 합니다
시간:
- 일 단위 또는 시간 단위의 데이터
- 지표의 시간 단위는 일 단위 또는 시간 단위 중에서 선택할 수 있습니다

3.2.2 포함 필드

광고 크리에이티브 데이터의 지표에는 다양한 업종(예: 온라인 쇼핑몰, 라이브 커머스 등)의 지표 데이터가 포함됩니다. 이 절에서는 자주 사용하는 일부 지표만 소개하며, 전체 지표 목록은 광고 크리에이티브 데이터-커스텀 문서에서 확인할 수 있습니다:

지표 필드

지표	설명
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	앱 다운로드 데이터-건당 주문 결제 비용
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 - 삭제됨

3.2.3 저장 규칙

기본적으로 수집한 데이터는 이벤트 형태로 AE 프로젝트에 기록됩니다:

광고 크리에이티브 데이터는 집계 데이터이므로 고정값을 유저 식별자로 사용합니다. 모든 데이터가 하나의 가상 유저에 연결되어 있다고 보면 됩니다
데이터의 stat_date와 stat_hour 필드, 즉 날짜와 시간을 이어 붙인 값을 데이터의 #event_time으로 사용합니다
데이터 이벤트 이름은 -- kuaishou_ads_creative_report입니다
나머지 필드는 모두 저장됩니다

3.3 프로그래매틱 크리에이티브 2.0 데이터

인터페이스 기본 정보

인터페이스명	API 타입	제품화	데이터 세분화	어트리뷰션 데이터	비용 데이터	수익 데이터	노출 데이터	클릭 데이터	전환 데이터
프로그래매틱 크리에이티브 2.0 데이터	풀 방식	아니요	집계 데이터		예		예	예	예

Magnetic Engine 백엔드에서 크리에이티브 제작 방식이 프로그래매틱 크리에이티브인 광고를 설정한 경우 이 인터페이스로 데이터를 가져올 수 있습니다:

3.3.1 인터페이스 파라미터

광고주 계정:
- 데이터를 수집할 광고주 계정 ID를 지정해야 합니다
시간:
- 시간 단위까지 지정한 기간의 데이터
- 지표의 시간 단위는 일 단위 또는 시간 단위 중에서 선택할 수 있습니다

3.3.2 포함 필드

프로그래매틱 크리에이티브 데이터의 지표에는 다양한 업종(예: 온라인 쇼핑몰, 라이브 커머스 등)의 지표 데이터가 포함됩니다. 이 절에서는 자주 사용하는 일부 지표만 소개하며, 전체 지표 목록은 프로그래매틱 크리에이티브 2.0 데이터 문서에서 확인할 수 있습니다:

지표 필드

지표	설명
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	전환율(콜백 시간 기준 어트리뷰션)

차원 필드

차원	설명
campaign_id	캠페인 ID
campaign_name	캠페인 이름
unit_id	광고 그룹 ID
unit_name	광고 그룹 이름
creative_id	크리에이티브 ID
photo_url	동영상 링크
photo_id	동영상 ID
image_token	커버 ID
cover_url	커버 링크
description	콘텐츠 광고 문구
pic_id	이미지 라이브러리 이미지 ID
pic_list	Union 이미지(가로형/세로형)
pic_url_list	Union 이미지 URL(가로형/세로형)

3.3.3 저장 규칙

기본적으로 수집한 데이터는 이벤트 형태로 AE 프로젝트에 기록됩니다:

프로그래매틱 크리에이티브 2.0 데이터는 집계 데이터이므로 고정값을 유저 식별자로 사용합니다. 모든 데이터가 하나의 가상 유저에 연결되어 있다고 보면 됩니다
데이터의 stat_date와 stat_hour 필드, 즉 날짜와 시간을 이어 붙인 값을 데이터의 #event_time으로 사용합니다
데이터 이벤트 이름은 -- kuaishou_ads_program_creative_report입니다
나머지 필드는 모두 저장됩니다

3.4 트래픽 부스트 주문 데이터

인터페이스 기본 정보

인터페이스명	API 타입	제품화	데이터 세분화	어트리뷰션 데이터	비용 데이터	수익 데이터	노출 데이터	클릭 데이터	전환 데이터
트래픽 부스트 주문 데이터	풀 방식	아니요	집계 데이터		예		예	예	예

트래픽 부스트 데이터는 지난 30일 동안 생성된 트래픽 부스트 주문의 어제 소비 현황을 가져옵니다

3.4.1 인터페이스 파라미터

광고주 계정:
- 데이터를 수집할 광고주 계정 ID를 지정해야 합니다

3.4.2 포함 필드

트래픽 부스트 데이터의 지표와 분석 차원은 고정되어 있으며, 전체 필드는 다음과 같습니다:

지표 필드

지표	설명
amount	금액
consume_amount	소비 금액
view	커버 노출 수
play	재생 수
action	행동 수
conversion	활성화 수
play_percent	커버 클릭률
action_percent	행동률
cpm	cpm
cpc_of_action	평균 행동 단가
cpa	활성화 단가

차원 필드

차원	설명
supplement_order_id	부스트 주문 ID
task_id	작업 ID
order_id	Juxing 주문 ID
star_user_id	크리에이터 ID
account_id	account_id
unit_ids	unit_id
star_name	크리에이터 이름
status	상태
promotion_begin_time	프로모션 시작 시간
promotion_end_time	프로모션 종료 시간
target_type	타기팅 오디언스 타입
unit_type	최적화 목표/게재 목표
unit_price	입찰가/목표 비용
supplement_order_sense_id	광고 지면
android_app_name	Android 앱 이름
package_name	Android 앱 패키지명

3.4.3 저장 규칙

기본적으로 수집한 데이터는 이벤트 형태로 AE 프로젝트에 기록됩니다:

트래픽 부스트 주문의 게재 후 데이터는 집계 데이터이므로 고정값을 유저 식별자로 사용합니다. 모든 데이터가 하나의 가상 유저에 연결되어 있다고 보면 됩니다
어제 날짜(즉 'YYYY-MM-DD 00:00:00')를 데이터의 #event_time으로 사용합니다
데이터 이벤트 이름은 kuaishou_ads_supplement_report입니다
나머지 필드는 모두 저장됩니다

4. 데이터 연동 설정 정보 템플릿

위 문서를 읽은 후 다음 정보 템플릿을 작성하여 ThinkingAI의 고객 성공 매니저에게 보내는 것을 권장합니다:

데이터 인터페이스: Kuaishou Magnetic Engine Marketing API
---------
회사 이름: XXX
AE 프로젝트 환경: (SAAS/프라이빗 배포)
AE 프로젝트 이름: XXX
AE 프로젝트 APP ID: XXX
---------
Magnetic Engine 앱 관리 페이지의 APP_ID 및 secret: XXX
부스트 인터페이스에서 필터링할 앱 패키지명: xxx
---------
수집할 데이터 타입: (광고주/커스텀 광고 크리에이티브/프로그래매틱 크리에이티브 2.0/트래픽 부스트 주문의 게재 후 데이터)
데이터를 수집할 광고주(광고 계정) ID 목록: XXX, XXX
수집할 필드: XXX, XXX
과거 데이터 수집 기간: yyyy/mm/dd - yyyy/mm/dd
정기 수집: 매일 X시에 전날 데이터 수집

5. 데이터 검증 및 활용

이벤트 분석에서 다음 이벤트(데이터 세트)를 분석할 수 있습니다:

kuaishou_ads_account_report
kuaishou_ads_creative_report
kuaishou_ads_program_creative_report
kuaishou_ads_supplement_report

이 문서가 도움이 되었나요?

1. 통합 계획 소개​

개요​

절차​

2. 통합 전 준비 작업​

2.1 Kuaishou 개발자 계정 등록​

2.2 콜백 주소 설정 및 인증 완료​

3. 데이터 수집​

3.1 광고주 데이터​

3.1.1 인터페이스 파라미터​

3.1.2 포함 필드​

3.1.3 저장 규칙​

3.2 광고 크리에이티브 데이터(커스텀)​

3.2.1 인터페이스 파라미터​

3.2.2 포함 필드​

3.2.3 저장 규칙​

3.3 프로그래매틱 크리에이티브 2.0 데이터​

3.3.1 인터페이스 파라미터​

3.3.2 포함 필드​

3.3.3 저장 규칙​

3.4 트래픽 부스트 주문 데이터​

3.4.1 인터페이스 파라미터​

3.4.2 포함 필드​

3.4.3 저장 규칙​

4. 데이터 연동 설정 정보 템플릿​

5. 데이터 검증 및 활용​

1. 통합 계획 소개

개요

절차

2. 통합 전 준비 작업

2.1 Kuaishou 개발자 계정 등록

2.2 콜백 주소 설정 및 인증 완료

3. 데이터 수집

3.1 광고주 데이터

3.1.1 인터페이스 파라미터

3.1.2 포함 필드

3.1.3 저장 규칙

3.2 광고 크리에이티브 데이터(커스텀)

3.2.1 인터페이스 파라미터

3.2.2 포함 필드

3.2.3 저장 규칙

3.3 프로그래매틱 크리에이티브 2.0 데이터

3.3.1 인터페이스 파라미터

3.3.2 포함 필드

3.3.3 저장 규칙

3.4 트래픽 부스트 주문 데이터

3.4.1 인터페이스 파라미터

3.4.2 포함 필드

3.4.3 저장 규칙

4. 데이터 연동 설정 정보 템플릿

5. 데이터 검증 및 활용