Amazon Ads Conversions コネクタ構成ガイド | サーバーサイドコネクター

API 情報

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

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

コネクタのアクション

アクション名	AudienceStream	EventStream
Send Conversion	✓	✓

コネクタのヒント

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

構成の構成

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

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

API Base URL：
(必須) API Base URL を選択します。
Amazon Advertiser ID：
(必須) Amazon Advertising アカウント ID を入力します。

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

このコネクタを使用するには、コンバージョン定義を作成する必要があります。Create Conversion Definition をクリックし、以下の情報を提供します：

Advertising Profile：
(必須) このコンバージョンの広告プロファイルを選択します。
Conversion Definition Name：
(必須) コンバージョン定義の名前。
Source Type：
(必須) コンバージョンのソースタイプを選択します。利用可能なタイプには、ADD_TO_SHOPPING_CART, APPLICATION, CHECKOUT, CONTACT, LEAD, OFF_AMAZON_PURCHASES, PAGE_VIEW, SEARCH, SIGN_UP, SUBSCRIBE, OTHER があります。
Conversion Type： (必須) コンバージョンのタイプを選択します。利用可能なタイプには、ANDROID, FIRE_TV, IOS, OFFLINE, WEBSITE があります。
Counting Method：
(必須) コンバージョン定義において、24時間のウィンドウ内でユーザーによって取り込まれた最初のコンバージョンイベントのみ、またはすべてを使用するかを決定する方法を選択します。利用可能な方法には、EVERY と FIRST があります。
Conversion Value：
(オプション) コンバージョンの値。デフォルト値は 1 で、Send Conversion アクションでのマッピングを通じて上書きすることができます。

Done をクリックしてコンバージョン定義を保存します。

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

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

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

amazon_event_id_{EVENT_NAME}_{TAG_UID}

Tealium iQ の Tags テーブルまたはタグの詳細画面でタグの 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

自動重複排除

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

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

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

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

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

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

アクション — Send Conversion

バッチ制限

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

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

パラメータ

パラメータ	説明
Advertising Profile	このコンバージョンの広告プロファイルを選択します。
Conversion Definition	コンバージョン定義を選択するか、Create Definition をクリックして新しい定義を作成します。

コンバージョンデータ

パラメータ	説明
Country Code	必須。イベントを実行するユーザーが位置する国の ISO 3166-1 alpha-2 形式のコード。
Conversion Time	コンバージョンのタイムスタンプ（ISO 形式：`YYYY-MM-DDThh:mm:ssTZD`）。マッピングされていない場合、コネクタはイベント時間を使用します。
Conversion Value	コンバージョンの値。
Currency	ISO 4217 形式の通貨。`OFF_AMAZON_PURCHASES` コンバージョンタイプにのみ適用されます。
Units Sold	購入されたアイテムの数。`OFF_AMAZON_PURCHASES` コンバージョンタイプにのみ適用されます。
Dedupe 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。

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