Amazon Ads Audience Management コネクタ構成ガイド
この記事では、Amazon Ads Audience Managementコネクタの構成方法について説明します。
Amazon Ads Audience Managementは、Amazon Marketing Cloud (AMC)内のオーディエンスのアップロード、管理、使用を効率化します。Amazon Ads Audienceコネクタを使用すると、Amazon DSP、AMC UIワークフロー、またはAPIアクション(例:AMCルールベースのオーディエンス)を通じて後続のアクションが可能なオーディエンスを、Audience Management Serviceを通じて作成およびアップロードできます。
このコネクタは、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広告主IDドロップダウンからDSP広告主IDを選択し、オーディエンスをDSPに同期します。
- 完了をクリックし、次に作成をクリックします。
国コード
国コードは、データが収集された国を示すISO 3166形式の2文字の文字列です。国コードはオプションのパラメーターですが、データをアップロードする際には含めることを強く推奨します。レコードに追加された国コードは、オーディエンスに追加された国コードを上書きします。
詳細については、Amazon Ads:国コードを参照してください。
アクション構成 — アクション
アクションの名前を入力し、ドロップダウンメニューからアクションタイプを選択します。
以下のセクションでは、各アクションのパラメーターとオプションの構成方法について説明します。
アクション — AMCオーディエンスに訪問を追加
パラメーター
パラメーター | 説明 |
---|---|
オーディエンスID | 訪問を追加するオーディエンスID。
Tealium: というプレフィックスを付けます。 |
外部ユーザー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ハッシュを使用してハッシュ化します。 |
国コード | データが収集された国を示すISO 3166形式の2文字の文字列を提供します。レコードに追加された国コードは、オーディエンスに追加された国コードを上書きします。 |
同意
AMCオーディエンスに訪問を追加アクションを使用すると、コネクタはamznAdStorage
とamznUserData
パラメーターに対してGRANTED
の値を送信します。同意を与えていない訪問がリストに追加されるのを防ぐために、訪問プロファイルの同意ステータスをチェックするルールを持つオーディエンスを作成します。その後、オーディエンスから訪問を削除アクションを使用して、同意を与えていない訪問をリストから削除します。
アクション — DSPオーディエンスに訪問を追加
パラメーター
パラメーター | 説明 |
---|---|
オーディエンスID | 訪問を追加するオーディエンスID。
Tealium: というプレフィックスを付けます。 |
外部ユーザー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ハッシュを使用してハッシュ化します。 |
国コード | データが収集された国を示すISO 3166形式の2文字の文字列を提供します。レコードに追加された国コードは、オーディエンスに追加された国コードを上書きします。 |
同意
Add Visitor to DSP Audienceアクションを使用すると、コネクタはamznAdStorage
およびamznUserData
パラメータに対して値GRANTED
を送信します。同意を得ていない訪問がリストに追加されるのを防ぐために、訪問プロファイルの同意ステータスをチェックするルールを持つオーディエンスを作成します。その後、Remove Visitor from Audienceアクションを使用して、同意を得ていない訪問をリストから削除します。
アクション - オーディエンスから訪問を削除
パラメータ
パラメータ | 説明 |
---|---|
オーディエンスID | 既存のTealium作成のAmazonオーディエンスを使用するには、そのIDを入力し、Verify Audience IDをクリックしてオーディエンスが正しいことを確認します。Add to Audienceアクションの構成で作成されたオーディエンス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ハッシュを使用してハッシュ化します。 |
最終更新日 :: 2025年February月13日