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などの認証情報を入力し、関連する設定を完了します
- 「認証情報」ポップアップの認証URLをAzureアプリのリダイレクト URIとして追加し、AE管理画面に戻ってMicrosoftアカウントにログインし、認証を完了します
- AEシステムがデータを正常に受信しているかを確認し、レポートを作成します
1. アプリの登録と認証情報の取得
1.1 アプリの登録とClient ID、Secretの取得
Bing Ads APIでデータを取得する前に、Azureアプリを用意する必要があります。まだAzureアプリを作成していない場合は、この節に従ってアプリを作成してください
- MicrosoftアカウントでAzureプラットフォームにログインします
- 「アプリケーションの登録」をクリックします
- 「アプリケーションの登録」ページでアプリ名（任意）を入力し、「サポートされているアカウントの種類」で「任意の組織ディレクトリ内のアカウント (任意の Azure AD ディレクトリ - マルチテナント) と個人用 Microsoft アカウント (Skype、Xbox など)」オプションを選択して、「登録」をクリックするとアプリの作成が完了します
- アプリの作成が完了したら、「概要」ページの「基本」セクションで、アプリのクライアント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に対応しています。この2つの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の管理画面に移動し、アプリの「概要」ページの「基本」セクションで「リダイレクト URI を追加する」をクリックします。次のページで「プラットフォームを追加」をクリックし、認証URLを「リダイレクト URI」の入力欄に入力して、「構成」、「保存」をクリックすると、コールバックURLの設定が完了します。
コールバックURLの設定が完了したら、AE管理画面に戻り、「認証情報」ポップアップで「認証設定へ」ボタンをクリックします。開いたページで、統合したい広告アカウントに紐づいているMicrosoftアカウントにログインし、認証を完了します。
認証が完了したら、「認証情報」で左下の「以上の2つのステップを完了しました」をクリックし、右下の「認証完了」をクリックして設定を終了します。これで、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 | ユーザー獲得コスト |
| revenue | te_ads_object.revenue | 収益 |