Amazon Ads コンバージョンコネクタ構成ガイド

API情報

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

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

コネクタのヒント

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

構成

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

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

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

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

コンバージョン定義を作成するには、コンバージョン定義の作成をクリックし、以下の情報を提供します：

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

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

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

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

このコネクタを構成して、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を参照してください。

バッチ制限

このアクションは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用します。並行処理により、イベントがベンダーに順不同で到達する可能性があります。順序が重要な場合は、イベントにシーケンス値を追加してください。詳細については、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 タグ 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。

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