Microsoft Advertising 통합 계획
서드파티 데이터 통합으로 생성된 데이터는 클러스터의 소비 데이터양에 포함됩니다
개요
인터페이스 소개
| 인터페이스명 | 타입 | 세분화 | 어트리뷰션 | 비용 | 수익 | 노출 | 클릭 | 전환 |
|---|---|---|---|---|---|---|---|---|
| Bing Ads API | API | 집계 지표 | ✅ | ✅ | ✅ | ✅ | ✅ |
Bing Ads API는 Microsoft Advertising의 광고 API이며, 그중 Reporting API는 다양한 광고 데이터 리포트의 조회 인터페이스를 제공합니다. 현재 AE 시스템은 리포트 타입이 AdPerformanceReport인 데이터의 수집을 지원합니다.
통합 절차
Microsoft Advertising 데이터의 연동 절차는 다음과 같습니다:
- Azure 플랫폼에 로그인하여 앱을 생성하고, 앱의 Client Secret을 생성합니다
- AE 백엔드에 로그인하여 서드파티 통합 모듈로 이동한 후 Microsoft Advertising 계획을 추가하고, Client ID, Client Secret 등의 인증 정보를 입력하여 관련 설정을 완료합니다
- 인증 정보 팝업 창의 인증 주소를 Azure 앱의 리디렉션 URI로 추가한 다음, AE 백엔드로 돌아와 Microsoft 계정으로 로그인하여 인증을 완료합니다
- AE 시스템이 데이터를 정상적으로 수신했는지 확인하고 리포트를 구축합니다
1. 앱 등록 및 인증 정보 가져오기
1.1 앱을 등록하고 Client ID와 Secret 가져오기
Bing Ads API로 데이터를 수집하기 전에 Azure 앱을 준비해야 합니다. 아직 Azure 앱을 생성하지 않았다면 이 절에 따라 앱을 생성하십시오
- Microsoft 계정으로 Azure 플랫폼에 로그인합니다
- 애플리케이션 등록을 클릭합니다
- 애플리케이션 등록 페이지에서 앱 이름(임의 지정)을 입력하고, 지원되는 계정 유형에서 모든 조직 디렉터리(모든 Azure AD 디렉터리 - 다중 테넌트)의 계정 및 개인 Microsoft 계정(예: Skype, Xbox) 옵션을 선택한 후 등록을 클릭하여 앱 생성을 완료합니다
- 앱을 생성한 후 개요 페이지의 Essentials 영역에서 앱의 클라이언트 ID(즉 Client ID)를 확인할 수 있습니다
- 인증서 또는 비밀 추가를 클릭하고 인증서 및 비밀 페이지에서 + 새 클라이언트 암호를 클릭합니다. 설명과 만료 기간(제한 없음)을 입력하면 클라이언트 암호(즉 Client Secret)가 생성됩니다. 페이지를 떠나기 전에 아래 그림의 빨간 상자 안에 있는 암호 값을 복사하여 저장하십시오.
앱을 생성한 후 앱 설정 페이지로 돌아가는 방법을 모르겠다면 Azure 백엔드 상단의 검색창에서 앱 등록 / App Register를 검색하십시오
1.2 Developer Token 가져오기
다음으로 Developer Token도 가져와야 한다면 Microsoft 개발자 포털에 접속하십시오(로그인하지 않은 경우 광고 계정의 Microsoft 계정으로 로그인하십시오). Request Token을 클릭하여 Developer Token을 신청합니다. 신청에 성공하면 Developer Token을 저장하십시오. (다른 사람의 계정을 관리하는 경우 Developer Token을 받기까지 최대 5영업일이 걸릴 수 있습니다)
1.3 광고 계정의 account ID와 customer ID 가져오기
마지막으로 데이터를 수집할 광고 계정의 account ID와 customer ID도 가져와야 합니다. Microsoft 광고 백엔드에 로그인하여 페이지 왼쪽 상단에서 데이터를 수집할 광고 계정으로 전환하면, 브라우저 주소창에서 aid와 cid 파라미터를 확인할 수 있습니다. aid는 광고 계정의 account ID, cid는 광고 계정의 customer ID에 해당하며, 이 두 ID를 저장하십시오.
이로써 Microsoft Advertising 데이터를 통합하기 위한 준비 작업을 모두 마쳤습니다. 지금까지 가져온 인증 정보를 정리하면 다음과 같습니다:
- Client ID
- Client Secret
- Developer Token
- 광고 계정 Account ID
- 광고 계정 Customer ID
2. 계획 설정
Microsoft Advertising 플랫폼에서 준비 작업을 마친 후 AE 시스템에 로그인하여 서드파티 통합 모듈에서 새 계획을 설정할 수 있습니다. 아래 그림은 Microsoft Advertising의 설정 화면입니다. 이 장의 내용에 따라 계획을 생성하십시오
2.1 인증 정보 설정
인증 정보 아래의 인증 정보 설정 버튼을 클릭하고 팝업 창에 이전 단계에서 얻은 정보를 입력합니다:
2.2 동기화
동기화 모듈에서 AE 시스템이 Microsoft Advertising Bing Ads API 데이터를 정기적으로 수집하는 정책을 설정할 수 있으며, 매일 특정 시각에 일정 기간의 데이터를 수집하도록 선택할 수 있습니다. 수집한 데이터도 데이터양에 포함되므로 너무 긴 기간의 데이터를 정기적으로 수집하지 않는 것을 권장합니다
2.3 저장 설정
데이터를 이벤트 형태로 기록할지 제어할 수 있습니다. 끄면 데이터가 이벤트 테이블에 기록되지 않으므로 이 설정을 끄지 마십시오.
2.4 통합 설정
마지막으로 통합 설정 모듈에서 데이터 수집의 세부 설정을 제어할 수 있습니다. 데이터의 시간 집계 단위, 수집할 지표 필드와 차원, 저장 후 이벤트 이름 등이 포함됩니다.
통합 설정의 내용은 JSON이며, 다음 내용에 따라 커스텀 설정할 수 있습니다:
| 모듈 | 이름 | 의미 |
|---|---|---|
| sink_event | event_name | 저장 후 이벤트 이름, 커스텀 가능 |
| source | metrics | 데이터의 지표, 리스트 타입, 커스텀 가능 |
| group_by | 데이터의 그룹 차원, 리스트 타입, 커스텀 가능 |
다음은 AdPerformanceReport에서 사용할 수 있는 필드 중 자주 사용하는 일부입니다. 전체 필드는 Bing Ads API 공식 문서를 참고하십시오:
- 그룹 차원
다음은 자주 사용하는 그룹 차원입니다. 조정이 필요하면 필드명을 source.group_by에 입력하십시오:
| 필드 | 설명 | 기본 여부 |
|---|---|---|
| TimePeriod | 시간 | 예 |
| AccountName | 광고 계정 이름 | 예 |
| AccountNumber | 광고 계정 번호 | 예 |
| AccountId | 광고 계정 ID | 예 |
| AccountStatus | 광고 계정 상태 | |
| CampaignName | Campaign 이름 | 예 |
| CampaignId | Campaign ID | 예 |
| CampaignStatus | Campaign 상태 | |
| CampaignType | Campaign 타입 | 예 |
| AdGroupName | 광고 그룹 이름 | 예 |
| AdGroupId | 광고 그룹 ID | 예 |
| AdGroupStatus | 광고 그룹 상태 | |
| AdTitle | 광고 이름 | 예 |
| AdId | 광고 ID | 예 |
| AdDescription | 광고 설명 1 | |
| AdDescription2 | 광고 설명 2 | |
| AdType | 광고 유형 | 예 |
| AdStatus | 광고 상태 | |
| AdLabels | 광고 라벨 | |
| CurrencyCode | 결제 통화 코드 | 예 |
| AdDistribution | 미디어 채널 타입 | 예 |
| Network | 미디어 채널 | 예 |
| TopVsOther | 노출 위치(게재 위치) | 예 |
| BidMatchType | 입찰 매칭 모드 | |
| CustomerId | 광고 계정의 고객 ID | |
| CustomerName | 광고 계정의 고객 이름 | |
| CustomParameters | 커스텀 파라미터 | |
| DestinationUrl | 대상 URL 주소 | |
| DisplayUrl | 광고 표시 URL | |
| DeliveredMatchType | 광고 노출 매칭 모드 | |
| DeviceType | 디바이스 타입 | 예 |
| Language | 언어 | 예 |
| DeviceOS | 디바이스 OS | 예 |
| Goal | 전환 목표 이벤트 | |
| GoalType | 전환 목표 이벤트 타입 |
- 지표 필드
다음은 자주 사용하는 지표 필드입니다. 조정이 필요하면 지표 필드명을 source.metrics에 입력하십시오:
| 지표 필드 | 설명 | 비고 | 기본 여부 |
|---|---|---|---|
| Impressions | 노출 수 | 예 | |
| Clicks | 클릭 수 | 예 | |
| Ctr | 클릭률 | 예 | |
| AverageCpc | 평균 CPC | 예 | |
| AverageCpm | 평균 CPM | 예 | |
| Spend | 총지출 | 예 | |
| Conversions | 전환 수(지원 중단) |
| |
| ConversionsQualified | 전환 수(신규 버전, 가져오지 못할 수 있음) | ||
| ConversionRate | 전환율 | ||
| Revenue | 수익 | ||
| RevenuePerConversion | 평균 전환 수익 | ||
| CostPerConversion | 평균 전환 비용 | ||
| ReturnOnAdSpend | ROAS | ||
| AllConversions | 총전환 수(지원 중단) |
| |
| AllConversionsQualified | 총전환 수(신규 버전, 가져오지 못할 수 있음) | ||
| AllConversionRate | 총전환율 | ||
| AllRevenue | 총수익 | ||
| AllRevenuePerConversion | 평균 총전환 수익 | ||
| AllCostPerConversion | 평균 총전환 비용 | ||
| AllReturnOnAdSpend | 총 ROAS | ||
| Assists | 보조 전환 | ||
| CostPerAssist | 평균 보조 전환 비용 | ||
| RevenuePerAssist | 평균 보조 전환 수익 | ||
| AbsoluteTopImpressionRatePercent | 최상단 노출률 | 검색 결과 최상단에 노출된 횟수가 총노출에서 차지하는 비율 | |
| TopImpressionRatePercent | 주요 결과 노출률 | 검색 결과에 노출된 횟수가 총노출에서 차지하는 비율 | |
| ViewThroughConversionsQualified | View-Through 전환 수(신규 버전, 가져오지 못할 수 있음) | ||
| ViewThroughConversions | View-Through 전환 수(지원 중단) |
2.5 데이터 저장 규칙
- 데이터의 TimePeriod 필드, 즉 데이터의 날짜를 집계 데이터의 #event_time으로 설정합니다
- 데이터 이벤트 이름은 bing_ads_adperformance입니다
- 나머지 필드는 모두 저장됩니다
2.6 인증 완료
설정을 마친 후 오른쪽 상단의 저장 및 인증을 클릭하여 계획 설정을 저장할 수 있습니다. 이어서 마지막 인증 작업을 완료해야 합니다:
먼저 팝업된 인증 정보 페이지에서 첫 번째 단계의 주소를 복사합니다
다음으로 Azure 백엔드로 이동하여 앱 개요 페이지의 Essentials 영역에서 리디렉션 URI 추가를 클릭합니다. 이어서 새 페이지에서 플랫폼 추가를 클릭하고 인증 주소를 리디렉션 URI 입력란에 입력한 후 구성, 저장을 클릭하여 콜백 주소 설정을 완료합니다.
콜백 주소 설정을 완료한 후 AE 백엔드로 돌아와 인증 정보 팝업 창에서 권한 설정으로 이동 버튼을 클릭하고, 열린 주소에서 연동할 광고 계정에 연결된 Microsoft 계정으로 로그인하여 인증을 완료합니다.
인증을 완료한 후 인증 정보에서 왼쪽 하단의 위의 두 단계를 완료했습니다를 클릭한 다음 오른쪽 하단의 인증 완료를 클릭하여 설정을 마칩니다. 이로써 Microsoft Advertising 데이터 통합이 완료됩니다.
2.7 표준화 필드
Microsoft Advertising Bing Ads API 데이터의 일부 필드는 AE 시스템에서 표준화 처리됩니다:
| 필드 | 표준화 필드 | 의미 |
|---|---|---|
| accountid | te_ads_object.ad_account_id | 광고 계정 ID |
| campaignname | te_ads_object.campaign_name | 캠페인 이름 |
| campaignid | te_ads_object.campaign_id | 캠페인 ID |
| adgroupname | te_ads_object.ad_group_name | 광고 그룹 이름, 수익화 광고의 Unit 이름 |
| adgroupid | te_ads_object.ad_group_id | 광고 그룹 ID, 수익화 광고의 Unit ID |
| adtitle | te_ads_object.ad_name | 광고 이름 |
| adid | te_ads_object.ad_id | 광고 ID |
| topvsother | te_ads_object.placement | 광고 위치 |
| network | te_ads_object.media_source | 미디어 채널 또는 수익화 채널 |
| currencycode | te_ads_object.currency | 비용 또는 수익의 통화 |
| impressions | te_ads_object.impressions | 노출 수 |
| clicks | te_ads_object.clicks | 클릭 수 |
| spend | te_ads_object.cost | UA 비용 |
| revenue | te_ads_object.revenue | 수익 |