Baidu Marketing 데이터 통합 계획
서드파티 데이터 통합으로 생성된 데이터는 클러스터의 소비 데이터양에 포함됩니다
개요
인터페이스 소개
| 인터페이스명 | 타입 | 세분화 | 어트리뷰션 | 비용 | 수익 | 노출 | 클릭 | 전환 |
|---|---|---|---|---|---|---|---|---|
| 데이터 리포트(검색 광고 계정 리포트) | API | 집계 지표 | ✅ | ✅ | ✅ | ✅ |
현재 AE 시스템은 Baidu Marketing 데이터의 데이터 리포트(검색 광고 계정 리포트) 연동을 지원하며, 광고 계정의 소비, 클릭, 노출, 전환 등의 지표를 가져올 수 있습니다
통합 절차
- AE 백엔드에 로그인하여 서드파티 통합 모듈로 이동한 후 Baidu Marketing 데이터 통합 계획을 추가하고 관련 설정을 완료한 다음 인증 콜백 주소를 복사합니다
- Baidu Marketing 백엔드에서 개발자 인증을 받고 앱을 생성하여 AppID와 secretKey를 가져옵니다
- AE 백엔드로 돌아와 앞서 만든 Baidu Marketing 데이터 통합 계획을 수정하여 앱의 AppID, secretKey와 데이터를 수집할 광고 계정 이름(User Name)을 입력하고, 인증 링크를 열어 인증을 완료합니다
- AE 시스템이 데이터를 정상적으로 수신했는지 확인하고 리포트를 구축합니다
1. 통합 방안 설정
Baidu 데이터 플랫폼을 연동하기 전에 먼저 AE 백엔드에서 해당 통합 계획을 생성하고 인증 콜백 주소를 가져와야 합니다. 이 문서에 따라 통합 계획을 생성하십시오
1.1 임시 인증 정보 입력
먼저 인증 정보 영역의 인증 정보 설정 버튼을 클릭하고, 표시되는 인증 정보 팝업 창에 임시 인증 정보로 아무 값이나 입력합니다. 이후 Baidu 데이터 플랫폼에서 앱 생성을 완료한 후 다시 수정해야 합니다.
1.2 동기화
동기화 모듈에서 AE 시스템이 Baidu Marketing 데이터를 정기적으로 수집하는 정책을 설정할 수 있으며, 매일 특정 시각에 일정 기간의 데이터를 수집하도록 선택할 수 있습니다. 수집한 데이터도 데이터양에 포함되므로 너무 긴 기간의 데이터를 정기적으로 수집하지 않는 것을 권장합니다
1.3 저장 설정
데이터를 이벤트 형태로 기록할지 제어할 수 있습니다. 끄면 데이터가 이벤트 테이블에 기록되지 않으므로 이 설정을 끄지 마십시오.
1.4 통합 설정
마지막으로 통합 설정 모듈에서 데이터 수집의 세부 설정을 제어할 수 있습니다. 데이터의 시간 집계 단위, 수집할 지표 필드와 차원, 저장 후 이벤트 이름 등이 포함됩니다.
통합 설정의 내용은 JSON이며, 다음 내용에 따라 커스텀 설정할 수 있습니다:
| 모듈 | 이름 | 의미 |
|---|---|---|
| sink_event | event_name | 저장 후 이벤트 이름, 커스텀 가능 |
| source | time_granularity | 데이터의 시간 집계 단위, 즉 수집한 데이터를 일 단위로 집계할지 시간 단위로 집계할지 지정합니다 선택 가능한 값: DAY, HOUR |
| group_by | 데이터의 그룹 차원, 리스트 타입, 커스텀 가능 | |
| metrics | 해당 인터페이스의 지표 필드, 리스트 타입, 커스텀 가능 |
- 그룹 차원
다음은 Baidu Marketing 검색 광고 계정 리포트가 지원하는 그룹 차원입니다. 조정이 필요하면 필요한 그룹 차원의 차원명을 source.group_by에 입력하십시오
| 차원명 | 저장 필드명 | 설명 | 비고 | 기본 수집 여부 |
|---|---|---|---|---|
| date | #event_time | 날짜 | 시간 단위별 날짜 형식: DAY: 2021-03-31 HOUR: 2021-03-31 23:00 | 예 |
| userName | username | 계정 | 예 | |
| businessPointId | businesspointid | 광고 비즈니스 ID | 예 | |
| businessPointName | businesspointname | 광고 비즈니스 | 예 | |
| wBudget | wbudget | 예산 | 예 | |
| budgetEfficiency | budgetefficiency | 예산 사용률 | 예 | |
| device | device | 광고 디바이스 | 열거형 값: 0:컴퓨터 1:모바일 디바이스 | 예 |
| marketingTargetEnum | marketingtargetenum | 마케팅 목표 | 열거형 값: 0:웹사이트 링크 1:앱 프로모션 2:매장 프로모션 3:마케팅 이벤트 프로모션 4:전자상거래 스토어 프로모션 5:상품 카탈로그 | 예 |
| targetingType | targetingtype | 구매 방식 | 열거형 값: 0:키워드 6:URL 타기팅 | 예 |
| provinceName | provincename | 성 | 이 차원은 시간 단위를 지원하지 않습니다 | |
| provinceCityName | provincecityname | 도시 | 이 차원은 시간 단위를 지원하지 않습니다 |
- 지표 필드
다음은 Baidu Marketing 검색 광고 계정 리포트가 지원하는 지표 필드입니다. 조정이 필요하면 필요한 지표명을 source.metrics에 입력하십시오. 또한 Baidu Marketing은 다양한 전환 지표를 지원하지만, 전환 지표가 많아 이 목록에는 표시하지 않았습니다. 자세한 내용은 공식 문서를 확인하고, 연동할 지표의 이름을 source.metrics에 입력하십시오
| 이름 | 저장 필드명 | 설명 | 비고 | 기본 수집 여부 |
|---|---|---|---|---|
| impression | impression | 노출 | 예 | |
| click | click | 클릭 | 예 | |
| cost | cost | 소비 | 예 | |
| ctr | ctr | 클릭률 | 예 | |
| cpc | cpc | 평균 클릭 단가 | 예 | |
| topPageViews | toppageviews | 상단 노출 | 예 | |
| topPClicks | toppclicks | 상단 클릭 | 예 | |
| topPay | toppay | 상단 소비 | 예 | |
| topPvWinA | toppvwina | 상단 노출 승률 | '상단 노출 승률'은 '광고 비즈니스'와 상호 배타적이며, 이 지표는 provinceCityName,cityName과 함께 요청할 수 없습니다! 상단 노출 승률=계정 상단 노출/계정의 게재 조건을 충족한 검색 횟수 | |
| topPvWinP | toppvwinp | 상단 노출 승률(정확) | '상단 노출 승률(정확)'은 '광고 비즈니스'와 상호 배타적이며, 이 지표는 provinceCityName,cityName과 함께 요청할 수 없습니다! 상단 노출 승률(정확)=계정의 정확 트리거 상단 노출/계정의 게재 조건&정확 트리거 조건을 충족한 검색 횟수 | |
| topFirstPageViews | topfirstpageviews | 상단 1위 노출 | 예 | |
| topFirstPvWinA | topfirstpvwina | 상단 1위 승률 | '상단 1위 승률'은 '광고 비즈니스'와 상호 배타적입니다 | |
| topFirstPvWinP | topfirstpvwinp | 상단 1위 승률(정확) | '상단 1위 승률(정확)'은 '광고 비즈니스'와 상호 배타적입니다 | |
| ocpcConversionsDetail4 | ocpcconversionsdetail4 | 활성화 유저 수 | 활성화 행동(최초 다운로드·설치 후 앱 실행)을 완료한 유저 수 | 예 |
1.5 인증 콜백 주소 가져오기
위 설정을 완료한 후 오른쪽 상단의 저장 및 인증을 클릭하여 인증 정보를 가져옵니다. 첫 번째 단계의 인증 콜백 주소를 복사하여 잘 보관하십시오. 그런 다음 권한 부여 안 함을 클릭하여 팝업 창을 닫습니다:
저장 및 인증을 클릭하면 계획이 이미 저장되므로 따로 저장할 필요가 없습니다. 이로써 AE 백엔드의 설정 작업을 일단 마쳤습니다. 다음으로 Baidu Marketing 백엔드에서 관련 설정을 완료하십시오.
2. Baidu Marketing 개발자 등록 및 인증 정보 가져오기
2.1 개발자 등록
개발자 권한은 먼저 개발자 등록을 완료한 후 신청할 수 있습니다
2.2 앱 생성 및 AppID, secretKey 가져오기
개발자 권한을 신청하여 승인되면 앱을 생성하고 화면 안내에 따라 관련 정보를 입력하십시오. 콜백 주소에는 AE 시스템에서 가져온 콜백 주소를 입력하십시오.
설정을 완료한 후 심사 제출을 클릭하십시오. Baidu API 담당자의 심사를 통과하면 앱의 appId와 secretKey 필드를 가져올 수 있으며, 개발자는 앱 권한 부여 탭에서 확인할 수 있습니다
3. AE 백엔드로 돌아와 인증 완료
Baidu Marketing 데이터 백엔드의 설정을 완료한 후 AE 백엔드로 돌아와 앞서 생성한 Baidu Marketing 데이터 통합 계획으로 이동하여 인증 정보 영역의 인증 정보 설정 버튼을 클릭합니다:
다음으로 Baidu Marketing 데이터 백엔드에서 가져온 appId와 secretKey를 해당 위치에 입력하고, User Name에 데이터를 수집할 Baidu Marketing 광고 계정 이름을 입력합니다. 편집을 마친 후 저장 버튼을 클릭합니다:
이어서 오른쪽 상단의 저장 및 인증을 클릭하여 인증 정보 팝업 창으로 다시 이동합니다. 여기에서 권한 설정으로 이동을 클릭하면 Baidu Marketing 데이터 플랫폼의 인증 페이지가 열립니다. 계획을 저장했지만 인증을 아직 완료하지 않은 경우, 계획 페이지 상단에 현재 통합 계획의 인증이 완료되지 않아 데이터를 연동할 수 없습니다. 인증을 진행하십시오 알림 배너가 표시되며, 배너의 권한 부여하기를 클릭해도 인증 정보 팝업 창을 열 수 있습니다
데이터를 수집할 Baidu Marketing 데이터 계정으로 로그인하여 다음 페이지에서 인증을 완료하십시오:
인증을 완료한 후 인증 정보에서 왼쪽 하단의 위의 두 단계를 완료했습니다를 클릭한 다음 오른쪽 하단의 인증 완료를 클릭하여 설정을 마칩니다. 이로써 Baidu Marketing 플랫폼의 데이터 통합이 완료됩니다.
4. 데이터 저장
4.1 저장 규칙
- 검색 광고 계정 리포트는 집계 데이터이므로 고정값을 유저 식별자로 사용합니다. 모든 데이터가 하나의 가상 유저에 연결된다고 보면 됩니다
- 데이터의 date 필드, 즉 데이터의 집계 시간을 이벤트의 #event_time으로 사용합니다
- 데이터 이벤트 이름은 baidu_search_account_report입니다
- 나머지 필드는 모두 저장됩니다
4.2 표준화 필드
AE 시스템은 다음 필드를 표준화 처리합니다:
| 원본 필드 | 표준화 필드 | 의미 |
|---|---|---|
| impression | te_ads_object.impressions | 노출 수 |
| click | te_ads_object.clicks | 클릭 수 |
| cost | te_ads_object.cost | 집행 비용 |