Baidu Marketingデータ統合プラン
サードパーティデータ統合によって生成されたデータは、クラスターの消費データ量に含まれますのでご注意ください
概要
インターフェースの概要
| インターフェース名 | タイプ | 粒度 | アトリビューション | コスト | 収益 | 表示 | クリック | コンバージョン |
|---|---|---|---|---|---|---|---|---|
| データレポート（検索広告アカウントレポート） | API | 集約指標 | ✅ | ✅ | ✅ | ✅ |
現在、AEシステムはBaidu Marketingデータの「データレポート」（検索広告アカウントレポート）の統合に対応しており、広告アカウントの消化額、クリック、表示、コンバージョンなどの指標を取得できます
統合の流れ
- AE管理画面にログインし、「サードパーティ統合」モジュールでBaidu Marketingデータ統合プランを追加して関連する設定を完了し、認証用のポストバックURLをコピーします
- Baidu Marketingの管理画面で開発者認定を受け、アプリを作成してAppIDとsecretKeyを取得します
- AE管理画面に戻り、先ほどのBaidu Marketingデータ統合プランを編集して、アプリのAppID、secretKey、およびデータを取得する広告アカウント名（User Name）を使用し、認証リンクを開いて認証を完了します
- AEシステムがデータを正常に受信しているかを確認し、レポートを作成します
1. プランの設定
Baiduのデータプラットフォームと統合する前に、まずAE管理画面で対応する統合プランを作成し、認証用のポストバックURLを取得する必要があります。本ドキュメントに従って統合プランを作成してください
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:EC店舗プロモーション 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 | 上部枠の最上位表示 | はい | |
| topFirstPvWinA | topfirstpvwina | 上部最上位の獲得率 | 【上部最上位の獲得率】は【プロモーション業務】と排他 | |
| topFirstPvWinP | topfirstpvwinp | 上部最上位の獲得率（完全一致) | 【上部最上位の獲得率（完全一致)】は【プロモーション業務】と排他 | |
| ocpcConversionsDetail4 | ocpcconversionsdetail4 | 有効ユーザー数 | アクティベーション（初回のダウンロード、インストール、アプリ起動）を完了したユーザー数 | はい |
1.5 認証用のポストバックURLの取得
上記の設定が完了したら、右上の「保存して許可する」をクリックし、認証情報を取得してください。最初のステップにある認証用のポストバックURLをコピーし、大切に保管してください。その後、「認証保留中」をクリックしてポップアップを閉じます：
「保存して許可する」をクリックした時点でプランは保存されるため、別途保存する必要はありません。これでAE管理画面での設定作業はいったん完了です。次に、Baidu Marketingの管理画面で関連する設定を行ってください。
2. Baidu Marketingの開発者登録と認証情報の取得
2.1 開発者登録
開発者権限を申請するには、まず開発者登録を完了する必要があります
2.2 アプリの作成とAppID、secretKeyの取得
開発者権限を申請して審査に通過したら、アプリを作成し、画面の案内に従って関連情報を入力してください。コールバックURLの欄には、AEシステムで取得したポストバックURLを入力してください。
設定が完了したら「審査に提出」をクリックします。BaiduのAPI担当者の審査を通過すると、アプリのappIdとsecretKeyフィールドを取得できます。開発者は「アプリ認証」タブで確認できます
3. AE管理画面に戻り、認証作業を完了
Baidu Marketingデータの管理画面での設定が完了したら、AE管理画面に戻り、先ほど作成したBaidu Marketingデータ統合プランを開いて、認証情報欄の「認証情報設定」ボタンをクリックします：
次に、Baidu Marketingデータの管理画面で取得したappIdとsecretKeyを該当する箇所に入力し、「User Name」にデータを取得するBaidu Marketingの広告アカウント名を入力します。編集が完了したら、保存ボタンをクリックします：
続いて右上の「保存して許可する」をクリックすると、再度認証情報のポップアップが表示されます。ここで「認証設定へ」をクリックすると、Baidu Marketingデータプラットフォームの認証ページが開きます。プランを保存したものの認証が完了していない場合は、プランページの上部に「現在のプランはまだ承認されておらず、データにアクセスできません。認証に進んでください。」というヒントバーが表示されます。その中の「認証解除」をクリックしても、認証情報のポップアップを開くことができます
データを取得したいBaidu Marketingデータのアカウントにログインし、次のページで認証を完了してください：
認証が完了したら、「認証情報」で左下の「以上の2つのステップを完了しました」をクリックし、右下の「認証完了」をクリックして設定を終了します。これで、Baidu Marketingプラットフォームのデータ統合は完了です。
4. データの格納
4.1 格納ルール
- 検索広告アカウントレポートは集計データであるため、ユーザー識別子として固定値を使用します。すべてのデータが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 | 配信コスト |