Amazon Ads Conversions コネクタ構成ガイド
この記事では、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 |
---|---|---|
コンバージョン送信 | ✓ | ✓ |
コネクタのヒント
タグとコネクタを使用したハイブリッド構成を推奨します。この構成により、データの耐久性が最大化され、サーバーサイドのシグナルとのイベントマッチングが向上し、リアルタイムのクライアントサイドシグナルを保持しながらデータフローの連続性が維持されます。
構成の構成
コネクタマーケットプレイスにアクセスして新しいコネクタを追加します。コネクタを追加する一般的な手順については、About Connectorsを参照してください。
コネクタを追加した後、以下の構成を構成します:
- API Base URL:
必須。API Base URL を選択します。 - Amazon Advertiser ID:
必須。Amazon Advertising アカウント ID を入力します。
Web イベントの重複排除
Amazon Ads Server タグからのイベントを重複排除するために、次の命名規則でイベント ID をイベント属性として送信してこのコネクタを構成します:
amazon_event_id_{EVENT_NAME}_{TAG_UID}
タグの UID は、Tealium iQ の Tags テーブルまたはタグの詳細画面で見つけることができます:

例えば、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
が使用されます。
アクション構成 — パラメータとオプション
アクションの名前を入力し、ドロップダウンメニューからアクションタイプを選択します。
次のセクションでは、各アクションのパラメータとオプションの構成方法について説明します。
アクション — コンバージョン送信
バッチ制限
このアクションは、ベンダーへの高容量データ転送をサポートするためにバッチリクエストを使用します。詳細については、Batched Actionsを参照してください。リクエストは、次のいずれかの閾値が満たされるか、プロファイルが公開されるまでキューに入れられます:
- 最大リクエスト数:100
- 最古のリクエストからの最大時間:10分
- リクエストの最大サイズ:1 MB
パラメータ
パラメータ | 説明 |
---|---|
広告プロファイル | このコンバージョンのための広告プロファイルを選択します。 |
コンバージョン定義 | コンバージョン定義を選択するか、Create Definition をクリックして新しい定義を作成します。 |
コンバージョンデータ
パラメータ | 説明 |
---|---|
国コード | 必須。イベントを実行するユーザーが位置する国の ISO 3166-1 alpha-2 形式のコード。 |
コンバージョン時間 | コンバージョンのタイムスタンプを ISO 形式 (YYYY-MM-DDThh:mm:ssTZD ) で指定します。マッピングされていない場合、コネクタはイベント時間を使用します。 |
コンバージョン値 | コンバージョンの値。 |
通貨 | ISO 4217 形式の通貨。OFF_AMAZON_PURCHASES コンバージョンタイプにのみ適用されます。 |
販売単位 | 購入されたアイテムの数。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 を自動的に検索します。 |
タグ変換タイプ | 自動重複排除を有効にする場合、タグデータと共に送信された以下の変換タイプのうち一つを選択します:
|
書式構成と正規化の要件についての詳細は、ハッシュ用のオーディエンスファイルの形式を整えるを参照してください。
最終更新日 :: 2025年March月27日