Kwai 통합 계획
서드파티 데이터 통합으로 생성된 데이터는 클러스터의 소비 데이터양에 포함됩니다
개요
인터페이스 소개
| 인터페이스명 | 타입 | 세분화 | 어트리뷰션 | 비용 | 수익 | 노출 | 클릭 | 전환 |
|---|---|---|---|---|---|---|---|---|
| Marketing API | API | 집계 지표 | ✅ | ✅ | ✅ | ✅ |
현재 AE는 Kuaishou의 해외 비즈니스 플랫폼인 Kwai의 광고 크리에이티브 데이터 연동을 지원하며, 광고 크리에이티브 수준의 비용, 클릭, 노출 등 집계 지표 데이터를 가져올 수 있습니다
통합 절차
- AE 백엔드에 로그인하여 서드파티 통합 모듈로 이동한 후 Kwai 통합 계획을 추가하고 관련 설정을 완료한 다음 인증 콜백 주소를 복사합니다
- Kwai 백엔드에서 새 계정을 생성하고, 관리자 계정으로 해당 계정에 개발자 역할을 추가합니다. 개발자 신청을 완료하고 앱을 생성합니다
- AE 백엔드로 돌아와 이전의 Kwai 통합 계획을 수정하여 앱의 Client ID와 secret을 입력하고, 인증 링크를 열어 인증을 완료합니다
- AE 시스템이 데이터를 정상적으로 수신했는지 확인하고 리포트를 구축합니다
1. 통합 방안 설정
Kwai 플랫폼 데이터를 연동하기 전에 먼저 AE 백엔드에서 해당 통합 계획을 생성하고 인증 콜백 주소를 가져와야 합니다. 이 문서에 따라 통합 계획을 생성할 수 있습니다
1.1 임시 인증 정보 입력
먼저 인증 정보 영역의 인증 정보 설정 버튼을 클릭하고, 표시되는 인증 정보 팝업에서 인증 정보의 세 항목을 임의로 입력하여 임시 인증 정보로 사용합니다. 이후 Kwai 플랫폼에서 앱 생성을 마친 후 다시 조정해야 합니다.
1.2 동기화
동기화 모듈에서 AE 시스템이 Kwai Marketing API 데이터를 정기적으로 수집하는 전략을 설정할 수 있으며, 매일 특정 시각에 일정 기간의 데이터를 수집하도록 선택할 수 있습니다. 수집한 데이터도 데이터양에 포함되므로 너무 긴 기간의 데이터를 정기 수집하지 않는 것을 권장합니다
1.3 데이터 수집 시간대
수집할 데이터의 시간대도 설정할 수 있으며, 기본값은 UTC+8입니다
1.4 저장 설정
데이터를 이벤트 형태로 기록할지 제어할 수 있습니다. 끄면 데이터가 이벤트 테이블에 기록되지 않으므로 이 설정을 끄지 마십시오.
1.5 통합 설정
마지막으로 통합 설정 모듈에서 데이터 수집의 세부 설정을 제어할 수 있습니다. 데이터의 시간 집계 단위, 수집할 지표 필드와 차원, 저장 후 이벤트 이름 등이 포함됩니다.
통합 설정의 내용은 JSON이며, 다음 내용에 따라 커스텀 설정할 수 있습니다:
| 모듈 | 이름 | 의미 |
|---|---|---|
| sink_event | event_name | 저장 후 이벤트 이름, 커스텀 가능 |
| source | time_granularity | 데이터의 시간 집계 단위, 즉 수집한 데이터를 일 단위로 집계할지 시간 단위로 집계할지 여부 선택 가능한 값: day, hour |
| transfer | double_columns | 지표 필드. 수정하지 마십시오 |
1.6 인증 콜백 주소 가져오기
위 설정을 완료한 후 오른쪽 상단의 저장 및 인증을 클릭하여 인증 정보를 가져옵니다. 첫 번째 단계의 인증 콜백 주소를 복사하여 잘 보관하십시오. 그런 다음 권한 부여 안 함을 클릭하여 팝업 창을 닫습니다:
저장 및 인증을 클릭하면 계획이 이미 저장되므로 따로 저장할 필요가 없습니다. 이로써 AE 백엔드의 설정 작업이 일단 완료되었으며, 이어서 Kwai 백엔드에서 관련 설정을 완료하십시오.
2. Kwai 플랫폼의 개발자 계정 및 앱 생성
2.1 개발자 역할 계정 생성
Kwai 플랫폼에서는 현재 개발자가 아닌 역할(예: 옵티마이저 역할)의 계정을 개발자 역할로 전환할 수 없고, 개발자 역할 계정도 개발자가 아닌 역할로 전환할 수 없습니다. 따라서 새 계정을 생성하여 개발자 역할로 설정해야 합니다. 구체적인 절차는 다음과 같습니다:
- 먼저 Kwai 백엔드 페이지로 이동하여 회원가입을 클릭하고 새 계정을 생성합니다(회사 이메일로 가입하고 계정과 비밀번호를 안전하게 보관할 것을 권장합니다).
- 관리자 계정으로 Business Center에 로그인하여 Permission Management 페이지로 이동한 후 Add Member를 클릭합니다
- Add Member 페이지에서 구성원 이름을 입력하고, Bind Email에는 첫 번째 단계에서 새 계정을 가입할 때 사용한 이메일을 입력합니다. Select Team에서는 관리자가 속한 팀과 같은 옵션을 선택하고, Select Role에서는 Developer를 선택합니다. 설정을 마치면 앞서 생성한 새 계정에 개발자 역할이 부여됩니다.
2.2 개발자 권한 신청
개발자 역할 계정으로 Business Center에 로그인하여 개발자를 신청하고 앱을 생성합니다
- APP Name: 앱 이름이며, 자유롭게 지정할 수 있습니다
- Callback URL: 인증 콜백 주소, 즉 1.6절에서 얻은 주소를 여기에 입력하십시오
2.3 인증 완료
개발자 심사를 통과하면 APP List에서 앞서 생성한 앱을 확인할 수 있습니다
앱을 클릭하면 앱의 기본 정보를 확인할 수 있습니다. CLIENT ID와 Secret을 복사하십시오
3. AE 백엔드로 돌아와 인증 완료
Kwai 백엔드 설정을 마친 후 AE 백엔드로 돌아와 앞서 생성한 Kwai 통합 계획으로 이동하여 인증 정보 아래의 인증 정보 설정 버튼을 클릭합니다:
다음으로 Kwai 백엔드에서 가져온 CLIENT ID와 Secret을 해당 위치에 입력하고, Account ID List에는 데이터를 수집할 Kwai 광고 플랫폼 계정 ID를 입력합니다. 여러 ID는 ","로 구분합니다. 편집을 마친 후 저장 버튼을 클릭합니다:
이어서 오른쪽 상단의 저장 및 인증을 클릭하여 인증 정보 팝업으로 다시 들어갑니다. 이때 권한 설정으로 이동을 클릭하면 Kwai 플랫폼의 인증 페이지가 열리며, Kwai 플랫폼 광고 계정으로 로그인하여 인증을 완료하십시오. 계획이 저장되었지만 아직 인증을 완료하지 않은 경우 계획 페이지 상단에 현재 플랜의 권한 설정이 완료되지 않아 데이터를 연동할 수 없습니다. 권한 설정 페이지로 이동해 주세요. 알림 바가 표시되며, 그 안의 권한 부여하기를 클릭해도 인증 정보 팝업을 열 수 있습니다
인증을 완료한 후 인증 정보에서 왼쪽 하단의 위의 두 단계를 완료했습니다를 클릭한 다음 오른쪽 하단의 인증 완료를 클릭하여 설정을 마칩니다. 이로써 Kwai 플랫폼의 데이터 통합이 완료됩니다.
4. 데이터 저장
4.1 저장 규칙
- 크리에이티브 리포트는 집계 데이터이므로 고정값을 유저 식별자로 사용합니다. 모든 데이터가 하나의 가상 유저에 연결되어 있다고 보면 됩니다
- 데이터의 time 필드, 즉 데이터 시간을 이벤트의 #event_time으로 사용합니다
- 기본 이벤트 이름: kwai_ads_creative_report
- 나머지 필드는 모두 저장됩니다
4.2 포함 필드
광고 크리에이티브 데이터에서 수집할 수 있는 필드는 다음과 같습니다:
| 필드 이름 | 한국어 이름 및 비고 |
|---|---|
| time | 타임스탬프(시간 타입으로 변환) |
| #zone_offset | 시간대(timeZoneIana에서 추출) |
| accountid | 광고 계정 ID |
| accountname | 광고 계정 이름 |
| campaignid | 캠페인 ID |
| campaignname | 캠페인 이름 |
| unitid | 광고 그룹 ID |
| unitname | 광고 그룹 이름 |
| creativeid | 광고 크리에이티브 ID |
| creativename | 광고 크리에이티브 이름 |
| id | 광고 크리에이티브 ID |
| cost | 지출. 통화는 해당 계정의 광고 플랫폼 통화와 같습니다. 값은 6자리 정밀도이며, 실제 금액은 cost를 1000000으로 나눈 값입니다 예: 집행 통화가 미국 달러인 경우 실제 지출 = cost / 1000000(미국 달러) 주: AE 시스템은 cost 필드를 처리하지 않지만, 표준화 필드 te_ads_object.cost는 1000000으로 나눕니다 |
| exposure | 노출 수 |
| click | 클릭 수 |
| action | 전환 수 |
| cpm | 1,000회 노출당 지출. 통화는 해당 계정의 광고 플랫폼 통화와 같습니다. |
| cpc | 클릭당 비용. 통화는 해당 계정의 광고 플랫폼 통화와 같습니다. |
| ctr | 클릭률 |
| cvr | 전환율 |
| cpa | 평균 전환 비용. 통화는 해당 계정의 광고 플랫폼 통화와 같습니다. |
| play3s | 3초 재생 수 |
| play5s | 5초 재생 수 |
| playfinished | 재생 완료 수 |
| registration | 광고주가 콜백한 가입 수. 해당 계정의 광고 플랫폼 데이터와 일치합니다. |
| costperregistration | 광고주가 콜백한 가입 전환 비용. 해당 계정의 광고 플랫폼 데이터와 일치합니다. |
| registrationrate | 광고주가 콜백한 가입 전환율. 해당 계정의 광고 플랫폼 데이터와 일치합니다. |
| addtocart | 광고주가 콜백한 장바구니 추가 수. 해당 계정의 광고 플랫폼 데이터와 일치합니다. |
| costperaddtocart | 광고주가 콜백한 장바구니 추가 전환 비용. 해당 계정의 광고 플랫폼 데이터와 일치합니다. |
| addtocartrate | 광고주가 콜백한 장바구니 추가 전환율. 해당 계정의 광고 플랫폼 데이터와 일치합니다. |
| applaunch | 광고주가 콜백한 앱 실행 수. 해당 계정의 광고 플랫폼 데이터와 일치합니다. |
| costperapplaunch | 광고주가 콜백한 앱 실행 전환 비용. 해당 계정의 광고 플랫폼 데이터와 일치합니다. |
| applaunchrate | 광고주가 콜백한 앱 실행 전환율. 해당 계정의 광고 플랫폼 데이터와 일치합니다. |
| activation | 광고주가 콜백한 활성화 수. 해당 계정의 광고 플랫폼 데이터와 일치합니다. |
| costperactivation | 광고주가 콜백한 활성화 전환 비용. 해당 계정의 광고 플랫폼 데이터와 일치합니다. |
| activationrate | 광고주가 콜백한 활성화 전환율. 해당 계정의 광고 플랫폼 데이터와 일치합니다. |
| pageview | 광고주가 콜백한 페이지 조회 수. 해당 계정의 광고 플랫폼 데이터와 일치합니다. |
| costperpageview | 광고주가 콜백한 페이지 조회 전환 비용. 해당 계정의 광고 플랫폼 데이터와 일치합니다. |
| pageviewrate | 광고주가 콜백한 페이지 조회 전환율. 해당 계정의 광고 플랫폼 데이터와 일치합니다. |
4.3 표준화 필드
AE 시스템은 다음 필드를 표준화 처리합니다:
| 원본 필드 | 표준화 필드 | 의미 |
|---|---|---|
| accountid | te_ads_object.ad_account_id | 광고 계정 ID |
| campaignid | te_ads_object.campaign_id | 캠페인 ID |
| campaignname | te_ads_object.campaign_name | 캠페인 이름 |
| unitid | te_ads_object.ad_group_id | 광고 그룹 ID |
| unitname | te_ads_object.ad_group_name | 광고 그룹 이름 |
| creativeid | te_ads_object.ad_id | 광고 크리에이티브 ID |
| creativename | te_ads_object.ad_name | 광고 크리에이티브 이름 |
| exposure | te_ads_object.impressions | 노출 수 |
| click | te_ads_object.clicks | 클릭 수 |
| action | te_ads_object.installs | 전환 수 |
| cost | te_ads_object.cost | UA 비용 |