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

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

概要

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

Microsoft UET Conversion API は、単独での統合または Microsoft UET タグと一緒に使用することができます。デュアルデリバリー構成では、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 を用意してください。
• アクセストークン：Microsoft アカウントマネージャーからトークンを取得します。
• コンバージョンゴール：Microsoft が CAPI イベントを正しく帰属できるようにするために、少なくとも1つのコンバージョンゴールを UET タグに関連付けて作成してください。
  1. ツール > コンバージョンゴールに移動します。
  2. + 新しいコンバージョンゴールをクリックします。
  3. ゴールタイプを選択します（例：購入、リード、予約など）。
  4. それをあなたの UET タグ ID に関連付けます。

構成

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

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

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

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

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

トラブルシューティング

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

アクション

アクション名	AudienceStream	EventStream
コンバージョンイベントを送信	✓	✓
コンバージョンイベントをバッチで送信	✓	✓

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

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

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

パラメータ

イベントタイプ

パラメータ	説明
イベントタイプ	イベントタイプ。利用可能なオプションは Page Load または Custom です。

コンバージョンデータ

パラメータ	説明
イベントID	イベントの一意のID。重複排除のために必要です。
イベント名	カスタムコンバージョン目標の場合のイベントアクション。
イベント時間	イベントのタイムスタンプ（UNIXエポックタイムUTC）秒単位。コネクタはイベントに表示された場合、このパラメータを自動的にマッピングします。値が構成されていない場合、コネクタは現在の時間を使用します。
イベントソースURL	外部の目標URLとして使用されるページのURL。コネクタはイベントに表示された場合、このパラメータを自動的にマッピングします。属性をマッピングすると、この値が上書きされます。
広告保存同意	同意信号の場合、G は付与、D は拒否を使用します。
ページロードID	同じページの1つ以上のカスタムイベントにリンクするページロードID。このパラメータはv4 UUIDとしてフォーマットする必要があります。
リファラURL	ページのリファラー、外部「リファラル」リマーケティングリストに使用されます。
ページタイトル	ページのタイトル（例: document.title）。
キーワード	ページのキーワード（SEOメタキーワード）。

ユーザーデータ

パラメータ	説明
クライアントユーザーエージェント	エンドユーザーのブラウザからのユーザーエージェントヘッダー。
匿名ID	ゲストユーザーの匿名ID、ID同期にも使用されます。v1 UUIDを使用することが望ましい（必須ではない）。
外部ID	ユーザーがログインしている場合の認証済みユーザーID（匿名化）。ID同期にも使用されます。
メールアドレス（既にSHA256ハッシュ化されている）	すでに空白トリム、小文字化、SHA256ハッシュ化されたメールアドレスを提供します。
メールアドレス（SHA256ハッシュを適用）	プレーンテキストのメールアドレスを提供し、コネクタがこの値を空白トリム、小文字化し、SHA256ハッシュを使用してハッシュ化します。
電話番号（既にSHA256ハッシュ化されている）	すでに空白トリム、小文字化、SHA256ハッシュ化された電話番号を提供します。
電話番号（SHA256ハッシュを適用）	プレーンテキストの電話番号を提供し、コネクタがこの値を空白トリム、小文字化し、SHA256ハッシュを使用してハッシュ化します。
クライアントIPアドレス	ユーザーのIPv4またはIPv6アドレス。
Microsoft Click ID	クリックIDは、コネクタがクリックに正確にコンバージョンを帰属するのを助けるために使用されます。
GAID	Androidデバイスの場合、Google広告ID。
IDFA	iOSデバイスIDの場合、AppleデバイスID。

カスタムデータ

パラメータ	説明
イベントカテゴリ	カスタムコンバージョン目標の場合に使用されるイベントカテゴリ。コネクタはイベントに表示された場合、このパラメータを自動的にマッピングします。
イベントラベル	カスタムコンバージョン目標の場合に使用されるイベントラベル。
イベント値	カスタムコンバージョン目標の場合に使用されるイベント値（float）。コネクタはイベントに表示された場合、このパラメータを自動的にマッピングします。
検索用語	ユーザーが検索結果ページで使用した検索クエリ、オプションです。
トランザクションID	このイベントに関連付けられた一意のID、オプションですが単一イベントの場合は推奨されます。コネクタはイベントに表示された場合、このパラメータを自動的にマッピングします。
値	目標に使用される変動収益値（float）。コネクタはイベントに表示された場合、このパラメータを自動的にマッピングします。
通貨	収益通貨を3桁のISO 4217形式で、使用される場合。コネクタはイベントに表示された場合、このパラメータを自動的にマッピングします。

アイテムデータ

パラメータ	説明
ID	アイテムID。このパラメータがイベントに現れたとき、コネクタは自動的にマッピングします。
数量	アイテムの数量。このパラメータがイベントに現れたとき、コネクタは自動的にマッピングします。
価格	割引後のアイテム価格。このパラメータがイベントに現れたとき、コネクタは自動的にマッピングします。
名前	アイテム名。このパラメータがイベントに現れたとき、コネクタは自動的にマッピングします。

業種固有のタイプ

パラメータ	説明
業種固有のタイプを選択	イベントの業種タイプ。Retail または Hotel が受け入れられる値です。

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

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

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

パラメータ	説明
合計価格	税金や手数料を含む予約の合計価格。
基本価格	税金や手数料を含まない予約の価格。
チェックイン日	YYYY-MM-DD形式のチェックイン日。
チェックアウト日	YYYY-MM-DD形式のチェックアウト日。この値は滞在期間が指定されている場合は必要ありません。
滞在期間	予約の宿泊数。この値はチェックアウト日が指定されている場合は必要ありません。
パートナーホテルID	あなたのプロパティフィードでホテルを識別するために使用したID。
予約Href	暗号化されたまたは難読化された予約参照番号。

業種固有のパラメータが小売の場合

パラメータ	説明
アイテムID	製品IDのカンマ区切りリスト。
ページタイプ	ページのタイプ。この値は cart, category, home, other, product, purchase, searchresults のいずれかになります。
Ecomm合計価値	カートまたは購入の合計価値。
Ecommカテゴリ	カテゴリID。

自動重複排除

パラメータ	説明
Tealium iQタグID	Tealium iQタグIDが提供されると、コネクタは自動的にTealium iQから送信されるイベントID値を探します。

自動マッピング無効化

パラメータ	説明
自動マッピング無効化	自動マッピングが無効にされると、自動マッピングされたパラメータはデフォルトでベンダーに送信されません。

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

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