Amazon Ads コンバージョンコネクタ構成ガイド

API 情報

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

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

コネクタのアクション

アクション名	AudienceStream	EventStream
コンバージョン送信	✓	✓

コネクタのヒント

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

構成の構成

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

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

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

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

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

広告プロファイル：
(必須) このコンバージョンの広告プロファイルを選択します。
コンバージョン定義名：
(必須) コンバージョン定義の名前。
ソースタイプ：
(必須) コンバージョンのソースタイプを選択します。利用可能なタイプには、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で、コンバージョン送信アクションでマッピングを通じて上書きすることができます。

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

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

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

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

amazon_event_id_{EVENT_NAME}_{TAG_UID}

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

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

{
  "amazon_event_id_checkout_32": "028b2ade7478..."
}

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

{
  "amazon_event_id_pageView_170": "084b1cda7461..."
}

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

Tealium 属性	Amazon パラメータ
`amazon_event_id_checkout_170` (属性)	Event ID
`"Checkout"` (カスタムテキスト)	Event Name

自動重複排除

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

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

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

アクション構成 — パラメータとオプション

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

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

アクション — コンバージョン送信

バッチ制限

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

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

パラメータ

パラメータ	説明
コンバージョン定義	コンバージョン定義を選択するか、定義の作成をクリックして新しい定義を作成します。

コンバージョンデータ

パラメータ	説明
国コード	(必須) イベントを実行するユーザーが位置する国のISO 3166-1 alpha-2形式のコード。
コンバージョン時間	コンバージョンのタイムスタンプをISO形式 (`YYYY-MM-DDThh:mm:ssTZD`) で。マッピングされていない場合、コネクタはイベント時間を使用します。
コンバージョン値	コンバージョンの値。
通貨	ISO 4217形式の通貨。`OFF_AMAZON_PURCHASES`タイプのコンバージョンにのみ適用されます。
販売単位	購入されたアイテムの数。`OFF_AMAZON_PURCHASES`タイプのコンバージョンにのみ適用されます。
重複排除ID	タグとコネクタの両方でコンバージョンを追跡している場合、重複排除IDを指定します。両方のイベントで値が一致する必要があります。

ユーザーデータ

パラメータ	説明
Email（既にSHA256ハッシュ化済み）	既に空白を削除し、小文字に変換し、SHA256でハッシュ化されたメールアドレスを提供してください。
Email（SHA256ハッシュを適用）	プレーンテキストのメールアドレスを提供し、コネクタが空白を削除し、小文字に変換し、SHA256ハッシュを使用してこの値をハッシュ化します。
Phone（既にSHA256ハッシュ化済み）	既に空白を削除し、小文字に変換し、SHA256でハッシュ化された電話番号を提供してください。
Phone（SHA256ハッシュを適用）	プレーンテキストの電話番号を提供し、コネクタが空白を削除し、小文字に変換し、SHA256ハッシュを使用してこの値をハッシュ化します。
First Name（既にSHA256ハッシュ化済み）	既に空白を削除し、小文字に変換し、SHA256でハッシュ化された名前を提供してください。
First Name（SHA256ハッシュを適用）	プレーンテキストの名前を提供し、コネクタが空白を削除し、小文字に変換し、SHA256ハッシュを使用してこの値をハッシュ化します。
Last Name（既にSHA256ハッシュ化済み）	既に空白を削除し、小文字に変換し、SHA256でハッシュ化された姓を提供してください。
Last Name（SHA256ハッシュを適用）	プレーンテキストの姓を提供し、コネクタが空白を削除し、小文字に変換し、SHA256ハッシュを使用してこの値をハッシュ化します。
Address（既にSHA256ハッシュ化済み）	既に空白を削除し、小文字に変換し、SHA256でハッシュ化された住所を提供してください。
Address（SHA256ハッシュを適用）	プレーンテキストの住所を提供し、コネクタが空白を削除し、小文字に変換し、SHA256ハッシュを使用してこの値をハッシュ化します。
City（既にSHA256ハッシュ化済み）	既に空白を削除し、小文字に変換し、SHA256でハッシュ化された市町村を提供してください。
City（SHA256ハッシュを適用）	プレーンテキストの市町村を提供し、コネクタが空白を削除し、小文字に変換し、SHA256ハッシュを使用してこの値をハッシュ化します。
State（既にSHA256ハッシュ化済み）	既に空白を削除し、小文字に変換し、SHA256でハッシュ化された州を提供してください。
State（SHA256ハッシュを適用）	プレーンテキストの州を提供し、コネクタが空白を削除し、小文字に変換し、SHA256ハッシュを使用してこの値をハッシュ化します。
Postal Code（既にSHA256ハッシュ化済み）	既に空白を削除し、小文字に変換し、SHA256でハッシュ化された郵便番号を提供してください。
Postal Code（SHA256ハッシュを適用）	プレーンテキストの郵便番号を提供し、コネクタが空白を削除し、小文字に変換し、SHA256ハッシュを使用してこの値をハッシュ化します。
MAID	モバイル識別子。有効な値は `MAID`, `ADID`, `IDFA`, `FIREADID` です。

自動重複排除

パラメータ	説明
自動重複排除	Tealium iQ タグ ID を入力し、Tealium が Tealium iQ から送信されたこのイベント ID を自動的に検索します。
タグ変換タイプ	自動重複排除を有効にする場合、タグデータと共に送信される以下の変換タイプのいずれかを選択します: `ADD_TO_SHOPPING_CART`, `APPLICATION`, `CHECKOUT`, `CONTACT`, `LEAD`, `OFF_AMAZON_PURCHASES`, `PAGE_VIEW`, `SEARCH`, `SIGN_UP`, `SUBSCRIBE`, `OTHER`。

マッピングオーバーライド

パラメータ	説明
広告主 ID	広告主の一意の識別子です。
ベース URL	Amazon Ads API のベース URL。
変換定義 ID	使用する変換定義の ID。

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