---
title: Amazon Ads Conversions コネクタ構成ガイド
description: この記事では、Amazon Ads Conversions コネクタの構成方法について説明します。
url: https://docs.tealium.com/ja/server-side-connectors/amazon-ads-conversions-connector/
---
## API情報

このコネクタは以下のベンダーAPIを使用します：

* API名：Amazon Ads Events API
* APIバージョン：v1
* APIエンドポイント：`https://advertising-api.amazon.com`
* ドキュメント：[Amazon Ads Events API](https://advertising.amazon.com/API/docs/en-us/guides/events/events)
* タグドキュメント：[Amazon Advertising Tag](https://docs.tealium.com/amazon-advertising-tag/)

## コネクタのヒント

タグとコネクタを使用したハイブリッド構成を推奨します。この構成により、データの耐久性が最大化され、サーバーサイドのシグナルとのイベントマッチングが向上し、リアルタイムのクライアントサイドシグナルを保持しながらデータフローの連続性が維持されます。

## 構成

コネクタマーケットプレイスにアクセスし、新しいコネクタを追加します。コネクタの追加方法については、[About Connectors](https://docs.tealium.com/about-connectors/)を参照してください。

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

* **APIベースURL**：（必須）APIベースURLを選択します。
* **Amazon広告主ID**：（必須）Amazon広告アカウントIDを入力します。

## Webイベントの重複排除

Amazon Adsサーバータグからのイベントを重複排除するには、以下の命名規則でイベントIDをイベント属性として送信します：

```nohl
amazon_event_id_{EVENT_NAME}_{TAG_UID}
```

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

![](https://docs.tealium.com/images/server-side-connectors/amazon-ad-server-tag-uid.png)

例えば、UIDが`170`のタグからのチェックアウトイベントは、次の属性値を送信します：

```json
{
  "amazon_event_id_checkout_170": "028b2ade7478..."
}
```

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

```json
{
  "amazon_event_id_pageView_170": "028b2ade7478..."
}
```

各タイプのイベントに対して別々のアクションを使用します。イベント固有のイベントID属性を`Event ID`にマッピングし、対応するイベント名を`Event Name`にマッピングします。例えば：

| Tealium属性  | Amazonパラメータ  |
|:-------------------------|:-------------------|
| `amazon_event_id_checkout_170` (属性)   | Event ID           |
| `"Checkout"` (カスタムテキスト) | Event Name         |

### 自動重複排除

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

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

* **自動重複排除**が入力され、値がデータレイヤーで見つかった場合（例：`amazon_event_id_checkout_170`）、この値は`Event ID`にマッピングされたものより優先されます。
* **自動重複排除**が入力されているが値が見つからない場合、入力されている`Event ID`が使用されます。

## アクション

| アクション名 | AudienceStream | EventStream |
| --- | :---: | :---: |
| コンバージョン送信 | ✓ | ✓ |
| コンバージョン送信（非推奨） | ✓ | ✓ |

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

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

### コンバージョン送信

#### バッチ制限

このアクションは、ベンダーへの高容量データ転送をサポートするためにバッチリクエストを使用します。並行処理により、イベントがベンダーに順不同で到達する可能性があります。イベントの順序が重要な場合は、イベントにシーケンス値を追加します。詳細については、[Batched Actions](https://docs.tealium.com/batched-actions/)を参照してください。リクエストは、次のいずれかの閾値に達するか、プロファイルが公開されるまでキューに入れられます：

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

#### パラメータ

| パラメータ | 説明 |
| --- | --- |
| コンバージョンタイプ | インポートされるイベントのコンバージョンタイプを選択します。可能な値は`ADD_TO_SHOPPING_CART`, `APPLICATION`, `CHECKOUT`, `CONTACT`, `LEAD`, `OFF_AMAZON_PURCHASES`, `MOBILE_APP_FIRST_START`, `PAGE_VIEW`, `SEARCH`, `SIGN_UP`, `SUBSCRIBE`, `OTHER`です。 |
| コンバージョンソース | インポートされるイベントのコンバージョンソースを選択します。可能な値は`ANDROID`, `FIRE_TV`, `IOS`, `OFFLINE`, `WEBSITE`, `MEASUREMENT_PARTNER`です。 |

#### コンバージョンデータ


<blockquote>
Amazonに送信される各ユニークなコンバージョン名は、Amazon Adsで新しいコンバージョン定義を作成します。Amazonは各広告主アカウントに対して100のコンバージョン定義の制限を設けています。  
`Name`フィールドをページ名、ページURL、パス名、クエリ文字列、検索用語などの高カーディナリティまたは動的データにマッピングしないでください。そうすると、すぐに制限に達する可能性があります。
</blockquote>


| パラメータ | 説明 |
| --- | --- |
| 名前 | (必須) インポートされるイベントの名前。`product_view`, `search`, `lead`, `checkout`, `purchase`など、ビジネスアクションを表す小さく安定した名前セットを使用します。 |
| 国コード | (必須) イベントを実行したユーザーが位置していた国を示すISO 3166-1 alpha-2国コード。 |
| データセット名 | このイベントが追加されるイベントデータセット名。1～100文字の文字列で、最初は文字で始まり、その後は文字、数字、アンダースコア、ハイフンのみを含むことができます。 |
| イベント時間 | コンバージョンのタイムスタンプをISO形式（`YYYY-MM-DDThh:mm:ssTZD`）で。マッピングされていない場合、コネクタはイベント時間を使用します。 |
| 値 | イベントの値。 |
| 通貨コード | ISO-4217形式の通貨。`OFF_AMAZON_PURCHASES`のコンバージョンタイプにのみ適用されます。 |
| 販売単位 | 購入されたアイテムの数。`OFF_AMAZON_PURCHASES`のコンバージョンタイプにのみ適用されます。 |
| データ処理オプション | イベントの処理方法を示すフラグ。限定データ使用でマークされたイベントは処理されません。例えば、`LIMITED_DATA_USE` |
| Dedupe ID | タグとコネクタの両方から送信されるコンバージョンイベントを重複排除するために使用される一意の識別子。重複するコンバージョンレポートを防ぐために、両方で同じ値を構成します。 |


#### ユーザーデータ

| パラメータ | 説明 |
| --- | --- |
| Email（既にSHA256ハッシュ化済み） | すでに空白をトリムし、小文字に変換し、SHA256でハッシュ化されたメールアドレスを提供してください。 |
| Email（SHA256ハッシュを適用） | プレーンテキストのメールアドレスを提供し、コネクタが空白をトリムし、小文字に変換し、SHA256ハッシュを使用してこの値をハッシュ化します。 |
| Phone（既にSHA256ハッシュ化済み） | すでに空白をトリムし、小文字に変換し、SHA256でハッシュ化された電話番号を提供してください。 |
| Phone（SHA256ハッシュを適用） | プレーンテキストの電話番号を提供し、コネクタが空白をトリムし、小文字に変換し、SHA256ハッシュを使用してこの値をハッシュ化します。 |
| First Name（既にSHA256ハッシュ化済み） | すでに空白をトリムし、小文字に変換し、SHA256でハッシュ化された名前を提供してください。 |
| First Name（SHA256ハッシュを適用） | プレーンテキストの名前を提供し、コネクタが空白をトリムし、小文字に変換し、SHA256ハッシュを使用してこの値をハッシュ化します。 |
| Last Name（既にSHA256ハッシュ化済み） | すでに空白をトリムし、小文字に変換し、SHA256でハッシュ化された姓を提供してください。 |
| Last Name（SHA256ハッシュを適用） | プレーンテキストの姓を提供し、コネクタが空白をトリムし、小文字に変換し、SHA256ハッシュを使用してこの値をハッシュ化します。 |
| Address（既にSHA256ハッシュ化済み） | すでに空白をトリムし、小文字に変換し、SHA256でハッシュ化された住所を提供してください。 |
| Address（SHA256ハッシュを適用） | プレーンテキストの住所を提供し、コネクタが空白をトリムし、小文字に変換し、SHA256ハッシュを使用してこの値をハッシュ化します。 |
| City（既にSHA256ハッシュ化済み） | すでに空白をトリムし、小文字に変換し、SHA256でハッシュ化された市町村を提供してください。 |
| City（SHA256ハッシュを適用） | プレーンテキストの市町村を提供し、コネクタが空白をトリムし、小文字に変換し、SHA256ハッシュを使用してこの値をハッシュ化します。 |
| State（既にSHA256ハッシュ化済み） | すでに空白をトリムし、小文字に変換し、SHA256でハッシュ化された州を提供してください。 |
| State（SHA256ハッシュを適用） | プレーンテキストの州を提供し、コネクタが空白をトリムし、小文字に変換し、SHA256ハッシュを使用してこの値をハッシュ化します。 |
| Postal Code（既にSHA256ハッシュ化済み） | すでに空白をトリムし、小文字に変換し、SHA256でハッシュ化された郵便番号を提供してください。 |
| Postal Code（SHA256ハッシュを適用） | プレーンテキストの郵便番号を提供し、コネクタが空白をトリムし、小文字に変換し、SHA256ハッシュを使用してこの値をハッシュ化します。 |
| MAID | モバイル識別子。可能な値は `MAID`, `ADID`, `IDFA`, `FIREADID` です。 |
| Ramp ID | LiveRampの識別子です。 |
| Match ID | Amazonがユーザー識別キーとしてサポートしている一般的なマッチ識別子タイプです。 |
| Custom Data | 変換イベントに関連するカスタムデータをマップします。 |

#### 同意

| パラメータ | 説明 |
| --- | --- |
| Amazon Ad Storage | ユーザーがAmazonに広告識別子の保存とアクセスを許可したかどうかを示します。可能な値は `GRANTED` または `DENIED` です。 |
| Amazon User Data | ユーザーがAmazonによる広告のためのユーザーデータの使用を許可したかどうかを示します。可能な値は `GRANTED` または `DENIED` です。 |
| IP Address | ユーザーのIPアドレスです。 |
| GPP String | GPP同意文字列です。 |
| TCF String | IAB（Interactive Advertising Bureau）を使用したGDPR同意文字列です。 |

#### 自動重複排除

| パラメータ | 説明 |
| --- | --- |
| 自動重複排除 | **Tealium iQ Tag ID** を入力し、TealiumがTealium iQから送信されたこのイベントIDを自動的に検索します。 |

#### マッピングの上書き

| パラメータ | 説明 |
| --- | --- |
| 広告主ID | 広告主の一意の識別子です。 |
| Base URL | Amazon Ads APIのベースURLです。 |

ハッシュ化のためのフォーマットと正規化要件についての詳細は、[Format audience file for hashing](https://advertising.amazon.com/help/GCCXMZYCK4RXWS6C)を参照してください。

### 送信変換（非推奨）


<blockquote>
このアクションは現在非推奨となっており、新たに追加することはできません。現在のアクションについては、[Send Conversion](#send-conversion)を参照してください。
</blockquote>


#### API情報

このアクションは次のベンダーAPIを使用します：

* API名：Amazon Ads API
* APIバージョン：v1.0
* APIエンドポイント：`https://advertising-api.amazon.com`
* ドキュメント：[Amazon API](https://advertising.amazon.com/API/docs/en-us/dsp-conversion-builder)

#### 変換定義の作成

変換定義を作成するには、**Create Conversion Definition** をクリックし、次の情報を提供してください：

* **広告プロファイル**：（必須）この変換のための広告プロファイルを選択してください。
* **変換定義名**：（必須）変換定義の名前です。
* **ソースタイプ**：（必須）変換のソースタイプを選択してください。利用可能なタイプは `ADD_TO_SHOPPING_CART`, `APPLICATION`, `CHECKOUT`, `CONTACT`, `LEAD`, `OFF_AMAZON_PURCHASES`, `PAGE_VIEW`, `SEARCH`, `SIGN_UP`, `SUBSCRIBE`, `OTHER` です。
* **変換タイプ**：（必須）変換のタイプを選択してください。利用可能なタイプは `ANDROID`, `FIRE_TV`, `IOS`, `OFFLINE`, `WEBSITE` です。
* **カウント方法**：（必須）変換定義のために、24時間のウィンドウ内でユーザーごとにすべての変換イベントを使用するか、最初のイベントのみを使用するかを決定する方法を選択してください。利用可能な方法は `EVERY` と `FIRST` です。
* **変換値**：（オプション）変換の値です。デフォルト値は `1` で、**Send Conversion** アクションでマッピングを通じて上書きすることができます。

変換定義を保存するには、**Done** をクリックしてください。

広告データマネージャーコンソールの変換ページまたはTerms API（`POST /adm/terms`）を使用して、利用規約に同意してください。

#### バッチ制限

このアクションは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用します。並行処理により、イベントがベンダーに順不同で到達する可能性があります。順序が重要な場合は、イベントにシーケンス値を追加してください。詳細については、[Batched Actions](https://docs.tealium.com/batched-actions/)を参照してください。リクエストは、次のいずれかの閾値が満たされるか、プロファイルが公開されるまでキューに入れられます：

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

#### パラメータ

| パラメータ | 説明 |
| --- | --- |
| 変換定義 | 変換定義を選択するか、**Create Definition** をクリックして新しい定義を作成します。 |

##### 変換データ

| パラメータ | 説明 |
| --- | --- |
| 国コード | (必須) イベントを実行するユーザーが位置する国のISO 3166-1 alpha-2形式のコードです。 |
| 変換時間 | 変換のタイムスタンプをISO形式 (`YYYY-MM-DDThh:mm:ssTZD`) で指定します。マッピングされていない場合、コネクタはイベント時間を使用します。 |
| 変換値 | 変換の値です。 |
| 通貨 | ISO 4217形式の通貨です。`OFF_AMAZON_PURCHASES` 変換タイプにのみ適用されます。 |
| 販売単位 | 購入されたアイテムの数です。`OFF_AMAZON_PURCHASES` 変換タイプにのみ適用されます。 |
| Dedupe ID | タグとコネクタの両方で変換を追跡している場合、重複排除IDを指定してください。両方のイベントで値が一致する必要があります。 |

##### ユーザーデータ

| パラメータ | 説明 |
| --- | --- |
| Email（既にSHA256ハッシュ化済み） | 既に空白を削除し、小文字に変換し、SHA256でハッシュ化されたメールアドレスを提供してください。 |
| Email（SHA256ハッシュを適用） | プレーンテキストのメールアドレスを提供し、コネクタが空白を削除し、小文字に変換し、SHA256ハッシュを使用してこの値をハッシュ化します。 |
| Phone（既にSHA256ハッシュ化済み） | 既に空白を削除し、小文字に変換し、SHA256でハッシュ化された電話番号を提供してください。 |
| Phone（SHA256ハッシュを適用） | プレーンテキストの電話番号を提供し、コネクタが空白を削除し、小文字に変換し、SHA256ハッシュを使用してこの値をハッシュ化します。 |
| First Name（既にSHA256ハッシュ化済み） | 既に空白を削除し、小文字に変換し、SHA256でハッシュ化された名前を提供してください。 |
| First Name（SHA256ハッシュを適用） | プレーンテキストの名前を提供し、コネクタが空白を削除し、小文字に変換し、SHA256ハッシュを使用してこの値をハッシュ化します。 |
| Last Name（既にSHA256ハッシュ化済み） | 既に空白を削除し、小文字に変換し、SHA256でハッシュ化された姓を提供してください。 |
| Last Name（SHA256ハッシュを適用） | プレーンテキストの姓を提供し、コネクタが空白を削除し、小文字に変換し、SHA256ハッシュを使用してこの値をハッシュ化します。 |
| Address（既にSHA256ハッシュ化済み） | 既に空白を削除し、小文字に変換し、SHA256でハッシュ化された住所を提供してください。 |
| Address（SHA256ハッシュを適用） | プレーンテキストの住所を提供し、コネクタが空白を削除し、小文字に変換し、SHA256ハッシュを使用してこの値をハッシュ化します。 |
| City（既にSHA256ハッシュ化済み） | 既に空白を削除し、小文字に変換し、SHA256でハッシュ化された市町村名を提供してください。 |
| City（SHA256ハッシュを適用） | プレーンテキストの市町村名を提供し、コネクタが空白を削除し、小文字に変換し、SHA256ハッシュを使用してこの値をハッシュ化します。 |
| State（既にSHA256ハッシュ化済み） | 既に空白を削除し、小文字に変換し、SHA256でハッシュ化された州名を提供してください。 |
| State（SHA256ハッシュを適用） | プレーンテキストの州名を提供し、コネクタが空白を削除し、小文字に変換し、SHA256ハッシュを使用してこの値をハッシュ化します。 |
| Postal Code（既にSHA256ハッシュ化済み） | 既に空白を削除し、小文字に変換し、SHA256でハッシュ化された郵便番号を提供してください。 |
| Postal Code（SHA256ハッシュを適用） | プレーンテキストの郵便番号を提供し、コネクタが空白を削除し、小文字に変換し、SHA256ハッシュを使用してこの値をハッシュ化します。 |
| MAID | モバイル識別子。可能な値は `MAID`, `ADID`, `IDFA`, `FIREADID` です。 |

#### 自動重複排除

| パラメータ | 説明 |
| --- | --- |
| 自動重複排除 | **Tealium iQ Tag ID** を入力し、TealiumがTealium iQから送信されたこのイベントIDを自動的に検索します。 |
| タグ変換タイプ | 自動重複排除を有効にする場合、タグデータと共に送信される以下の変換タイプのいずれかを選択します: `ADD_TO_SHOPPING_CART`, `APPLICATION`, `CHECKOUT`, `CONTACT`, `LEAD`, `OFF_AMAZON_PURCHASES`, `PAGE_VIEW`, `SEARCH`, `SIGN_UP`, `SUBSCRIBE`, `OTHER`。 |

#### マッピングオーバーライド

| パラメータ | 説明 |
| --- | --- |
| 広告主ID | 広告主の一意の識別子です。 |
| ベースURL | Amazon Ads APIのベースURLです。 |
| 変換定義ID | 使用する変換定義のIDです。 |

ハッシングのためのオーディエンスファイルのフォーマットと正規化要件についての詳細は、[オーディエンスファイルをハッシング用にフォーマットする](https://advertising.amazon.com/help/GCCXMZYCK4RXWS6C)を参照してください。