---
title: Amazon Advertising DSPコネクタ構成ガイド
description: この記事では、Amazon Advertising DSPコネクタの構成方法について説明します。
url: https://docs.tealium.com/ja/server-side-connectors/amazon-advertising-dsp-connector/
---

<blockquote>
このコネクタは現在非推奨です。現行のコネクタについては、[Amazon Ads Audience Management connector](https://docs.tealium.com/amazon-ads-audience-management-connector/)を参照してください。
</blockquote>


Amazon Ads APIは、Amazonの広告主およびAmazon Advertising Partner Networkのメンバーが広告運用をプログラム的に管理することを可能にします。TealiumのAmazon Ads Data Provider APIとの統合により、クライアントはAmazon Ads DSP内のオーディエンスから訪問を追加および削除することができます。

## コネクタのアクション

| アクション名 | AudienceStream | EventStream |
| --- | :---: | :---: |
|ハッシュ化レコードの追加| ✓| ✗|
|オーディエンスへの追加| ✓| ✗|
|オーディエンスからの削除| ✓| ✗|

## 構成の構成

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


<blockquote>
このコネクタを追加する際には、ベンダーのデータプラットフォームポリシーを受け入れるよう求められます。
</blockquote>


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

* **API Base URLs**  
APIベースURLを選択します。

* **Amazon広告主ID**  
Amazon AdvertisingアカウントIDを入力します。

また、Amazonとの接続を確立する必要があります。**接続の確立**をクリックし、ページの指示に従ってTealium Connector AppをAmazon Advertisingアカウントに接続します。

コネクタの構成が完了したら、**完了**をクリックします。

## アクション構成 — パラメータとオプション

**続行**をクリックしてコネクタアクションの構成を行います。アクションの名前を入力し、ドロップダウンメニューからアクションタイプを選択します。

Amazon Advertising DSPコネクタは、以下のアクションをサポートしています：

* ハッシュ化レコードの追加

* オーディエンスへの追加

* オーディエンスからの削除

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

### アクション — ハッシュ化レコードの追加

このアクションは、ハッシュ化された個人情報と外部識別子（例：顧客ID）をAmazon DSPに送信し、Amazonのショッパーとそのハッシュ化された顧客レコードを照合するために使用されます。これには名前、メール、携帯電話、住所、郵便番号が含まれます。広告主はその後、以前に送信された外部識別子を使用して、データプロバイダAPIを通じて顧客をオーディエンスに追加することができます。

例えば、訪問のプロファイルにメールと顧客IDの両方が存在する場合に参加する**既知の顧客**オーディエンスを構成します。次に、訪問が**既知の顧客**オーディエンスに参加するとトリガーされる**ハッシュ化レコードの追加**アクションを持つAmazon DSPコネクタを構成します。コネクタのアクションは、ハッシュ化されたメールと顧客IDをAmazonに送信します。その顧客IDは後で、**オーディエンスへの追加**Amazon DSPコネクタアクションを使用してその訪問をオーディエンスに追加するために使用することができます。

#### バッチ制限

このアクションは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用します。詳細については、[Batched Actions](https://docs.tealium.com/batched-actions/)を参照してください。リクエストは、次のいずれかの閾値が満たされるか、プロファイルが公開されるまでキューに入れられます：

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

#### パラメータ

|**パラメータ**| **説明**|
|---| ---|
|外部ID|  <ul><li>このレコードの外部識別子です。</li><li>呼び出し元の独自の識別空間におけるレコードに固有のIDであることができます。</li><li>この識別子はAmazon Adsのハッシュ化レコードと照合され、その後ユーザーをオーディエンスに追加するために使用されます。</li></ul> |
|メールアドレス（既にSHA256ハッシュ化済み）|  <ul><li>メールアドレスです。</li><li>SHA256でハッシュ化する必要があります。</li><li>既にハッシュ化されている場合は、**既にSHA256ハッシュ化済み**オプションを使用します。空白をトリミングし、小文字に変換し、SHA256ハッシュを使用してハッシュ化された値を提供します。</li></ul> |
|メールアドレス（SHA256ハッシュを適用）|  <ul><li>メールアドレスです。</li><li>SHA256でハッシュ化する必要があります。</li><li>**SHA256ハッシュを適用**オプションを使用し、プレーンテキスト値を空白トリミングし、小文字に変換し、SHA256ハッシュを使用してハッシュ化します。</li></ul> |
|名（既にSHA256ハッシュ化済み）|  <ul><li>名です。</li><li>SHA256でハッシュ化する必要があります。</li><li>既にハッシュ化されている場合は、**既にSHA256ハッシュ化済み**オプションを使用します。空白をトリミングし、小文字に変換し、SHA256ハッシュを使用してハッシュ化された値を提供します。</li></ul> |
|名（SHA256ハッシュを適用）|  <ul><li>名です。</li><li>SHA256でハッシュ化する必要があります。</li><li>**SHA256ハッシュを適用**オプションを使用し、プレーンテキスト値を空白トリミングし、小文字に変換し、SHA256ハッシュを使用してハッシュ化します。</li></ul> |
|姓（既にSHA256ハッシュ化済み）|  <ul><li>姓です。</li><li>SHA256でハッシュ化する必要があります。</li><li>既にハッシュ化されている場合は、**既にSHA256ハッシュ化済み**オプションを使用します。空白をトリミングし、小文字に変換し、SHA256ハッシュを使用してハッシュ化された値を提供します。</li></ul> |
|姓（SHA256ハッシュを適用）|  <ul><li>姓です。</li><li>SHA256でハッシュ化する必要があります。</li><li>**SHA256ハッシュを適用**オプションを使用し、プレーンテキスト値を空白トリミングし、小文字に変換し、SHA256ハッシュを使用してハッシュ化します。</li></ul> |
|住所（既にSHA256ハッシュ化済み）|  <ul><li>住所です。</li><li>SHA256でハッシュ化する必要があります。</li><li>既にハッシュ化されている場合は、**既にSHA256ハッシュ化済み**オプションを使用します。空白をトリミングし、小文字に変換し、SHA256ハッシュを使用してハッシュ化された値を提供します。</li></ul> |
|住所（SHA256ハッシュを適用）|  <ul><li>住所です。</li><li>SHA256でハッシュ化する必要があります。</li><li>**SHA256ハッシュを適用**オプションを使用し、プレーンテキスト値を空白トリミングし、小文字に変換し、SHA256ハッシュを使用してハッシュ化します。</li></ul> |
|電話番号（既にSHA256ハッシュ化済み）|  <ul><li>電話番号です。</li><li>SHA256でハッシュ化する必要があります。</li><li>既にハッシュ化されている場合は、**既にSHA256ハッシュ化済み**オプションを使用します。空白をトリミングし、SHA256ハッシュを使用してハッシュ化された値を提供します。</li></ul> |
|電話番号（SHA256ハッシュを適用）|  <ul><li>電話番号です。</li><li>SHA256でハッシュ化する必要があります。</li><li>**SHA256ハッシュを適用**オプションを使用し、プレーンテキスト値を空白トリミングし、SHA256ハッシュを使用してハッシュ化します。</li></ul> |
|市区町村（既にSHA256ハッシュ化済み）|  <ul><li>市区町村です。</li><li>SHA256でハッシュ化する必要があります。</li><li>既にハッシュ化されている場合は、**既にSHA256ハッシュ化済み**オプションを使用します。空白をトリミングし、小文字に変換し、SHA256ハッシュを使用してハッシュ化された値を提供します。</li></ul> |
|市区町村（SHA256ハッシュを適用）|  <ul><li>市区町村です。</li><li>SHA256でハッシュ化する必要があります。</li><li>**SHA256ハッシュを適用**オプションを使用し、プレーンテキスト値を空白トリミングし、小文字に変換し、SHA256ハッシュを使用してハッシュ化します。</li></ul> |
|郵便番号（既にSHA256ハッシュ化済み）|  <ul><li>郵便番号です。</li><li>SHA256でハッシュ化する必要があります。</li><li>既にハッシュ化されている場合は、**既にSHA256ハッシュ化済み**オプションを使用します。空白をトリミングし、小文字に変換し、SHA256ハッシュを使用してハッシュ化された値を提供します。</li></ul> |
|郵便番号（SHA256ハッシュを適用）|  <ul><li>郵便番号です。</li><li>SHA256でハッシュ化する必要があります。</li><li>**SHA256ハッシュを適用**オプションを使用し、プレーンテキスト値を空白トリミングし、小文字に変換し、SHA256ハッシュを使用してハッシュ化します。</li></ul> |
|州（既にSHA256ハッシュ化済み）|  <ul><li>州です。</li><li>SHA256でハッシュ化する必要があります。</li><li>既にハッシュ化されている場合は、**既にSHA256ハッシュ化済み**オプションを使用します。空白をトリミングし、小文字に変換し、SHA256ハッシュを使用してハッシュ化された値を提供します。</li></ul> |
|州（SHA256ハッシュを適用）|  <ul><li>州です。</li><li>SHA256でハッシュ化する必要があります。</li><li>**SHA256ハッシュを適用**オプションを使用し、プレーンテキスト値を空白トリミングし、小文字に変換し、SHA256ハッシュを使用してハッシュ化します。</li></ul> |

#### ハッシュ化された属性

マッピングされた値は、Amazonの[Hashed Audience documentation](https://advertising.amazon.com/dsp/help/ss/en/audiences/advertiser-audiences/advertiser-hashed-audience/#GA6BC9BW52YFXBNE)に従って正規化およびハッシュ化する必要があります。
### アクション — オーディエンスへの追加

このアクションは、Amazon DSP内のオーディエンスに訪問を追加するために使用されます。例えば、特定のライフタイム支出閾値に達したときに、特定のAmazon DSPオーディエンスに訪問を追加してリターゲティングすることができます。

#### バッチ制限

このアクションは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用します。詳細については、[バッチアクション](https://docs.tealium.com/batched-actions/)を参照してください。リクエストは、次のいずれかの閾値が達成されるか、プロファイルが公開されるまでキューに入れられます：

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

#### パラメータ

|**パラメータ**| **説明**|
|---| ---|
|オーディエンスID| 既存のTealium作成のAmazonオーディエンスを使用する場合は、既存のTealiumコネクタアクション構成にあるTealiumオーディエンスIDを入力します。<br> Amazon DSPで新しいオーディエンスを作成するには、**オーディエンスの作成**をクリックし、次の情報を入力します：<ul><li>新しいAmazon DSPオーディエンスの名前</li><li>説明</li><li>一意の外部オーディエンスID</li><li>ユーザーオーディエンスデータのソースを表すDMA関連フィールドである2文字の国コードのカンマ区切りリスト。デフォルト値は`UNKNOWN`です。</li></ul>オーディエンスを選択または作成した後、**オーディエンスIDの確認**をクリックして、オーディエンスが正しいことを確認します。 |
|外部ID| Amazonにハッシュマッチングを通じて以前に送信された外部ID。|
|MAID| モバイル広告識別子。|
|Amazon Cookie| クッキー同期を通じて取得したクッキー。|

#### 同意

**オーディエンスへの追加**アクションを使用する際、コネクタはすべての`amazonConsent`値に対して`GRANTED`を送信します。同意を与えていない訪問をオーディエンスに追加しないようにするためには、訪問のプロファイル同意状態をチェックするルールを持つオーディエンスを作成します。その後、同意を与えていない訪問を削除するために**オーディエンスからの削除**アクションを使用します。

### アクション — オーディエンスからの削除

このアクションは、Amazon DSP内のオーディエンスから訪問を削除するために使用されます。例えば、訪問がAudienceStreamのオーディエンスを離れるときに特定のAmazon DSPオーディエンスから訪問を削除して、リターゲティングされないようにすることができます。

#### バッチ制限

このアクションは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用します。詳細については、[バッチアクション](https://docs.tealium.com/batched-actions/)を参照してください。リクエストは、次のいずれかの閾値が達成されるか、プロファイルが公開されるまでキューに入れられます：

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

#### パラメータ

|**パラメータ**| **説明**|
|---| ---|
|オーディエンスID| 既存のTealium作成のAmazonオーディエンスを使用する場合は、そのIDを入力し、**オーディエンスIDの確認**をクリックして、オーディエンスが正しいことを確認します。<br>「オーディエンスへの追加」アクション構成で作成されたオーディエンスIDをコピーしてください。この名前は既存のTealiumコネクタアクション構成からコピーして貼り付ける必要があります。Amazonインターフェースに表示されるIDからはコピーしないでください。|
|外部ID| Amazonにハッシュマッチングを通じて以前に送信された外部ID。|
|MAID| モバイル広告識別子。|
|Amazon Cookie| クッキー同期を通じて取得したクッキー。|

## 統合戦略

Amazon DSPオーディエンスに訪問を追加する際のユーザー識別には、次の3つのオプションがあります：

* Cookie ID
* 外部ID
* MAID

使用するユーザー識別子によって、統合戦略が異なります。

### Cookie ID

Cookie ID識別子は、Amazonシステム内の第三者クッキーにマッチした第一者識別子であり、このCookie ID識別子を使用してブラウザレベルで匿名訪問をターゲットにすることができます。Amazon Advertising Cookie Matching Service TiQタグは簡単な統合を提供し、第一者の`tealium_visitor_id`をAmazonにマッチングするために渡します。

訪問または訪問レベルの属性を作成して、この`tealium_visitor_id`値を保持します。この属性はAmazon DSPコネクタにCookie IDとしてマッピングされます。

### 外部ID

外部IDは訪問の一意の識別子であり、最初にAmazon DSPシステムでハッシュ化されたPIIとマッチングされます。このIDは、顧客IDのようなクライアント所有の識別子や、`tealium_visitor_id`のようなTealium生成の識別子であることができます。識別子は訪問の存続期間中に持続し、デバイスごとに変更されるべきではありません。

**オーディエンスへの追加**アクションで外部IDを使用する前に、顧客は最初にIDとハッシュ化されたPIIをAmazonに送信する必要があります。これは**ハッシュレコードの追加**アクションを使用して行います。

以下の2つの例の実装は、ハッシュ化されたPIIとしてメールを使用し、メールアドレスが訪問スコープの属性でキャプチャされると仮定しています：

#### 顧客IDの例

以下の例は、`Customer ID`がクライアントのシステムによって構成された訪問スコープの属性であると仮定しています：

1. `Customer Email`と`Customer ID`の両方がプロファイルに存在するときに訪問が参加する**既知の顧客**オーディエンスを構成します。
1. 訪問が**既知の顧客**オーディエンスに参加するとトリガーされるAmazon DSPコネクタで**ハッシュレコードの追加**アクションを構成します。
1. このアクションでは、`Customer ID`を`外部ID`として、`Customer Email`をハッシュ化された識別子としてマッピングします。
1. コネクタのアクションは、ハッシュ化されたメールと顧客IDをAmazonに送信します。
1. その後、`Customer ID`値を使用して、訪問を**オーディエンスへの追加**コネクタアクションでオーディエンスに追加することができます。

#### Tealium訪問IDの例

1. 訪問スコープの属性`First Tealium VID`を構成し、訪問スコープの属性が構成されていない場合に`tealium_visitor_id`イベント属性をキャプチャします。
1. `First Tealium VID`と`Customer Email`が構成されているときに訪問が参加する**Amazon DSP**オーディエンスを作成します。
1. 訪問が**Amazon DSP**オーディエンスに参加するとトリガーされるAmazon DSPコネクタで**ハッシュレコードの追加**アクションを構成します。
このアクションでは、`First Tealium VID`を`外部ID`として、`Customer Email`をハッシュ化された識別子としてマッピングします。
1. `First Tealium VID`値を使用して、**オーディエンスへの追加**コネクタアクションを使用してAmazonオーディエンスに訪問を追加することができます。

### MAID

モバイル広告識別子（MAID）は、モバイル電話に紐づけられた一意の擬似匿名識別子です。Cookie IDと同様に、この識別子はデバイスベースであり、PIIに依存しません。MAID識別子を保持するための訪問レベルの属性を作成し、その後、ユーザー識別子として**オーディエンスへの追加**コネクタアクションで使用します。