Amazon Ads Audience Managementコネクタ構成ガイド

Amazon Ads Audience Managementを使用すると、Amazon Marketing Cloud（AMC）内でのオーディエンスのアップロード、管理、利用を効率化できます。Amazon Ads Audienceコネクタを使用して、Audience Management Serviceを通じてオーディエンスを作成し、アップロードします。これらのオーディエンスは、Amazon DSP、AMCユーザーインターフェイスのワークフロー、またはAMCルールベースオーディエンスなどのAPIアクションを通じた後続アクションに使用できるようになります。

このコネクタでは、訪問をAMCまたはDSPのオーディエンスに追加できます。AMCオーディエンスの場合は、構成プロセス中にAMC接続を作成する必要があります。DSPオーディエンスの場合は、DSPオーディエンスを作成する際に広告主IDを選択する必要があります。

API情報

このコネクタでは、次のベンダーAPIを使用します。

API名：Amazon Ads API
APIバージョン：v1.0
APIエンドポイント：https://advertising-api.amazon.com

バッチ処理の上限

このコネクタでは、ベンダーへの大量のデータ転送に対応するため、リクエストをバッチ処理します。詳細については、バッチアクションを参照してください。次のいずれかのしきい値に達するか、プロファイルがパブリッシュされるまで、リクエストはキューに保持されます。

リクエストの最大数：6,000
最も古いリクエストからの最大経過時間：60分
リクエストの最大サイズ：1 MB

構成

コネクタマーケットプレイスに移動し、新しいコネクタを追加します。詳細については、コネクタについてを参照してください。

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

Amazon Adsアカウントのリージョン
- （必須）Amazon Adsアカウントのリージョンを選択します。

Amazon認証

Amazonでコネクタを認証するには、次の手順を実行します。

Amazon Adsアカウントのリージョンリストからリージョンを選択します。
接続を確立をクリックします。
Amazonのサインインダイアログで、Amazonの認証情報を入力します。

AMCオーディエンス接続

AMCオーディエンスを構成するには、接続オブジェクトが必要です。Amazonでは、AMCインスタンスとDSPオーディエンスのマッピングを格納するオブジェクトに接続を保存します。

AmazonとのAMC接続を確立するには、次の手順を実行します。

AMC接続を作成をクリックします。
AMC接続を作成ダイアログのAMCインスタンスリストで、オーディエンスのアップロードに使用するAMCインスタンスを選択します。
（任意）オーディエンスをDSPと同期するには、DSP広告主IDリストでDSP広告主IDを選択または入力します。
完了をクリックし、次に作成をクリックします。

国コード

国コードは、データが収集された国を示すISO 3166形式の2文字の文字列です。国コードは任意のパラメータですが、データをアップロードする際に含めることを強く推奨します。レコードに追加された国コードは、オーディエンスに追加された国コードを上書きします。

詳細については、Amazon Ads：国コードを参照してください。

アクション

アクション名	訪問プロファイル	イベントデータ
AMCオーディエンスに訪問を追加	✓	✓
DSPオーディエンスに訪問を追加	✓	✓
オーディエンスから訪問を削除	✓	✓

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

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

AMCオーディエンスに訪問を追加

パラメータ

パラメータ	説明
オーディエンスID	訪問を追加するオーディエンスIDです。新しいオーディエンスを作成するには、オーディエンスを作成をクリックします。オーディエンスを作成画面で、リストからAMC接続を選択します。オーディエンス名を入力します。説明フィールドにオーディエンスの説明を入力します。国コードを入力します。これは、オーディエンス内のユーザーデータが収集された場所を表すISO 3166形式の2文字の文字列です。構成されていない場合は、デフォルト値のUNKNOWNが適用されます。完了をクリックします。オーディエンスIDを検証をクリックして、オーディエンスIDを検証します。このコネクタで作成したオーディエンスは、Amazonに送信される前に、オーディエンス名の先頭にプレフィックス`Tealium:`がエンリッチメントされます。
AMC接続	（必須）AMC接続を選択します。必要に応じて、コネクタ構成画面で新しい接続を作成します。接続IDは、オーディエンスの作成時に使用したものと一致している必要があります。
外部ユーザーID	Tealiumの訪問ID属性など、Amazon以外のユーザーID、または訪問ごとに一意であることが確認されている別の内部顧客IDを選択します。
外部ID（SHA256ハッシュを適用）	外部ユーザーIDにSHA256ハッシュを適用するには、このチェックボックスをオンにします。
国コード	データが収集された国を示すISO 3166形式の2文字の文字列を指定します。レコードに追加された国コードは、オーディエンスに追加された国コードを上書きします。

ユーザー識別子

パラメータ	説明
メールアドレス（SHA256でハッシュ化済み）	前後の空白が削除され、小文字に変換され、SHA256でハッシュ化済みのメールアドレスを指定します。
メールアドレス（SHA256ハッシュを適用）	プレーンテキストのメールアドレスを指定します。コネクタは、この値の前後の空白を削除し、小文字に変換して、SHA256でハッシュ化します。
電話番号（SHA256でハッシュ化済み）	前後の空白が削除され、SHA256でハッシュ化済みの電話番号を指定します。
電話番号（SHA256ハッシュを適用）	プレーンテキストの電話番号を指定します。コネクタは、この値の前後の空白を削除し、SHA256でハッシュ化します。
名（SHA256でハッシュ化済み）	前後の空白が削除され、小文字に変換され、SHA256でハッシュ化済みの名を指定します。
名（SHA256ハッシュを適用）	プレーンテキストの名を指定します。コネクタは、この値の前後の空白を削除し、小文字に変換して、SHA256でハッシュ化します。
姓（SHA256でハッシュ化済み）	前後の空白が削除され、小文字に変換され、SHA256でハッシュ化済みの姓を指定します。
姓（SHA256ハッシュを適用）	プレーンテキストの姓を指定します。コネクタは、この値の前後の空白を削除し、小文字に変換して、SHA256でハッシュ化します。
市区町村（SHA256でハッシュ化済み）	前後の空白が削除され、小文字に変換され、SHA256でハッシュ化済みの市区町村を指定します。
市区町村（SHA256ハッシュを適用）	プレーンテキストの市区町村を指定します。コネクタは、この値の前後の空白を削除し、小文字に変換して、SHA256でハッシュ化します。
州（SHA256でハッシュ化済み）	前後の空白が削除され、小文字に変換され、SHA256でハッシュ化済みの州を指定します。
州（SHA256ハッシュを適用）	プレーンテキストの州を指定します。コネクタは、この値の前後の空白を削除し、小文字に変換して、SHA256でハッシュ化します。
郵便番号（SHA256でハッシュ化済み）	前後の空白が削除され、小文字に変換され、SHA256でハッシュ化済みの郵便番号を指定します。
郵便番号（SHA256ハッシュを適用）	プレーンテキストの郵便番号を指定します。コネクタは、この値の前後の空白を削除し、小文字に変換して、SHA256でハッシュ化します。

同意

AMCオーディエンスに訪問を追加アクションを使用すると、コネクタはamznAdStorageパラメータとamznUserDataパラメータに値GRANTEDを送信します。同意していない訪問がリストに追加されないようにするには、訪問プロファイルの同意ステータスを確認するルールを使用してオーディエンスを作成します。次に、オーディエンスから訪問を削除アクションを使用して、同意していない訪問をリストから削除します。

DSPオーディエンスに訪問を追加

パラメータ

パラメータ	説明
オーディエンス ID	訪問を追加するオーディエンスの ID。新しいオーディエンスを作成するには、オーディエンスを作成をクリックします。オーディエンスを作成画面で、リストから DSP 広告主を選択するか入力します。オーディエンス名を入力します。説明フィールドにオーディエンスの説明を入力します。国コードを入力します。これは、オーディエンス内のユーザーデータが収集された国を示す、ISO 3166 形式の 2 文字の文字列です。構成されていない場合は、デフォルト値の UNKNOWN が適用されます。完了をクリックします。オーディエンス ID を確認をクリックして、オーディエンス ID を確認します。このコネクタで作成したオーディエンスは、Amazon に送信される前に、オーディエンス名の先頭にプレフィックス `Tealium:` がエンリッチメントされます。
外部ユーザー ID	Tealium の訪問 ID 属性などの Amazon 以外のユーザー ID、または訪問ごとに一意であることがわかっている別の内部顧客 ID を選択します。
外部 ID（SHA256 ハッシュを適用）	外部ユーザー ID に SHA256 ハッシュを適用するには、このチェックボックスを選択します。

ユーザー識別子

パラメータ	説明
メールアドレス（SHA256 ハッシュ化済み）	前後の空白が除去され、小文字に変換され、SHA256 でハッシュ化済みのメールアドレスを指定します。
メールアドレス（SHA256 ハッシュを適用）	プレーンテキストのメールアドレスを指定すると、コネクタが前後の空白を除去し、小文字に変換して、SHA256 でハッシュ化します。
電話番号（SHA256 ハッシュ化済み）	前後の空白が除去され、SHA256 でハッシュ化済みの電話番号を指定します。
電話番号（SHA256 ハッシュを適用）	プレーンテキストの電話番号を指定すると、コネクタが前後の空白を除去し、SHA256 でハッシュ化します。
名（SHA256 ハッシュ化済み）	前後の空白が除去され、小文字に変換され、SHA256 でハッシュ化済みの名を指定します。
名（SHA256 ハッシュを適用）	プレーンテキストの名を指定すると、コネクタが前後の空白を除去し、小文字に変換して、SHA256 でハッシュ化します。
姓（SHA256 ハッシュ化済み）	前後の空白が除去され、小文字に変換され、SHA256 でハッシュ化済みの姓を指定します。
姓（SHA256 ハッシュを適用）	プレーンテキストの姓を指定すると、コネクタが前後の空白を除去し、小文字に変換して、SHA256 でハッシュ化します。
市区町村（SHA256 ハッシュ化済み）	前後の空白が除去され、小文字に変換され、SHA256 でハッシュ化済みの市区町村を指定します。
市区町村（SHA256 ハッシュを適用）	プレーンテキストの市区町村を指定すると、コネクタが前後の空白を除去し、小文字に変換して、SHA256 でハッシュ化します。
州（SHA256 ハッシュ化済み）	前後の空白が除去され、小文字に変換され、SHA256 でハッシュ化済みの州を指定します。
州（SHA256 ハッシュを適用）	プレーンテキストの州を指定すると、コネクタが前後の空白を除去し、小文字に変換して、SHA256 でハッシュ化します。
郵便番号（SHA256 ハッシュ化済み）	前後の空白が除去され、小文字に変換され、SHA256 でハッシュ化済みの郵便番号を指定します。
郵便番号（SHA256 ハッシュを適用）	プレーンテキストの郵便番号を指定すると、コネクタが前後の空白を除去し、小文字に変換して、SHA256 でハッシュ化します。
国コード	データが収集された国を示す、ISO 3166 形式の 2 文字の文字列を指定します。レコードに追加された国コードは、オーディエンスに追加された国コードより優先されます。

同意

訪問を DSP オーディエンスに追加アクションを使用すると、コネクタは amznAdStorage および amznUserData パラメータの値として GRANTED を送信します。同意していない訪問がリストに追加されるのを防ぐには、訪問プロファイルの同意ステータスを確認するルールを使用してオーディエンスを作成します。その後、オーディエンスから訪問を削除アクションを使用して、同意していない訪問をリストから削除します。

オーディエンスから訪問を削除

パラメータ

パラメータ	説明
オーディエンス ID	Tealium で作成済みの Amazon オーディエンスを使用するには、その ID を入力し、オーディエンス ID を確認をクリックして、オーディエンスが正しいことを確認します。オーディエンスに追加アクションの構成で作成されたオーディエンス ID をコピーできます。
AMC 接続	（必須）AMC 接続を選択します。必要に応じて、コネクタの構成画面で新しい接続を作成します。接続 ID は、オーディエンスの作成時に使用したものと一致している必要があります。
外部ユーザー ID	Tealium の訪問 ID 属性などの Amazon 以外のユーザー ID、または訪問ごとに一意であることがわかっている別の内部顧客 ID を選択します。

ユーザー識別子

パラメータ	説明
メールアドレス（SHA256 ハッシュ化済み）	前後の空白が除去され、小文字に変換され、SHA256 でハッシュ化済みのメールアドレスを指定します。
メールアドレス（SHA256 ハッシュを適用）	プレーンテキストのメールアドレスを指定すると、コネクタが前後の空白を除去し、小文字に変換して、SHA256 でハッシュ化します。
電話番号（SHA256 ハッシュ化済み）	前後の空白が除去され、SHA256 でハッシュ化済みの電話番号を指定します。
電話番号（SHA256 ハッシュを適用）	プレーンテキストの電話番号を指定すると、コネクタが前後の空白を除去し、SHA256 でハッシュ化します。
名（SHA256 ハッシュ化済み）	前後の空白が除去され、小文字に変換され、SHA256 でハッシュ化済みの名を指定します。
名（SHA256 ハッシュを適用）	プレーンテキストの名を指定すると、コネクタが前後の空白を除去し、小文字に変換して、SHA256 でハッシュ化します。
姓（SHA256 ハッシュ化済み）	前後の空白が除去され、小文字に変換され、SHA256 でハッシュ化済みの姓を指定します。
姓（SHA256 ハッシュを適用）	プレーンテキストの姓を指定すると、コネクタが前後の空白を除去し、小文字に変換して、SHA256 でハッシュ化します。
市区町村（SHA256 ハッシュ化済み）	前後の空白が除去され、小文字に変換され、SHA256 でハッシュ化済みの市区町村を指定します。
市区町村（SHA256 ハッシュを適用）	プレーンテキストの市区町村を指定すると、コネクタが前後の空白を除去し、小文字に変換して、SHA256 でハッシュ化します。
州（SHA256 ハッシュ化済み）	前後の空白が除去され、小文字に変換され、SHA256 でハッシュ化済みの州を指定します。
州（SHA256 ハッシュを適用）	プレーンテキストの州を指定すると、コネクタが前後の空白を除去し、小文字に変換して、SHA256 でハッシュ化します。
郵便番号（SHA256 ハッシュ化済み）	前後の空白が除去され、小文字に変換され、SHA256 でハッシュ化済みの郵便番号を指定します。
郵便番号（SHA256 ハッシュを適用）	プレーンテキストの郵便番号を指定すると、コネクタが前後の空白を除去し、小文字に変換して、SHA256 でハッシュ化します。