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

API情報

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

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

コネクタのヒント

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

構成

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

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

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

Webイベントの重複排除

Amazon Adsサーバータグからのイベントを重複排除するために、次の命名規則でイベントIDをイベント属性として送信するようにこのコネクタを構成します：

amazon_event_id_{EVENT_NAME}_{TAG_UID}

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

例えば、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` (属性)	Event ID
`"Checkout"` (カスタムテキスト)	Event Name

自動重複排除

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

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

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

アクション

アクション名	AudienceStream	EventStream
コンバージョン送信	✓	✓
コンバージョン送信（非推奨）	✓	✓

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

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

コンバージョン送信

バッチ制限

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

最大リクエスト数：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`です。

コンバージョンデータ

パラメータ	説明
名前	(必須) インポートされるイベントの名前。例えば、ウェブサイト購入、ニュースレター登録など。
国コード	(必須) イベントを実行したユーザーが位置していた国を示す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	タグとコネクタの両方から送信されるコンバージョンイベントを重複排除するために使用される一意の識別子。重複したコンバージョンレポートを防ぐために、両方で同じ値を構成します。

ユーザーデータ

パラメータ	説明
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` です。
Ramp ID	LiveRampの識別子です。
Match ID	Amazonがユーザー識別キーとしてサポートしている一般的なマッチ識別子タイプです。
Custom Data	変換イベントに関連付けられたカスタムデータをマップします。

同意

パラメータ	説明
Amazon Ad Storage	ユーザーがAmazonに広告識別子の保存とアクセスを許可したかどうかを示します。可能な値は `GRANTED` または `DENIED` です。
Amazon User Data	ユーザーがAmazonによる広告のためのユーザーデータの使用を許可したかどうかを示します。可能な値は `GRANTED` または `DENIED` です。
IP Address	ユーザーのIPアドレスです。
GPP String	GPP同意文字列です。
TCF String	IAB（Interactive Advertising Bureau）を使用したGDPR同意文字列です。

自動重複排除

パラメータ	説明
Automatic Deduplication	Tealium iQ Tag ID を入力し、TealiumがTealium iQから送信されたこのイベントIDを自動的に検索します。

マッピングの上書き

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

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

送信変換（非推奨）

このアクションは現在非推奨となっており、新たに追加することはできません。現在のアクションについては、Send Conversionを参照してください。

API情報

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

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

変換定義の作成

変換定義を作成するには、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）を使用して、利用規約に同意してください。

バッチ制限

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

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

パラメータ

パラメータ	説明
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 Tag 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です。

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