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 |
---|---|---|
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。 |
ハッシングのためのフォーマットと正規化要件についての詳細は、フォーマットオーディエンスファイルのハッシングを参照してください。
最終更新日 :: 2025年July月22日