vivo 마케팅 플랫폼 통합 계획
서드파티 데이터 통합으로 생성된 데이터는 클러스터의 소비 데이터양에 포함됩니다
개요
인터페이스 소개
| 인터페이스명 | 타입 | 세분화 | 어트리뷰션 | 비용 | 수익 | 노출 | 클릭 | 전환 |
|---|---|---|---|---|---|---|---|---|
| 광고 효과 데이터 | API | 집계 지표 | ✅ | ✅ | ✅ | ✅ |
현재 AE는 vivo 마케팅 플랫폼 Marketing API의 광고 효과 데이터 연동을 지원하며, 광고 크리에이티브 수준의 비용, 클릭, 노출 등 집계 지표 데이터를 가져올 수 있습니다
통합 절차
- AE 백엔드에 로그인하여 서드파티 통합 모듈로 이동한 후 vivo 통합 계획을 추가하고 관련 설정을 완료한 다음 인증 콜백 주소를 복사합니다
- vivo 개발자 백엔드에 로그인하여 개발자 계정을 얻고 앱을 생성한 후 필요한 인증 정보를 수집합니다
- AE 백엔드로 돌아와 앞서 만든 vivo 통합 계획을 수정하여 앱의 Client ID와 secret을 입력하고, 인증 링크를 열어 인증을 완료합니다
- AE 시스템이 데이터를 정상적으로 수신했는지 확인하고 리포트를 구축합니다
1. 통합 방안 설정
vivo 플랫폼 데이터를 연동하기 전에 먼저 AE 백엔드에서 해당 통합 계획을 생성하고 인증 콜백 주소를 가져와야 합니다. 이 문서에 따라 통합 계획을 생성할 수 있습니다
1.1 임시 인증 정보 입력
먼저 인증 정보 영역의 인증 정보 설정 버튼을 클릭하고, 표시되는 인증 정보 팝업에서 인증 정보의 세 항목을 임의로 입력하여 임시 인증 정보로 사용합니다. 이후 vivo 플랫폼에서 앱 생성을 마친 후 다시 조정해야 합니다.
1.2 동기화
동기화 모듈에서 AE 시스템이 vivo Marketing API 데이터를 정기적으로 수집하는 정책을 설정할 수 있으며, 매일 특정 시각에 일정 기간의 데이터를 수집하도록 선택할 수 있습니다. 수집한 데이터도 데이터양에 포함되므로 너무 긴 기간의 데이터를 정기적으로 수집하지 않는 것을 권장합니다
1.3 저장 설정
데이터를 이벤트 형태로 기록할지 제어할 수 있습니다. 끄면 데이터가 이벤트 테이블에 기록되지 않으므로 이 설정을 끄지 마십시오.
1.4 통합 설정
마지막으로 통합 설정 모듈에서 데이터 수집의 세부 설정을 제어할 수 있습니다. 데이터의 시간 집계 단위, 수집할 지표 필드와 차원, 저장 후 이벤트 이름 등이 포함됩니다.
통합 설정의 내용은 JSON이며, 다음 내용에 따라 커스텀 설정할 수 있습니다:
| 모듈 | 이름 | 의미 |
|---|---|---|
| sink_event | event_name | 저장 후 이벤트 이름, 커스텀 가능 |
| source | time_granularity | 데이터의 시간 집계 단위, 즉 수집한 데이터를 일 단위로 집계할지 시간 단위로 집계할지 지정합니다 선택 가능한 값: DAY, HOUR |
| report_types | 데이터 수준. 데이터 수준은 하나만 선택할 수 있습니다 선택 가능한 값: ACCOUNT(계정 수준), CAMPAIGN(캠페인 수준), GROUP(광고 그룹 수준), ADVERTISEMENT(광고 수준), CREATIVE(크리에이티브 수준, 기본 수준) |
1.5 인증 콜백 주소 가져오기
위 설정을 완료한 후 오른쪽 상단의 저장 및 인증을 클릭하여 인증 정보를 가져옵니다. 첫 번째 단계의 인증 콜백 주소를 복사하여 잘 보관하십시오. 그런 다음 권한 부여 안 함을 클릭하여 팝업 창을 닫습니다:
저장 및 인증을 클릭하면 계획이 이미 저장되므로 따로 저장할 필요가 없습니다. 이로써 AE 백엔드의 설정 작업을 일단 마쳤습니다. 다음으로 vivo 백엔드에서 관련 설정을 완료하십시오.
2. 개발자 계정 얻기 및 앱 생성
AE 백엔드에서 통합 계획 생성을 마친 후에는 vivo 개발자 플랫폼 앱도 준비해야 합니다. 이미 vivo 개발자 앱을 생성했다면 이 절은 건너뛰어도 됩니다
2.1 개발자 계정 얻기
vivo Marketing API를 연동하기 전에 먼저 개발자 계정을 얻어야 합니다. 개발자 공식 사이트로 이동하여 오른쪽 상단의 로그인 버튼을 클릭해 로그인 페이지로 들어간 후, 2차 대리점 계정 또는 광고주 계정의 마케팅 플랫폼 계정으로 로그인합니다.
2.2 앱 신청 및 생성
마케팅 플랫폼 계정으로 로그인하여 개발자가 되면 앱 관리 대시보드로 이동합니다:
오른쪽 상단의 새 앱 버튼을 클릭하여 앱 생성 화면으로 이동합니다:
다음 설명에 따라 설정을 편집하고, 완료되면 제출을 클릭하여 앱을 생성합니다
-
앱 아이콘: 직접 지정할 수 있으며, 250 x 250 px 크기에 50kb 미만인 앱 아이콘입니다.
-
앱 이름: 직접 지정할 수 있으며, 15자를 넘을 수 없습니다
-
콜백 주소: AE 백엔드의 vivo 통합 계획에서 가져온 콜백 주소를 입력합니다
-
앱 소개: 앱이 Marketing API를 기반으로 구현하려는 기능과 해당 기능이 심사를 통과해야 하는 이유를 소개합니다. 광고 인사이트 데이터를 자체 분석 플랫폼으로 전송해야 한다고 설명할 수 있습니다
-
Token 유효 기간:
- Access Token 유효 기간: 이 앱에서 발급하는 access token의 유효 시간
- Refresh Token 유효 기간: 이 앱에서 발급하는 refresh token의 유효 시간으로, access token의 유효 시간보다 길어야 합니다
이후 vivo 심사 담당자가 2-3 영업일 이내에 심사하며, 심사가 완료되면 다음 작업을 진행합니다.
2.3 Client ID 및 Client Secret 가져오기
vivo 개발자 플랫폼으로 돌아가 내 앱 페이지에서 생성한 앱의 clientId와 Secret, 즉 Client ID와 Client Secret을 가져옵니다
2.4 광고 계정 ID 가져오기
마지막으로 데이터를 수집할 광고 계정의 ID도 가져와야 합니다. vivo 마케팅 백엔드에 로그인하여 오른쪽 상단 메뉴의 계정 관리를 클릭하면 계정 센터 섹션의 계정 정보 탭에서 계정 ID 정보를 확인할 수 있습니다.
3. AE 백엔드로 돌아와 인증 완료
vivo 백엔드 설정을 마친 후 AE 백엔드로 돌아와 앞서 생성한 vivo 통합 계획으로 이동하여 인증 정보 영역의 인증 정보 설정 버튼을 클릭합니다:
다음으로 vivo 백엔드에서 가져온 Client ID와 Client Secret을 해당 위치에 입력하고, Advertiser ID에는 이전 단계에서 가져온 광고 계정 ID를 입력합니다. 편집을 마친 후 저장 버튼을 클릭합니다:
이어서 오른쪽 상단의 저장 및 인증을 클릭하여 인증 정보 팝업으로 다시 들어갑니다. 이때 권한 설정으로 이동을 클릭하면 vivo 플랫폼의 인증 페이지가 열립니다
vivo 광고주 계정이 있다면 광고주 계정으로 직접 로그인하는 것을 권장합니다.
인증을 완료한 후 인증 정보에서 왼쪽 하단의 위의 두 단계를 완료했습니다를 클릭한 다음 오른쪽 하단의 인증 완료를 클릭하여 설정을 마칩니다. 이로써 vivo 플랫폼의 데이터 통합이 완료됩니다.
4. 데이터 저장
4.1 저장 규칙
- 크리에이티브 리포트는 집계 데이터이므로 고정값을 유저 식별자로 사용합니다. 모든 데이터가 하나의 가상 유저에 연결되어 있다고 보면 됩니다
- 데이터의 reportdate 또는 reporttime 필드, 즉 데이터 집계 시간을 이벤트의 #event_time으로 사용합니다
- 기본 이벤트 이름: vivo_ads_data
- 나머지 필드는 모두 저장됩니다
4.2 포함 필드
광고 크리에이티브 데이터에서 수집할 수 있는 필드는 다음과 같습니다:
| 필드 이름 | 한국어 이름 및 비고 |
|---|---|
| campaignid | 캠페인 ID |
| campaignname | 캠페인 이름 |
| mediatype | 프로모션 캠페인 타입 |
| groupid | 광고 그룹 ID |
| groupname | 광고 그룹 이름 |
| advertisementid | 광고 ID |
| advertisementname | 광고 이름 |
| creativeid | 크리에이티브 ID |
| placetype | 광고 위치 타입. 자세한 내용은 부록-광고 위치 열거값(광고 리포트) 참고 |
| apppackage | 패키지 이름 |
| cvtype | 전환 타입. 자세한 내용은 부록-광고 그룹 전환 목표 타입 참고 |
| reportdate | 보고 시간. 일 단위로 조회할 때 반환되며, 형식: 20200824 |
| reporttime | 보고 시간. 시간 단위로 조회할 때 반환되며, 형식: 2020-06-28 11:00:00 |
| advertiserid | 광고주 ID |
| showcount | 노출 수 |
| clickcount | 클릭 수 |
| downloadcount | 다운로드 수 |
| spent | 비용 |
| activatecount | 신규 활성화 수 |
| registercount | 게임 가입 수 |
| formsubmitcount | 양식 제출 수 |
| normalactivatecount | 일반 활성화 수 |
| backactivatecount | 커스텀 활성화 수 |
| backregistercount | 커스텀 가입 수 |
| adddesktopcount | 바탕화면 추가 수 |
| customretaincount | 커스텀 다음 날 리텐션 수 |
| gamepaycount | 게임 결제 수 |
| custompaycount | 커스텀 결제 수 |
| reactivation | 커스텀 재활성화 |
| webpay | 웹 구매 |
| gameappointment | 게임 사전 예약 수 |
| buttonclick | 버튼 클릭 수 |
| fastapppay | 퀵 앱 결제 수 |
| personalizedevents | 개인화 이벤트 수 |
| activatec | 신규 활성화 수(과금 시간 기준) |
| backactivatec | 커스텀 활성화 수(과금 시간 기준) |
| registerc | 게임 가입 수(과금 시간 기준) |
| backregisterc | 커스텀 가입 수(과금 시간 기준) |
| adddesktopc | 바탕화면 추가 수(과금 시간 기준) |
| cdownloadcount | 다운로드 수(과금 시간 기준) |
| customretainc | 커스텀 다음 날 리텐션 수(과금 시간 기준) |
| gamepayc | 게임 결제 수(과금 시간 기준) |
| custompayc | 커스텀 결제 수(과금 시간 기준) |
| reactivationc | 커스텀 재활성화(과금 시간 기준) |
| gameappointmentc | 게임 사전 예약 수(과금 시간 기준) |
| firstdayrecoveryadmonetizationc | 첫날 회수 금액-광고 수익화(과금 시간 기준) |
| totalrecoveryadmonetizationc | 누적 회수 금액-광고 수익화(과금 시간 기준) |
| firstdayrecoverypaidrechargec | 첫날 회수 금액-충전 결제(과금 시간 기준) |
| totalrecoverypaidrechargec | 누적 회수 금액-충전 결제(과금 시간 기준) |
| cfastapppay | 퀵 앱 결제 수(과금 시간 기준) |
| cpersonalizedevents | 개인화 이벤트 수(과금 시간 기준) |
| cnormalactivatecount | 일반 활성화 수(과금 시간 기준) |
| ccreditcount | 커스텀 여신 승인 수(과금 시간 기준) |
| cinstalldonecount | 설치 완료 수(과금 시간 기준) |
| wechatgameregisterc | 위챗 미니 게임 가입 수(과금 시간 기준) |
| wechatgamepayc | 위챗 미니 게임 결제 수(과금 시간 기준) |
| creactivationretentioncount | 재활성화 커스텀 다음 날 리텐션 수(과금 시간 기준) |
| creditcount | 커스텀 여신 승인 수(전환 시간 기준) |
| installdonecount | 설치 완료 수(전환 시간 기준) |
| wechatgameregistercount | 위챗 미니 게임 가입 수(전환 시간 기준) |
| wechatgamepaycount | 위챗 미니 게임 결제 수(전환 시간 기준) |
| reactivationretentioncount | 재활성화 커스텀 다음 날 리텐션 수(전환 시간 기준) |
| reservecount | 캘린더 예약 수(전환 시간 기준) |
| identifycodecount | 위챗-QR 코드 인식 수 |
| addwechatmpacount | 위챗-위챗 친구 추가 수 |
| dialoguempacount | 위챗-유저 첫 메시지 수 |
| onedialoguecount | 유효 상담 수 |
| firstdayrecoverypaidcount | 게임 첫날 첫 결제 |
| tacount | 타깃 유저 수(전환 시간 기준) |
| ctacount | 타깃 유저 수(과금 시간 기준) |
| payonetimecount | 앱 결제 횟수(전환 시간 기준) |
| cpayonetimecount | 앱 결제 횟수(과금 시간 기준) |
| payonetimeamount | 앱 결제 금액(전환 시간 기준) 단위는 밀리펀(1/1000펀)이며, 1위안=100000밀리펀 |
| cpayonetimeamount | 앱 결제 금액(과금 시간 기준) 단위는 밀리펀(1/1000펀)이며, 1위안=100000밀리펀 |
4.3 표준화 필드
AE 시스템은 다음 필드를 표준화 처리합니다:
| 원본 필드 | 표준화 필드 | 의미 |
|---|---|---|
| advertiserid | te_ads_object.ad_account_id | 광고 계정 ID |
| campaignid | te_ads_object.campaign_id | 캠페인 ID |
| campaignname | te_ads_object.campaign_name | 캠페인 이름 |
| groupid | te_ads_object.ad_group_id | 광고 그룹 ID |
| groupname | te_ads_object.ad_group_name | 광고 그룹 이름 |
| advertisementid | te_ads_object.ad_id | 광고 크리에이티브 ID |
| advertisementname | te_ads_object.ad_name | 광고 크리에이티브 이름 |
| showcount | te_ads_object.impressions | 노출 수 |
| clickcount | te_ads_object.clicks | 클릭 수 |
| activatecount | te_ads_object.installs | 전환 수 |
| spent | te_ads_object.cost | UA 비용 |