Amazon Ads Conversions コネクタ構成ガイド | サーバーサイドコネクタ

API情報

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

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

コネクタアクション

アクション名	AudienceStream	EventStream
コンバージョンの送信	✗	✓

構成の構成

コネクタマーケットプレイスに移動し、新しいコネクタを追加します。コネクタの追加方法の一般的な指示については、About Connectorsを参照してください。

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

API Base URL：必須。API Base URLを選択します。
Amazon Advertiser ID：必須。Amazon AdvertisingアカウントIDを入力します。

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

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

amazon_event_id_{eventName}_{tagID}

例えば、タグ＃32からのチェックアウトイベントは、以下の属性と値を送信します：

{
  "amazon_event_id_checkout_32": "028b2ade7478..."
}

同じタグからのページビューイベントは、以下の属性と値を送信します：

{
  "amazon_event_id_pageView_32": "084b1cda7461..."
}

各タイプのイベントに対して別々のアクションを使用します。イベント固有のイベントID属性をEvent IDにマッピングし、一致するイベント名をEvent Nameにマッピングします。例えば：

Tealium属性	Amazonパラメータ
`amazon_event_id_checkout_32` (属性)	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が入力されている場合は、そのEvent IDが使用されます。

アクション構成 - パラメータとオプション

アクションに名前を入力し、ドロップダウンメニューからアクションタイプを選択します。

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

アクション - コンバージョンの送信

バッチ制限

このアクションは、ベンダーへの大量のデータ転送をサポートするためにバッチリクエストを使用します。詳細については、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 (already SHA256 hashed)	すでに空白をトリムし、小文字に変換し、SHA256でハッシュ化されたメールアドレスを提供します。
Email (apply SHA256 hash)	プレーンテキストのメールアドレスが提供された場合、コネクタはこの値を空白をトリムし、小文字に変換し、SHA256ハッシュを使用してハッシュ化します。
Phone (already SHA256 hashed)	すでに空白をトリムし、小文字に変換し、SHA256でハッシュ化された電話番号を提供します。
Phone (apply SHA256 hash)	プレーンテキストの電話番号を提供し、コネクタはこの値を空白をトリムし、小文字に変換し、SHA256ハッシュを使用してハッシュ化します。
First Name (already SHA256 hashed)	すでに空白をトリムし、小文字に変換し、SHA256でハッシュ化された名前を提供します。
First Name (apply SHA256 hash)	プレーンテキストの名前を提供し、コネクタはこの値を空白をトリムし、小文字に変換し、SHA256ハッシュを使用してハッシュ化します。
Last Name (already SHA256 hashed)	すでに空白をトリムし、小文字に変換し、SHA256でハッシュ化された姓を提供します。
Last Name (apply SHA256 hash)	プレーンテキストの姓を提供し、コネクタはこの値を空白をトリムし、小文字に変換し、SHA256ハッシュを使用してハッシュ化します。
Address (already SHA256 hashed)	すでに空白をトリムし、小文字に変換し、SHA256でハッシュ化された住所を提供します。
Address (apply SHA256 hash)	プレーンテキストの住所を提供し、コネクタはこの値を空白をトリムし、小文字に変換し、SHA256ハッシュを使用してハッシュ化します。
City (already SHA256 hashed)	すでに空白をトリムし、小文字に変換し、SHA256でハッシュ化された市区町村を提供します。
City (apply SHA256 hash)	プレーンテキストの市区町村を提供し、コネクタはこの値を空白をトリムし、小文字に変換し、SHA256ハッシュを使用してハッシュ化します。
State (already SHA256 hashed)	すでに空白をトリムし、小文字に変換し、SHA256でハッシュ化された都道府県を提供します。
State (apply SHA256 hash)	プレーンテキストの都道府県を提供し、コネクタはこの値を空白をトリムし、小文字に変換し、SHA256ハッシュを使用してハッシュ化します。
Postal Code (already SHA256 hashed)	すでに空白をトリムし、小文字に変換し、SHA256でハッシュ化された郵便番号を提供します。
Postal Code (apply SHA256 hash)	プレーンテキストの郵便番号を提供し、コネクタはこの値を空白をトリムし、小文字に変換し、SHA256ハッシュを使用してハッシュ化します。
MAID	モバイル識別子。有効な値は`MAID`、`ADID`、`IDFA`、`FIREADID`です。

自動重複排除

パラメータ	説明
Automatic Deduplication	Tealium iQ Tag IDが提供された場合、Tealium iQから送信されたイベントIDの値を自動的に探します。
Tag Conversion Type	自動重複排除を有効にする場合、Automatic Deduplicationパラメータで選択したTag `ID`と一緒にクライアントサイドで送信されるConversion Typeを選択します： ADD_TO_SHOPPING_CART APPLICATION CHECKOUT CONTACT LEAD OFF_AMAZON_PURCHASES PAGE_VIEW SEARCH SIGN_UP SUBSCRIBE OTHER

ハッシュ化のためのフォーマットと正規化の要件についての詳細は、Format audience file for hashingを参照してください。