---
title: Microsoft UET Conversion API コネクタ構成ガイド
description: この記事では、Microsoft UET Conversion API コネクタの構成方法について説明します。
url: https://docs.tealium.com/ja/server-side-connectors/microsoft-uet-conversion-api-connector/
---

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


## 概要

広告主は 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 を提供してください。
* **アクセストークン**: CAPI 用の Microsoft 開発者トークン。詳細については、[アクセストークンの生成](#generate-access-token)を参照してください。
* **コンバージョンゴール**: Microsoft が CAPI イベントを正しく帰属できるようにするために、少なくとも1つのコンバージョンゴールを UET タグに関連付けて作成してください。
    1. **ツール > コンバージョンゴール**に移動します。
    1. **+ 新しいコンバージョンゴール**をクリックします。
    1. ゴールタイプを選択します（例：購入、リード、予約など）。
    1. それをあなたの UET タグ ID に関連付けます。

## 構成

コネクタを追加するには、コネクタマーケットプレイスに移動し、新しいコネクタを追加します。コネクタの追加方法についての一般的な指示については、[コネクタについて](https://docs.tealium.com/about-connectors/)を参照してください。

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

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

### アクセストークンの生成

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

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

## 重複排除

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

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

### 前提条件

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

* **クリックIDを保持する**: Microsoft Click ID (`msclkid`) はコンバージョン追跡において重要です。Microsoft Adsで自動タグ付けが有効になっている場合、この識別子はユーザーが広告をクリックした後、ランディングページURLのクエリパラメータとして追加されます。[Persist Data Values extension](https://docs.tealium.com/persist-data-value-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タグで**イベントID生成**を有効にして自動重複排除を有効にします。**自動重複排除**マッピングセクションに**タグID**を入力します。Microsoftは配信方法を横断して一致するIDを検出し、二重計算を防ぎます。このステップはデータの整合性を維持するために、デュアルデリバリー構成で重要です。

## よくある質問

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

## トラブルシューティング

[Trace tool](https://docs.tealium.com/about-trace/)を使用して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値を探します。 |

##### 自動マッピング無効化

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

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

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