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

API情報

このコネクタは、次のベンダーAPIを使用します。

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

コネクタに関するヒント

タグとコネクタの両方を使用するハイブリッド構成をお勧めします。この構成により、データの耐障害性を最大限に高め、サーバーサイドシグナルによるイベントマッチングを改善し、リアルタイムのクライアントサイドシグナルを維持しながらデータフローの継続性を確保できます。

構成

コネクタマーケットプレイスに移動し、新しいコネクタを追加します。詳細については、コネクタについてを参照してください。

コネクタを追加した後、次の構成を構成します。

APIベースURL：（必須）APIベースURLを選択します。
Amazon広告主ID：（必須）Amazon AdvertisingアカウントIDを入力します。
Amazon AdsマネージャーアカウントID：（任意）広告主IDに関連付けられたAmazon Adsマネージャーアカウントの識別子です。値が入力されている場合、Tealiumはその値をAmazon-Ads-Manager-AccountIdリクエストヘッダーとして送信します。構成されていない場合、コネクタはこのヘッダーを省略します。

Webイベントの重複排除

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

amazon_event_id_{EVENT_NAME}_{TAG_UID}

タグのUIDは、タグ管理のタグテーブルまたはタグの詳細画面で確認できます。

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

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

同じタグからのページビューイベントでは、次の属性と値が送信されます。

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

イベントタイプごとに個別のアクションを使用します。イベント固有のイベントID属性をEvent IDにマッピングし、対応するイベント名をEvent Nameにマッピングします。例：

Tealium属性	Amazonパラメータ
`amazon_event_id_checkout_170`（属性）	イベントID
`"Checkout"`（カスタムテキスト）	イベント名

自動重複排除

自動重複排除の値が入力されている場合、コネクタは対応するイベントID属性を検索します。このセクションに値が入力され、タグ管理を使用している場合は、Event IDを追加する必要はなくなります。ただし、タグ管理を使用せずにイベントストリーミングを使用する場合は、次の方法が引き続き必要になることがあります。

コネクタは次の順序で処理します。

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

アクション

アクション名	訪問プロファイル	イベントデータ
コンバージョンを送信	✓	✓
コンバージョンを送信（非推奨）	✓	✓

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

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

コンバージョンを送信

バッチ処理の制限

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

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

パラメータ

パラメータ	説明
コンバージョンタイプ	インポートされたイベントのコンバージョンタイプを選択します。指定可能な値は、`ADD_TO_SHOPPING_CART`、`APPLICATION`、`CHECKOUT`、`CONTACT`、`LEAD`、`OFF_AMAZON_PURCHASES`、`MOBILE_APP_FIRST_START`、`PAGE_VIEW`、`SEARCH`、`SIGN_UP`、`SUBSCRIBE`、`OTHER`です。
コンバージョンソース	インポートされたイベントのコンバージョンソースを選択します。指定可能な値は、`ANDROID`、`FIRE_TV`、`IOS`、`OFFLINE`、`WEBSITE`、`MEASUREMENT_PARTNER`です。

コンバージョンデータ

Amazonに送信される一意のコンバージョン名ごとに、Amazon Adsで新しいコンバージョン定義が作成されます。Amazonでは、広告主アカウントごとにコンバージョン定義が100件に制限されています。
Nameフィールドを、ページ名、ページURL、パス名、クエリ文字列、検索語句などのカーディナリティが高いデータや動的データにマッピングしないでください。マッピングすると、すぐに上限に達する可能性があります。

パラメータ	説明
名前	（必須）インポートされたイベントの名前です。`product_view`、`search`、`lead`、`checkout`、`purchase`など、ビジネスアクションを表す少数の固定された名前を使用してください。
国コード	（必須）イベントを実行したユーザーの所在地を示すISO 3166-1 alpha-2国コードです。
データセット名	このイベントの追加先となるイベントデータセット名です。文字で始まる1～100文字の文字列である必要があり、それ以降には文字、数字、アンダースコア、またはハイフンのみを使用できます。
イベント時刻	ISO形式（`YYYY-MM-DDThh:mm:ssTZD`）のコンバージョンのタイムスタンプです。マッピングされていない場合、コネクタはイベント時刻を使用します。
値	イベントの値です。
通貨コード	ISO-4217形式の通貨です。`OFF_AMAZON_PURCHASES`コンバージョンタイプにのみ適用されます。
販売数量	購入された商品の数です。`OFF_AMAZON_PURCHASES`コンバージョンタイプにのみ適用されます。
データ処理オプション	イベントの処理方法を示すフラグです。データ使用制限の対象としてマークされたイベントは処理されません。例：`LIMITED_DATA_USE`。
重複排除ID	タグとコネクタの両方から送信されるコンバージョンイベントの重複排除に使用する一意の識別子です。コンバージョンの重複レポートを防ぐには、両方に同じ値を構成します。
ユーザーエージェント	コンバージョンイベントに関連付けられたブラウザまたはアプリケーションのユーザーエージェントです。コネクタは、この値をハッシュ化せずに送信します。
Amazonリファラル測定トークン	Amazon Attributionリンクから取得したAmazonリファラルトークンです。1つ以上の`token.timestamp`ペアをパイプ区切りで指定します。トークンは10文字の英数字、タイムスタンプは13桁のUTCエポックミリ秒値である必要があります。例：`abc1234567.1786393292000`。

ユーザーデータ

Amazon は、アップロードされたレコードを、精度の高い識別子から低い識別子の順に評価して Amazon Ads ユーザーと照合します。サポートされる識別子の種類は、ハッシュ化された PII、モバイル広告 ID（MAID）、外部 ID の 3 種類です。

メールアドレスは、Amazon アカウントの作成に使用される主要な認証情報であり、Amazon の ID グラフで最も広く網羅されているため、最も高いマッチ率を実現します。電話番号と MAID は単独の識別子として機能しますが、マッチ率は低くなります。電話番号は世帯内の複数のメンバーで共有される場合や、通信事業者によって再利用される場合があります。MAID は段階的な廃止が進められています。

次の識別子タイプでは、ハッシュ化は必要ありません：MAID、Ramp ID、Real ID、Merkle ID、Kantar ID、IP、Match ID。

マッチ率を最大化するには、メールアドレスを優先し、複数の識別子タイプ（例：メールアドレス + 電話番号 + MAID）をマッピングすることをお勧めします。現在のマッチ率が許容範囲内である場合、ハッシュ化されたメールアドレスの追加が、最も大きな改善効果を得られる方法です。

パラメータ	説明
メールアドレス（SHA256 でハッシュ化済み）	空白文字の除去、小文字への変換、および SHA256 によるハッシュ化がすでに行われたメールアドレスを指定します。
メールアドレス（SHA256 ハッシュを適用）	プレーンテキストのメールアドレスを指定します。コネクタは空白文字を除去し、小文字に変換してから、SHA256 を使用して値をハッシュ化します。
電話番号（SHA256 でハッシュ化済み）	空白文字の除去、小文字への変換、および SHA256 によるハッシュ化がすでに行われた電話番号を指定します。
電話番号（SHA256 ハッシュを適用）	プレーンテキストの電話番号を指定します。コネクタは空白文字を除去し、小文字に変換してから、SHA256 を使用して値をハッシュ化します。
名（SHA256 でハッシュ化済み）	空白文字の除去、小文字への変換、および SHA256 によるハッシュ化がすでに行われた名を指定します。
名（SHA256 ハッシュを適用）	プレーンテキストの名を指定します。コネクタは空白文字を除去し、小文字に変換してから、SHA256 を使用して値をハッシュ化します。
姓（SHA256 でハッシュ化済み）	空白文字の除去、小文字への変換、および SHA256 によるハッシュ化がすでに行われた姓を指定します。
姓（SHA256 ハッシュを適用）	プレーンテキストの姓を指定します。コネクタは空白文字を除去し、小文字に変換してから、SHA256 を使用して値をハッシュ化します。
住所（SHA256 でハッシュ化済み）	空白文字の除去、小文字への変換、および SHA256 によるハッシュ化がすでに行われた住所を指定します。
住所（SHA256 ハッシュを適用）	プレーンテキストの住所を指定します。コネクタは空白文字を除去し、小文字に変換してから、SHA256 を使用して値をハッシュ化します。
市区町村（SHA256 でハッシュ化済み）	空白文字の除去、小文字への変換、および SHA256 によるハッシュ化がすでに行われた市区町村を指定します。
市区町村（SHA256 ハッシュを適用）	プレーンテキストの市区町村を指定します。コネクタは空白文字を除去し、小文字に変換してから、SHA256 を使用して値をハッシュ化します。
州（SHA256 でハッシュ化済み）	空白文字の除去、小文字への変換、および SHA256 によるハッシュ化がすでに行われた州を指定します。
州（SHA256 ハッシュを適用）	プレーンテキストの州を指定します。コネクタは空白文字を除去し、小文字に変換してから、SHA256 を使用して値をハッシュ化します。
郵便番号（SHA256 でハッシュ化済み）	空白文字の除去、小文字への変換、および SHA256 によるハッシュ化がすでに行われた郵便番号を指定します。
郵便番号（SHA256 ハッシュを適用）	プレーンテキストの郵便番号を指定します。コネクタは空白文字を除去し、小文字に変換してから、SHA256 を使用して値をハッシュ化します。
MAID	モバイル識別子。指定可能な値は `MAID`、`ADID`、`IDFA`、`FIREADID` です。
Ramp ID	LiveRamp 識別子。
Match ID	Amazon がユーザー ID キーとしてサポートする汎用的な照合識別子タイプ。
Real ID	Real ID ユーザー識別子。
Merkle ID	Merkle ID ユーザー識別子。
Kantar ID	Kantar ID ユーザー識別子。
カスタムデータ	コンバージョンイベントに関連付けられたカスタムデータをマッピングします。

同意

パラメータ	説明
Amazon 広告保存	広告識別子の保存およびアクセスについて、ユーザーが Amazon に同意したかどうかを示します。指定可能な値は `GRANTED` または `DENIED` です。
Amazon ユーザーデータ	広告でのユーザーデータの使用について、ユーザーが Amazon に同意したかどうかを示します。指定可能な値は `GRANTED` または `DENIED` です。
IP アドレス	ユーザーの IP アドレス。
GPP 文字列	GPP 同意文字列。
TCF 文字列	IAB（Interactive Advertising Bureau）を使用した GDPR 同意文字列。

自動重複排除

パラメータ	説明
自動重複排除	Tealium iQ タグ ID を入力すると、Tealium はタグ管理から送信されたこのイベント ID を自動的に検索します。

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

パラメータ	説明
広告主 ID	広告主の一意の識別子。
ベース URL	Amazon Ads API のベース URL。

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

コンバージョンを送信（非推奨）

このアクションは現在非推奨であり、新たに追加することはできません。現在のアクションについては、コンバージョンを送信を参照してください。

API 情報

このアクションでは、次のベンダー API を使用します。

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

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

コンバージョン定義を作成するには、コンバージョン定義を作成をクリックし、次の情報を入力します。

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

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

コンバージョンページの Ads Data Manager コンソール、または Terms API（POST /adm/terms）を使用して、必ず利用規約に同意してください。

バッチ制限

このアクションでは、ベンダーへの大量のデータ転送をサポートするために、バッチリクエストを使用します。並列処理により、イベントが順不同でベンダーに到達する場合があります。順序が重要な場合は、イベントにシーケンス値を追加してください。詳しくは、バッチアクションを参照してください。リクエストは、次のいずれかのしきい値に達するか、プロファイルがパブリッシュされるまでキューに保持されます。

リクエストの最大数：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 を指定します。両方のイベントで値が一致している必要があります。

ユーザーデータ

Amazon は、アップロードされたレコードを、識別精度の高い識別子から低い識別子の順に評価し、Amazon Ads ユーザーと照合します。サポートされる識別子の種類は、ハッシュ化された PII、MAID、外部 ID の 3 つです。

メールアドレスは、Amazon アカウントの作成に使用される主要な認証情報であり、Amazon の ID グラフで最も広くカバーされているため、最も高い一致率を実現します。電話番号と MAID は単独の識別子として使用できますが、一致率は低くなります。電話番号は世帯内の複数のメンバーで共有される場合や、通信事業者によって再利用される場合があります。MAID は段階的な廃止が進められています。

一致率を最大化するには、メールアドレスを優先し、複数の識別子タイプ（メールアドレス、電話番号、MAID など）をマッピングすることをお勧めします。現在の一致率が許容範囲内である場合、ハッシュ化されたメールアドレスの追加が最も効果の高い改善策です。

パラメータ	説明
メールアドレス（SHA256 でハッシュ化済み）	空白のトリミング、小文字への変換、SHA256 によるハッシュ化がすでに行われたメールアドレスを指定します。
メールアドレス（SHA256 ハッシュを適用）	プレーンテキストのメールアドレスを指定します。コネクタは空白をトリミングし、小文字に変換してから、SHA256 を使用してこの値をハッシュ化します。
電話番号（SHA256 でハッシュ化済み）	空白のトリミング、小文字への変換、SHA256 によるハッシュ化がすでに行われた電話番号を指定します。
電話番号（SHA256 ハッシュを適用）	プレーンテキストの電話番号を指定します。コネクタは空白をトリミングし、小文字に変換してから、SHA256 を使用してこの値をハッシュ化します。
名（SHA256 でハッシュ化済み）	空白のトリミング、小文字への変換、SHA256 によるハッシュ化がすでに行われた名を指定します。
名（SHA256 ハッシュを適用）	プレーンテキストの名を指定します。コネクタは空白をトリミングし、小文字に変換してから、SHA256 を使用してこの値をハッシュ化します。
姓（SHA256 でハッシュ化済み）	空白のトリミング、小文字への変換、SHA256 によるハッシュ化がすでに行われた姓を指定します。
姓（SHA256 ハッシュを適用）	プレーンテキストの姓を指定します。コネクタは空白をトリミングし、小文字に変換してから、SHA256 を使用してこの値をハッシュ化します。
住所（SHA256 でハッシュ化済み）	空白のトリミング、小文字への変換、SHA256 によるハッシュ化がすでに行われた住所を指定します。
住所（SHA256 ハッシュを適用）	プレーンテキストの住所を指定します。コネクタは空白をトリミングし、小文字に変換してから、SHA256 を使用してこの値をハッシュ化します。
市区町村（SHA256 でハッシュ化済み）	空白のトリミング、小文字への変換、SHA256 によるハッシュ化がすでに行われた市区町村を指定します。
市区町村（SHA256 ハッシュを適用）	プレーンテキストの市区町村を指定します。コネクタは空白をトリミングし、小文字に変換してから、SHA256 を使用してこの値をハッシュ化します。
州（SHA256 でハッシュ化済み）	空白のトリミング、小文字への変換、SHA256 によるハッシュ化がすでに行われた州を指定します。
州（SHA256 ハッシュを適用）	プレーンテキストの州を指定します。コネクタは空白をトリミングし、小文字に変換してから、SHA256 を使用してこの値をハッシュ化します。
郵便番号（SHA256 でハッシュ化済み）	空白のトリミング、小文字への変換、SHA256 によるハッシュ化がすでに行われた郵便番号を指定します。
郵便番号（SHA256 ハッシュを適用）	プレーンテキストの郵便番号を指定します。コネクタは空白をトリミングし、小文字に変換してから、SHA256 を使用してこの値をハッシュ化します。
MAID	モバイル識別子。指定できる値は `MAID`、`ADID`、`IDFA`、`FIREADID` です。

自動重複排除

パラメータ	説明
自動重複排除	Tealium iQ タグ ID を入力すると、Tealium はタグ管理から送信されたこのイベント 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 です。

形式および正規化の要件について詳しくは、ハッシュ化用オーディエンスファイルの形式を参照してください。