Amazon Adsオーディエンス管理コネクタのセットアップガイド | サーバーサイドコネクタ

Amazon Adsオーディエンス管理は、Amazon Marketing Cloud（AMC）内でのオーディエンスのアップロード、管理、使用を効率化します。Amazon Adsオーディエンスコネクタを使用すると、Amazon DSP、AMC UIワークフロー、またはAMCルールベースのオーディエンスなど、さまざまなアクションの対象となるオーディエンスを作成およびアップロードできます。

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

API情報

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

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

バッチ制限

このコネクタは、ベンダーへの高容量データ転送をサポートするためにバッチリクエストを使用します。詳細については、バッチアクションを参照してください。リクエストは、次のいずれかの閾値が満たされるか、プロファイルが公開されるまでキューに入れられます：

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

コネクタアクション

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

設定の構成

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

Amazon認証

コネクタをAmazonと認証するには：

Amazon Ads Account Regionドロップダウンから地域を選択します。
接続の確立をクリックします。
Amazonのサインインダイアログで、Amazonの資格情報を入力します。

AMCオーディエンス接続

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

AmazonとAMCの接続を確立するには：

AMC接続の作成をクリックします。
AMC接続の作成ダイアログで、オーディエンスのアップロードに使用するAMCインスタンスをAMCインスタンスドロップダウンで選択します。
（オプション）DSP広告主IDドロップダウンからDSP広告主IDを選択して、オーディエンスをDSPに同期します。
完了をクリックし、作成をクリックします。

アクション設定 — アクション

アクションの名前を入力し、ドロップダウンメニューからアクションタイプを選択します。

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

アクション — AMCオーディエンスに訪問者を追加

パラメータ

パラメータ	説明
オーディエンスID	訪問者を追加するオーディエンスのID。オーディエンスの作成をクリックして新しいオーディエンスを作成します。オーディエンスの作成ダイアログで、ドロップダウンからAMC接続を選択します。オーディエンス名を入力します。説明フィールドにオーディエンスの説明を入力します。完了をクリックします。オーディエンスIDの検証をクリックしてオーディエンスIDを検証します。このコネクタで作成するオーディエンスは、Amazonに送信される前にオーディエンス名の接頭辞に`Tealium:`が付けられます。
外部ユーザーID	Amazon以外のユーザー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ハッシュを使用してハッシュ化します。

アクション — DSPオーディエンスに訪問者を追加

パラメータ

パラメータ	説明
オーディエンスID	訪問者を追加するオーディエンスのID。オーディエンスの作成をクリックして新しいオーディエンスを作成します。オーディエンスの作成ダイアログで、ドロップダウンからDSP広告主を選択します。オーディエンス名を入力します。説明フィールドにオーディエンスの説明を入力します。データソースの国を入力します。これは、オーディエンスのユーザーデータが収集された場所を表すDigital Markets Act（DMA）関連のフィールドです。設定されていない場合は、デフォルト値UNKNOWNが適用されます。完了をクリックします。オーディエンスIDの検証をクリックしてオーディエンスIDを検証します。このコネクタで作成するオーディエンスは、Amazonに送信される前にオーディエンス名の接頭辞に`Tealium:`が付けられます。
外部ユーザーID	Amazon以外のユーザー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ハッシュを使用してハッシュ化します。

アクション — オーディエンスから訪問者を削除

パラメータ

パラメータ	説明
オーディエンスID	既存のTealiumが作成したAmazonオーディエンスを使用する場合は、そのIDを入力し、オーディエンスIDの検証をクリックしてオーディエンスが正しいことを確認します。オーディエンスに追加アクションの構成で作成したオーディエンスIDをコピーできます。
外部ユーザーID	Amazon以外のユーザー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ハッシュを使用してハッシュ化します。