Microsoft Advertising Conversion API コネクタ構成ガイド

このコネクタは現在コネクタマーケットプレイスで利用できません。Microsoft Advertising Conversions コネクタを使用するには、Tealium および Microsoft のアカウントマネージャーのサポートが必要です。このコネクタを使用するには、Tealium のアカウントマネージャーに連絡してください。

概要

広告主は Microsoft Advertising Conversion API を使用して、Web およびオフラインのコンバージョンイベントを直接 Microsoft Advertising に送信します。このコネクタは、エンリッチメントされた帰属、信号の回復力、およびプライバシーに焦点を当てた測定を可能にします。

Microsoft Advertising Conversion API は、単独での統合または Microsoft Advertising タグと一緒に使用することができます。デュアルデリバリー構成では、UET タグがリアルタイムのクライアントサイドイベントを送信する一方で、コンバージョン API はクッキーの喪失、JavaScript の制限、またはオフラインコンバージョンの場合に信頼性の高いイベント配信を行います。両方の方法を使用することで、顧客ジャーニー全体を通じてのカバレッジが向上し、冗長性が確保されます。

バッチ制限

このコネクタは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用します。詳細については、バッチアクションを参照してください。リクエストは、次のいずれかのしきい値に達するか、プロファイルが公開されるまでキューに入れられます：

• 最大リクエスト数：1,000
• 最古のリクエストからの最大時間：10分
• リクエストの最大サイズ：1 MB

前提条件

• Microsoft Ads アカウント: UET タグと CAPI アクセスを持つアクティブな Microsoft Advertising アカウント。
• UET タグ ID: オンラインまたはオフラインのコンバージョンを Tealium を通じてサーバーサイドで追跡する場合でも、Microsoft は帰属とオーディエンスの関連付けに UET タグ ID を必要とします。UET タグ ID は Microsoft Ads プラットフォームで見つけることができます。既存のタグを使用するか、必要に応じて新しい UET タグ ID を提供してください。
• アクセストークン: CAPI 用の Microsoft 開発者トークン。詳細については、アクセストークンの生成を参照してください。
• コンバージョンゴール: Microsoft が CAPI イベントを正しく帰属できるようにするために、少なくとも1つのコンバージョンゴールを UET タグに関連付けて作成してください。
  1. ツール > コンバージョンゴールに移動します。
  2. + 新しいコンバージョンゴールをクリックします。
  3. ゴールタイプを選択します（例：購入、リード、予約など）。
  4. それをあなたの UET タグ ID に関連付けます。

構成

コネクタを追加するには、コネクタマーケットプレイスに移動し、新しいコネクタを追加します。コネクタの追加方法についての一般的な指示については、コネクタについてを参照してください。

コネクタを追加した後、次の構成を構成します：

• UET タグID: 既存のタグを使用するか、Microsoft Advertising アカウントで新しい UET タグ ID を提供することができます。
• アクセストークン: Microsoft Advertising アカウントのアクセストークン。

アクセストークンの生成

Microsoft Advertising Conversion API のアクセストークンを生成するには、次の手順に従います：

1. Microsoft Ads アカウントで、コンバージョン > UET タグに移動します。
2. タグ名の上にマウスを置き、鉛筆アイコンをクリックします。
   • 業界の値を選択する必要がある場合があります。
3. 保存して次へをクリックします。
4. コンバージョン API を使用するをクリックします。
5. 保存して次へをクリックします。
6. あとで参照するためにトークンを安全な場所に保存します。接続を確立するために必要です。
7. タグを保存します。

重複排除

Microsoft Advertising Advertising タグからのイベントの重複を排除するために、このコネクタを構成するには、次の命名規則でイベント ID を送信するイベント属性を使用します：

microsoft_event_id_{EVENT_NAME}}_{TAG_ID}}

タグの UID は、Tealium iQ タグテーブルまたはタグの詳細画面で見つけることができます。

例えば、UID が 88 のタグからの購入イベントは、次の属性値を送信します：

microsoft_event_id_purchase_88: “084b1cda7461…”

同じタグからのページロードイベントは、次の属性値を送信します：

microsoft_event_id_pageload_88: “028b2ade7478…”

自動重複排除

自動重複排除値が入力されると、コネクタは対応するイベント ID 属性を探します。このセクションが入力されていて Tealium iQ を使用している場合、イベント ID を追加する必要はありません。ただし、Tealium iQ なしで EventStream を使用している場合は、次のアプローチが必要になる場合があります。

コネクタは次の操作順序に従います：

• 自動重複排除が入力され、データレイヤーで値が見つかった場合（例：microsoft_purchase_id_88）、この値は Event ID でマッピングされたものより優先されます。
• 自動重複排除が入力されているが、タグ ID バージョンが見つからず、レガシーバージョン（ID なし）が見つかった場合、その値が使用されます（例：microsoft_purchase_id）。
• 自動重複排除が入力されているが、値が見つからない場合、マッピングされた Event ID が使用されます（入力されている場合）。

オフラインコンバージョン

Microsoft Advertising Conversions コネクタを使用してオフラインおよび店舗イベントを処理するには、必要なパラメータを含めてコネクタを構成します。

オンラインコンバージョンの場合、帰属は通常リアルタイムで発生します。オフラインコンバージョンの場合、Microsoft は最大 90 日前の遡及イベントをサポートします。イベントがリアルタイムに近いタイミングで送信されると、帰属の精度が向上します。

前提条件

• オフラインコンバージョンインポートを有効にする: これは Microsoft Ads で有効にする必要があり、Tealium から送信された CAPI イベントを取り込むことを許可します。
  1. ツール > オフラインコンバージョンに移動します。
  2. コンバージョンのインポートを選択します。
  3. Microsoft (API 経由のオフラインコンバージョン) を選択します。
• コンバージョンゴールを UET タグと関連付ける: これは Microsoft が広告のインタラクションにコンバージョンを帰属できるようにするために有効にする必要があります。
  1. ツール > コンバージョンゴールに移動します。
  2. + 新しいコンバージョンゴールをクリックします。
  3. オフラインイベントに関連するゴールタイプを選択します（例：店舗での購入、電話予約、ローン申込み）。
  4. ゴールソースの下で、オフラインコンバージョン (ファイルまたは API 経由でのインポート) を選択します。
  5. 既存の UET タグ ID とゴールを関連付けます。
• UET タグ ID の存在を確認する: ゴールで参照されている UET タグ ID が Microsoft Ads に存在することを確認してください。タグ自体がデプロイされていない場合でもです。
• クリック ID またはハッシュ化された PII をイベントと一緒に渡す: これにより Microsoft はマッチングを実行できます。

ベストプラクティス

• クリックIDを保持する: Microsoft Click ID (msclkid) はコンバージョン追跡において重要です。Microsoft Adsで自動タグ付けが有効になっている場合、この識別子はユーザーが広告をクリックした後、ランディングページURLのクエリパラメータとして追加されます。Persist Data Values extensionを使用してクリックIDを保持することで、サーバーサイドで使用できるようになります。クッキー属性をサーバーサイドでマッピングします。クリックIDがないと、Microsoftはコンバージョンを元の広告クリックにリンクできない可能性があり、帰属が失われ、入札が最適化されません。
• すべてのクリックがページロードイベントを発火: すべてのページビューまたはシングルページアプリケーション（SPA）ナビゲーションは、1つのページロードイベントを発火する必要があります。また、1つ以上のカスタムイベントを発火することもできます。各カスタムイベントは pageLoadId パラメータを通じてページロードイベントにリンクされます。
• Microsoft ID Beacon Syncを有効にする: Microsoft AdvertisingタグでMicrosoft ID Beacon Syncを有効にして、ID解決とリマーケティングのパフォーマンスを向上させます。この機能はデバイス間のIDスティッチングをサポートし、オンライン行動とオフラインコンバージョンのマッチング能力を向上させます。
• デフォルトで同意が付与されている: デフォルトでは、Microsoftはすべてのイベントを同意状態が付与されたものとして処理します。明示的な同意信号を使用する必要がある場合は、次のオプションを使用して adStorageConsent パラメータを使用できます:
  • G = 付与された。
  • D = 拒否された。拒否されたイベントは広告目的（コンバージョンの帰属やリターゲティングを含む）には使用されません。
• 厳格な電話番号とメールアドレスの形式: SHA256ハッシュ化されたPIIを使用する場合は、以下の形式ルールに従ってください:
  • 電話番号はE.164標準に従ってフォーマットします。
  • メールアドレスについて:
    • メールアドレスの先頭と末尾の空白を削除します。
    • テキストを小文字にします。
    • + と @ の間のすべてを削除します（例: user+withplus@example.com は user@example.com になります）。
    • @ の前のピリオドを削除します（例: us.er@example.com は user@example.com になります）。
    • メールアドレスに @ 記号が含まれていることを確認します。
    • @ の後にピリオドがあることを確認します（例: .com）。
    • ピリオドで始まるか終わることがないようにします。
    • アクセント（例: à）を削除します。
• UETタグでイベントID生成を有効にして自動重複排除を有効にします。自動重複排除マッピングセクションにタグIDを入力します。Microsoftは配信方法を横断して一致するIDを検出し、二重計算を防ぎます。このステップはデータの整合性を維持するために、デュアルデリバリー構成で重要です。

よくある質問

• UETタグなしでUET Conversion APIを使用できますか？
  はい。ただし、推奨されません。UET Conversion APIは独立して機能することができますが、MicrosoftはUETタグとUET CAPIの両方を実装することを強く推奨します。両方の方法を使用することで、信号損失からの回復により帰属精度が向上します。
• タグとコネクタで同じコンバージョンを送信できますか？
  はい。必須ではありませんが、強く推奨されます。Microsoftは重複を防ぐためのサポートを提供しています。両方のチャネルを通じてコンバージョンを送信することで、一方が失敗した場合でも他方がイベントを正しく帰属します。
• クリックIDなしでコンバージョンを送信できますか？
  必要がある場合や利用できない場合のみです。クリックIDはMicrosoft/Bing Adクリックにコンバージョンを帰属する最も正確な方法です。ハッシュ化されたPIIをフォールバックとして送信することは可能ですが、スマート入札やレポートのためのマッチング品質が低下する可能性があります。
• このコネクタをリードフォームや電話通話に使用できますか？
  はい。このコネクタを使用して、リードフォームの完了、事前資格提出、コールセンターイベントを送信します。これは、オフラインコンバージョン量が多い金融、自動車、旅行業界に理想的です。

トラブルシューティング

Trace toolを使用してEventStreamおよびAudienceStreamでイベントフローを監視します。また、Microsoft Adsアカウントで構成されている場合は、「テストモード」トグルを有効にするか、ステージングインスタンスにイベントを送信することもできます。

アクション

アクションの名前を入力し、アクションタイプを選択します。

次のセクションでは、各アクションのパラメータとオプションの構成方法について説明します。

コンバージョンイベントを送信

パラメータ

イベントタイプ

コンバージョンデータ

ユーザーデータ

カスタムデータ

アイテムデータ

業種固有のタイプ

業種固有のタイプが空の場合の業種固有のパラメータ

業種固有のタイプを選択 が選ばれていない場合、属性を手動でベンダーパラメータにマッピングします。

業種固有のタイプがホテルの場合の業種固有のパラメータ

業種固有のタイプがリテールの場合の業種固有のパラメータ

自動重複排除

自動マッピング無効化

コンバージョンイベント送信（バッチ処理）

このアクションは、コンバージョンイベント送信 アクションと同じパラメータとマッピングオプションを使用します。詳細については、コンバージョンイベント送信を参照してください。