Amazon Ads オーディエンス管理コネクタ構成ガイド | サーバーサイドコネクター

Amazon Ads オーディエンス管理は、Amazon Marketing Cloud (AMC) 内でのオーディエンスのアップロード、管理、使用を効率化します。Amazon Ads オーディエンスコネクタを使用すると、オーディエンス管理サービスを通じてオーディエンスを作成およびアップロードし、Amazon DSP、AMC UI ワークフロー、または 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

コネクタアクション

アクション名	AudienceStream	EventStream
AMCオーディエンスへの訪問追加	✓	✓
DSPオーディエンスへの訪問追加	✓	✓
オーディエンスからの訪問削除	✓	✓

構成の構成

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

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

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オーディエンスへの訪問追加

パラメータ

パラメータ	説明
オーディエンスID	訪問を追加するオーディエンスID。オーディエンスの作成をクリックして新しいオーディエンスを作成します。オーディエンスの作成ダイアログで、ドロップダウンからAMC接続を選択します。オーディエンス名を入力します。説明フィールドにオーディエンスの説明を入力します。完了をクリックします。オーディエンスIDの確認をクリックして、オーディエンスIDを確認します。このコネクタで作成されたオーディエンスは、Amazonに送信される前にオーディエンス名に`Tealium:`のプレフィックスを付けます。
外部ユーザーID	Tealium訪問ID属性など、各訪問に固有であると分かっている非AmazonユーザーIDを選択します。
Email Address (already SHA256 hashed)	すでに空白トリム、小文字化、SHA256ハッシュ化されたメールアドレスを提供します。
Email Address (apply SHA256 hash)	プレーンテキストのメールアドレスを提供し、コネクタがこの値を空白トリム、小文字化し、SHA256ハッシュを適用します。
Phone Number (already SHA256 hashed)	すでに空白トリムおよびSHA256ハッシュ化された電話番号を提供します。
Phone Number (apply SHA256 hash)	プレーンテキストの電話番号を提供し、コネクタがこの値を空白トリムし、SHA256ハッシュを適用します。
First Name (already SHA256 hashed)	すでに空白トリム、小文字化、SHA256ハッシュ化された名前を提供します。
First Name (apply SHA256 hash)	プレーンテキストの名前を提供し、コネクタがこの値を空白トリム、小文字化し、SHA256ハッシュを適用します。
Last Name (already SHA256 hashed)	すでに空白トリム、小文字化、SHA256ハッシュ化された姓を提供します。
Last Name (apply SHA256 hash)	プレーンテキストの姓を提供し、コネクタがこの値を空白トリム、小文字化し、SHA256ハッシュを適用します。
City (already SHA256 hashed)	すでに空白トリム、小文字化、SHA256ハッシュ化された市を提供します。
City (apply SHA256 hash)	プレーンテキストの市を提供し、コネクタがこの値を空白トリム、小文字化し、SHA256ハッシュを適用します。
State (already SHA256 hashed)	すでに空白トリム、小文字化、SHA256ハッシュ化された州を提供します。
State (apply SHA256 hash)	プレーンテキストの州を提供し、コネクタがこの値を空白トリム、小文字化し、SHA256ハッシュを適用します。
Postal Code (already SHA256 hashed)	すでに空白トリム、小文字化、SHA256ハッシュ化された郵便番号を提供します。
Postal Code (apply SHA256 hash)	プレーンテキストの郵便番号を提供し、コネクタがこの値を空白トリム、小文字化し、SHA256ハッシュを適用します。
External ID (apply SHA256 hash)	外部ユーザーIDにSHA256ハッシュを適用するためにこのチェックボックスを選択します。
国コード	データが収集された国を示すISO 3166形式の2文字の文字列を提供します。レコードに追加された国コードは、オーディエンスに追加された国コードを上書きします。

同意

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

アクション — DSPオーディエンスへの訪問追加

パラメータ

パラメータ	説明
Audience ID	訪問を追加するAudience ID。 Create Audienceをクリックして新しいオーディエンスを作成します。 Create Audienceダイアログで、ドロップダウンからDSP Advertiserを選択します。 Audience Nameを入力します。 Descriptionフィールドにオーディエンスの説明を入力します。 Data Source Countryを入力します。これはデジタル市場法（DMA）に関連するフィールドで、オーディエンスのユーザーデータが収集された場所を表します。構成されていない場合はデフォルト値UNKNOWNが適用されます。 Doneをクリックします。 Verify Audience IDをクリックしてオーディエンスIDを確認します。このコネクタで作成されたオーディエンスは、Amazonに送信される前にオーディエンス名に`Tealium:`のプレフィックスが付けられます。
External User ID	Amazon以外のユーザーIDを選択します。例えば、Tealium訪問ID属性や、訪問ごとに一意であると知られている他の内部顧客IDなどです。
Email Address (already SHA256 hashed)	すでに空白をトリムし、小文字に変換し、SHA256でハッシュ化されたメールアドレスを提供します。
Email Address (apply SHA256 hash)	プレーンテキストのメールアドレスを提供し、コネクタがこの値を空白トリムし、小文字に変換し、SHA256ハッシュを使用してハッシュ化します。
Phone Number (already SHA256 hashed)	すでに空白をトリムし、SHA256でハッシュ化された電話番号を提供します。
Phone Number (apply SHA256 hash)	プレーンテキストの電話番号を提供し、コネクタがこの値を空白トリムし、ハッシュ化します。
First Name (already SHA256 hashed)	すでに空白をトリムし、小文字に変換し、SHA256でハッシュ化された名前を提供します。
First Name (apply SHA256 hash)	プレーンテキストの名前を提供し、コネクタがこの値を空白トリムし、小文字に変換し、ハッシュ化します。
Last Name (already SHA256 hashed)	すでに空白をトリムし、小文字に変換し、SHA256でハッシュ化された姓を提供します。
Last Name (apply SHA256 hash)	プレーンテキストの姓を提供し、コネクタがこの値を空白トリムし、小文字に変換し、ハッシュ化します。
City (already SHA256 hashed)	すでに空白をトリムし、小文字に変換し、SHA256でハッシュ化された市名を提供します。
City (apply SHA256 hash)	プレーンテキストの市名を提供し、コネクタがこの値を空白トリムし、小文字に変換し、ハッシュ化します。
State (already SHA256 hashed)	すでに空白をトリムし、小文字に変換し、SHA256でハッシュ化された州名を提供します。
State (apply SHA256 hash)	プレーンテキストの州名を提供し、コネクタがこの値を空白トリムし、小文字に変換し、ハッシュ化します。
Postal Code (already SHA256 hashed)	すでに空白をトリムし、小文字に変換し、SHA256でハッシュ化された郵便番号を提供します。
Postal Code (apply SHA256 hash)	プレーンテキストの郵便番号を提供し、コネクタがこの値を空白トリムし、小文字に変換し、ハッシュ化します。
External ID (apply SHA256 hash)	External User IDにSHA256ハッシュを適用するためにこのチェックボックスを選択します。
Country Code	データが収集された国を示すISO 3166形式の2文字の文字列を提供します。レコードに追加された国コードは、オーディエンスに追加された国コードを上書きします。

同意

Add Visitor to DSP Audienceアクションを使用する際、コネクタはamznAdStorageおよびamznUserDataパラメータに対してGRANTEDの値を送信します。同意を与えていない訪問をリストに追加しないために、訪問プロファイルの同意状態をチェックするルールを持つオーディエンスを作成します。その後、Remove Visitor from Audienceアクションを使用して、同意を与えていない訪問をリストから削除します。

アクション — Remove Visitor from Audience

パラメータ

パラメータ	説明
Audience ID	既存のTealium作成のAmazonオーディエンスを使用する場合、そのIDを入力し、Verify Audience IDをクリックしてオーディエンスが正しいことを確認します。Add to Audienceアクションの構成で作成されたオーディエンスIDをコピーすることができます。
External User ID	Amazon以外のユーザーIDを選択します。例えば、Tealium訪問ID属性や、訪問ごとに一意であると知られている他の内部顧客IDなどです。
Email Address (already SHA256 hashed)	すでに空白をトリムし、小文字に変換し、SHA256でハッシュ化されたメールアドレスを提供します。
Email Address (apply SHA256 hash)	プレーンテキストのメールアドレスを提供し、コネクタがこの値を空白トリムし、小文字に変換し、SHA256ハッシュを使用してハッシュ化します。
Phone Number (already SHA256 hashed)	すでに空白をトリムし、SHA256でハッシュ化された電話番号を提供します。
Phone Number (apply SHA256 hash)	プレーンテキストの電話番号を提供し、コネクタがこの値を空白トリムし、ハッシュ化します。
First Name (already SHA256 hashed)	すでに空白をトリムし、小文字に変換し、SHA256でハッシュ化された名前を提供します。
First Name (apply SHA256 hash)	プレーンテキストの名前を提供し、コネクタがこの値を空白トリムし、小文字に変換し、ハッシュ化します。
Last Name (already SHA256 hashed)	すでに空白をトリムし、小文字に変換し、SHA256でハッシュ化された姓を提供します。
Last Name (apply SHA256 hash)	プレーンテキストの姓を提供し、コネクタがこの値を空白トリムし、小文字に変換し、ハッシュ化します。
City (already SHA256 hashed)	すでに空白をトリムし、小文字に変換し、SHA256でハッシュ化された市名を提供します。
City (apply SHA256 hash)	プレーンテキストの市名を提供し、コネクタがこの値を空白トリムし、小文字に変換し、ハッシュ化します。
State (already SHA256 hashed)	すでに空白をトリムし、小文字に変換し、SHA256でハッシュ化された州名を提供します。
State (apply SHA256 hash)	プレーンテキストの州名を提供し、コネクタがこの値を空白トリムし、小文字に変換し、ハッシュ化します。
Postal Code (already SHA256 hashed)	すでに空白をトリムし、小文字に変換し、SHA256でハッシュ化された郵便番号を提供します。
Postal Code (apply SHA256 hash)	プレーンテキストの郵便番号を提供し、コネクタがこの値を空白トリムし、小文字に変換し、ハッシュ化します。