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

API情報

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

API名：Awin API
APIエンドポイント：https://www.awin1.com
ドキュメント：Awin：Awin API
認証タイプ：OAuth2.0
タグのドキュメント：Awinタグ

仕組み

タグとコネクタの両方を使用するハイブリッド構成を推奨します。この構成により、データの耐障害性を最大限に高め、サーバーサイドデータによるイベントマッチングを改善し、リアルタイムのクライアントサイドデータを維持しながらデータフローの継続性を確保できます。このコネクタはAwinタグを使用し、トラフィックの流入元を識別するawcクエリ文字列パラメータを含む参照リンクから発生したコンバージョンをアトリビューションします。Tealium拡張機能を使用するか、awcパラメータを保持してサーバーサイドコネクタから送信することで、購入が正しいコミッショングループに割り当てられます。

さまざまなブラウザのアップデートにより、Awinはピクセルのみの実装をサポートしなくなりました。このコネクタでは、フォールバックとしてAwin S2S API実装を使用できます。

構成

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

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

トークン
（必須）このトークンは、個人ユーザーアカウントにリンクされています。トークンの作成方法について詳しくは、AWIN：認証と認可を参照してください。
マーチャント（広告主ID）
該当するAwin広告主ID。サポートが必要な場合は、Awinアカウントマネージャーにお問い合わせください。

コネクタの構成が完了したら、完了をクリックします。

重複排除

複数のマーケティングチャネルやネットワークを使用している場合、同一のコンバージョンに対して複数のトラフィックソースへコミッションが支払われないよう、重複排除を実行する必要があります。詳細については、以下のチャネルパラメータに関する説明とAWIN：重複排除を参照してください。

チャネルパラメータ

Awinでは、トラフィックの流入元に基づいて各コンバージョンを処理する方法をシステムに指示するために、すべてのお客様がチャネルパラメータを使用することを強く推奨しています。

このパラメータに成果対象となったチャネルコードを構成すると、Tealiumはリクエストを次の4つの方法で処理できます。

処理しない。
Awin Cookieが存在する場合に処理する。
AwinクリックCookieが存在する場合のみ処理する。
AwinポストビューCookieが存在する場合のみ処理する。

アクション

アクション名	訪問プロファイル	イベントデータ
コンバージョンを送信	✓	✓
商品レベルコンバージョン	✓	✓

続行をクリックして、コネクタのアクションを構成します。アクションの名前を入力し、ドロップダウンメニューからアクションタイプを選択します。

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

コンバージョンを送信

サーバー間トラッキングは、トラッキングに必須の要素です。コンバージョンデータは、Tealiumコネクタを介したHTTPSリクエストにより、Tealium Customer Data HubからAwinのサーバーへ直接送信する必要があります。

パラメータ

パラメータ	説明
合計金額	（必須）関連する割引を適用した後、税金、配送料、関連するサービス料などの追加料金を加算する前の注文小計金額。値は浮動小数点数データ型にする必要があります。桁区切り記号は使用できず、小数点には標準のドット（`.`）文字を使用する必要があります。
注文参照番号	（必須）一意の予約IDまたは注文ID。
マーチャント（広告主ID）	広告主プログラムID。この値は、構成画面で指定した値を上書きします。
コミッショングループコード	推奨。トランザクションのアトリビューション先とするコミッショングループのコード。単一グループの場合、このパラメータには文字列を指定でき、複数グループの場合は配列を指定できます。使用できる文字は、大文字の英数字、アンダースコア、ハイフンです。このパラメータが構成されていない場合、Awinはデフォルトのコミッショングループを使用します。
コミッショングループ金額	各コミッショングループに割り当てるコミッション金額。単一グループの場合、このパラメータには文字列を指定でき、複数グループの場合は配列を指定できます。配列の値は、コミッショングループ配列と同じ順序で指定する必要があります。マッピングされていない場合、マッピングされた合計金額がデフォルト値になります。
チャネル	ラストクリック参照元のチャネル名。Awinには、デフォルト値であるawを常に使用してください。この値は20文字以内の英数字で指定する必要があります。トラフィックの流入元に基づいて各コンバージョンを処理する方法をAwinシステムが判断できるよう、このパラメータを含めることを強く推奨します。値の例としては、`aw`（Awinには常にこの値を使用）、`display`、`ppc`などがあります。詳細については、Awin：チャネルパラメータを参照してください。
AWCパラメータ	この値は、クリックの流入元を識別するためにAwinによってランディングページURLに追加されます。AWCパラメータまたはバウチャーコードのいずれかに値を指定する必要があります。`awc`値は、クリックの流入元を識別するためにAwinによってランディングページURLに追加されるパラメータです。エンドユーザーがサイトに到達したときに、サーバーサイドのスクリプト言語を使用して`awc`値を記録するようにサイトを構成する必要があります。この値は、コンバージョン時に`cks`パラメータへ入力するために使用されます。この関数は、すべてのページで呼び出す必要があります。Cookieを使用してawc値を取得する場合は、次のガイドラインに従ってください。 Cookieは、クライアントサイドスクリプトではなく、HTTPレスポンスヘッダーで構成する必要があります。たとえば、PHPで構成されたCookieは使用できます。 CookieにはHTTP Onlyフラグを構成する必要があります。 CookieにはSecureフラグを構成する必要があります。
バウチャーコード	トランザクションのURLエンコードされたバウチャーコード。AWCパラメータまたはバウチャーコードのいずれかに値を指定する必要があります。
通貨コード	推奨。トランザクションで使用された通貨のISO通貨コード（例：`GBP`または`USD`）。正確なトラッキングを維持するために、このパラメータを指定することを強く推奨します。
カスタムパラメータ	1つまたは複数のカスタムトラッキングパラメータに使用する入力データ。
テストモード	受信したトラッキングリクエストは、テスト目的のため処理されません。

商品レベルコンバージョン

商品レベルトラッキングを使用すると、広告主は個々の商品のパフォーマンスを測定できる、より詳細なレポートを作成できます。

パラメータ

パラメータ	説明
合計金額	（必須）関連する割引を適用した後、税金、配送料、関連するサービス料などの追加料金を加算する前の注文小計金額。値は浮動小数点型でなければなりません。桁区切り文字は使用できず、小数点には標準のドット（`.`）文字を使用する必要があります。
注文参照番号	（必須）一意の予約IDまたは注文ID。
マーチャント（広告主ID）	広告主プログラムID。この値は、構成画面の値を上書きします。
コミッショングループコード	推奨。トランザクションの割り当て先となるコミッショングループのコード。単一グループの場合、このパラメータには文字列を指定し、複数グループの場合は配列を指定できます。使用できる文字は、英大文字、数字、アンダースコア、ハイフンです。このパラメータが指定されていない場合、Awinはデフォルトのコミッショングループを使用します。コミッショングループのコードはpartsパラメータにマッピングされ、商品レベルでもマッピングされます。
コミッショングループ金額	各コミッショングループに割り当てるコミッション金額。単一グループの場合、このパラメータには文字列を指定し、複数グループの場合は配列を指定できます。配列の値は、コミッショングループの配列と同じ順序で指定する必要があります。マッピングされていない場合、デフォルト値はマッピングされた合計金額になります。
チャネル	ラストクリックの参照元のチャネル名。Awinの場合は、常にデフォルト値の`aw`を使用してください。この値は20文字以内の英数字で指定する必要があります。トラフィックの流入元に基づいて各コンバージョンを処理する方法をAwinシステムが判断できるよう、このパラメータを含めることを強く推奨します。値の例としては、`aw`（Awinでは常にこの値を使用）、`display`、`ppc`などがあります。
AWCパラメータ	クリック元を識別するために、AwinによってランディングページのURLに追加される値。AWCパラメータまたはバウチャーコードのいずれかの値を指定する必要があります。Cookieを使用してawc値を取得する場合は、次のガイドラインに従ってください。 Cookieは、クライアント側スクリプトではなく、HTTPレスポンスヘッダーで構成する必要があります。たとえば、PHPで構成されたCookieは問題ありません。CookieにはHTTP Onlyフラグを構成する必要があります。 CookieにはSecureフラグを構成する必要があります。
バウチャーコード	トランザクションに使用するURLエンコードされたバウチャーコード。AWCパラメータまたはバウチャーコードのいずれかの値を指定する必要があります。
通貨コード	推奨。トランザクションで使用された通貨のISO通貨コード（例：`GBP`、`USD`）。
商品名	（必須）トランザクション内の商品名の配列。
カスタムパラメータ	1つまたは複数のカスタムトラッキングパラメータに対する入力データ。
テストモード	受信したトラッキングリクエストは、テスト目的のため処理されません。

商品

パラメータ	説明
商品ID	（必須）トランザクション内の一意の商品IDの配列。
商品数量	（必須）トランザクション内の各商品の数量を格納した配列。
商品SKU	（必須）トランザクション内の各商品のSKUを格納した配列。
商品単価	（必須）トランザクション内の各商品の単価を格納した配列。この単価には、関連する割引を適用した後、税金や追加料金を加算する前の価格を指定する必要があります。値は浮動小数点型でなければなりません。桁区切り文字は使用できず、小数点には標準のドット文字を使用する必要があります。
商品カテゴリー	（必須）トランザクション内の各商品のカテゴリーを格納した配列。