Amazon Ads Audience Management Connector Setup Guide | サーバーサイドコネクタ

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

バッチ制限

このコネクタは、ベンダーへの高容量データ転送をサポートするためにバッチリクエストを使用します。リクエストは、次のいずれかの閾値に達するまでキューに入れられます：

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

コネクタアクション

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

構成の構成

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

Amazon認証

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

APIベースURLのドロップダウンで、APIベースURLを選択します。
接続の確立をクリックします。Amazonのサインインダイアログが表示されます。
Amazonの資格情報でサインインします。

AMCオーディエンス接続

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

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

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

アクション構成 — アクション

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

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

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

パラメータ

パラメータ	説明
オーディエンスID	訪問を追加するオーディエンスのID。オーディエンスの作成をクリックして新しいオーディエンスを作成します。ドロップダウンからAMC接続を選択します。オーディエンス名を入力します。説明フィールドにオーディエンスの説明を入力します。外部オーディエンスIDを入力します。完了をクリックします。オーディエンス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広告主を選択します。オーディエンス名を入力します。説明フィールドにオーディエンスの説明を入力します。外部オーディエンスIDを入力します。完了をクリックします。オーディエンス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ハッシュを使用してこの値をハッシュ化します。