Amazon Ads Conversions コネクタ構成ガイド

API情報

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

• API名：Amazon Ads API
• APIバージョン：v1.0
• APIエンドポイント：https://advertising-api.amazon.com
• ドキュメント：Amazon API
• タグドキュメント：Amazon Advertising Tag

コネクタのヒント

タグとコネクタを使用したハイブリッド構成を推奨します。この構成により、データの耐久性が最大化され、サーバーサイドのシグナルとのイベントマッチングが向上し、リアルタイムのクライアントサイドシグナルを保持しながらデータフローの連続性が維持されます。

構成

コネクタマーケットプレイスにアクセスし、新しいコネクタを追加します。コネクタの追加方法については、About Connectorsを参照してください。

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

• APIベースURL：（必須）APIベースURLを選択します。
• Amazon広告主ID：（必須）Amazon広告アカウントIDを入力します。

コンバージョン定義の作成

コンバージョン定義を作成するには、Create Conversion Definitionをクリックし、以下の情報を提供します：

• 広告プロファイル：（必須）このコンバージョンの広告プロファイルを選択します。
• コンバージョン定義名：（必須）コンバージョン定義の名前。
• ソースタイプ：（必須）コンバージョンのソースタイプを選択します。利用可能なタイプは、ADD_TO_SHOPPING_CART、APPLICATION、CHECKOUT、CONTACT、LEAD、OFF_AMAZON_PURCHASES、PAGE_VIEW、SEARCH、SIGN_UP、SUBSCRIBE、OTHERです。
• コンバージョンタイプ：（必須）コンバージョンのタイプを選択します。利用可能なタイプは、ANDROID、FIRE_TV、IOS、OFFLINE、WEBSITEです。
• カウント方法：（必須）コンバージョン定義のために、24時間のウィンドウ内でユーザーごとにすべてのコンバージョンイベントを使用するか、最初のイベントのみを使用するかを決定する方法を選択します。利用可能な方法は、EVERYとFIRSTです。
• コンバージョン値：（オプション）コンバージョンの値。デフォルト値は1で、Send Conversionアクションでマッピングを通じて上書きすることができます。

コンバージョン定義を保存するには、Doneをクリックします。

広告データマネージャコンソールのコンバージョンページまたはTerms API（POST /adm/terms）を使用して、利用規約を必ず受け入れてください。

ウェブイベントの重複排除

このコネクタを構成して、Amazon Ads Serverタグからのイベントの重複を排除するには、次の命名規則でイベントIDをイベント属性として送信します：

amazon_event_id_{EVENT_NAME}_{TAG_UID}

タグのUIDは、Tealium iQのTagsテーブルまたはタグの詳細画面で見つけることができます：

たとえば、UIDが170のタグからのチェックアウトイベントは、次の属性値を送信します：

{
  "amazon_event_id_checkout_170": "028b2ade7478..."
}

同じタグからのページビューイベントは、次の属性と値を送信します：

{
  "amazon_event_id_pageView_170": "028b2ade7478..."
}

各タイプのイベントに対して別のアクションを使用します。イベント固有のイベントID属性をEvent IDにマッピングし、一致するイベント名をEvent Nameにマッピングします。たとえば：

自動重複排除

Automatic Deduplication値が入力されている場合、コネクタは対応するイベントID属性を探します。このセクションが入力されていてTealium iQを使用している場合、Event IDを追加する必要はありません。ただし、Tealium iQを使用せずにEventStreamを使用している場合は、次のアプローチが必要になる場合があります。

コネクタは次の操作順序に従います：

• Automatic Deduplicationが入力され、値がデータレイヤーで見つかった場合（例：amazon_event_id_checkout_170）、この値はEvent IDでマッピングされたものより優先されます。
• Automatic Deduplicationが入力されているが値が見つからない場合、Event IDが入力されている場合はそれが使用されます。

アクション

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

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

Send Conversion

バッチ制限

このアクションはバッチリクエストを使用して、ベンダーへの大量データ転送をサポートします。並行処理により、イベントがベンダーに順不同で到達する可能性があります。イベントの順序が重要な場合は、イベントにシーケンス値を追加します。詳細については、Batched Actionsを参照してください。次のいずれかの閾値が満たされるか、プロファイルが公開されるまでリクエストはキューに入れられます：

• 最大リクエスト数：500
• 最古のリクエストからの最大時間：10分
• リクエストの最大サイズ：1 MB

パラメータ

コンバージョンデータ

ユーザーデータ

同意

自動重複排除

マッピングの上書き

ハッシングのためのオーディエンスファイルのフォーマットと正規化要件についての詳細は、Format audience file for hashingを参照してください。

送信変換（非推奨）

このアクションは現在非推奨となっており、新たに追加することはできません。現在のアクションについては、Send Conversionを参照してください。

バッチ制限

このアクションはバッチリクエストを使用して、ベンダーへの大量データ転送をサポートします。並行処理により、イベントがベンダーに順不同で到達する可能性があります。順序が重要な場合は、イベントにシーケンス値を追加してください。詳細については、Batched Actionsを参照してください。次のいずれかの閾値に達するか、プロファイルが公開されるまでリクエストはキューに入れられます：

• 最大リクエスト数：100
• 最古のリクエストからの最大時間：10分
• リクエストの最大サイズ：1 MB

パラメータ

変換データ

ユーザーデータ

自動重複排除

マッピングの上書き

書式構成と正規化の要件についての詳細は、ハッシュ用のオーディエンスファイルの形式を整えるを参照してください。