Awinコンバージョンコネクタのセットアップガイド | サーバーサイドコネクタ

Awinは、企業がパブリッシャーや広告主と協力してアフィリエイトプログラムのパフォーマンスメトリクスを追跡するためのアフィリエイトマーケティングプラットフォームです。機能には、アフィリエイトパートナーのネットワーク、クリックの追跡とトラッキング、広告主ディレクトリ、レポートと分析などがあります。この統合は、コンバージョンと製品レベルのコンバージョンイベントをサポートしています。

API情報

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

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

動作原理

Awinのサーバーサイド実装は、信号の強靭性を提供するためにAwinによって推奨されています。そのため、コネクタはクライアントサイドを置き換えるのではなく、補完します。このピクセルは、awcクエリ文字列パラメータを含む紹介リンクからのコンバージョンを属性付けするために使用されます。Tealiumの拡張機能を使用するか、クライアントがこのパラメータを永続化し、それをサーバーサイドから送信することで、購入が正しく属性付けされることが保証されます。

Awinは、さまざまなブラウザの更新により、ピクセルのみの実装の使用をサポートしていません。ブラウザベースのトラッキングのリスクを軽減するために、Awin S2S API（コネクタ）をフォールバックとして実装する必要があります。

設定

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

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

トークン
必須です。このトークンは、個人のユーザーアカウントにリンクされています。トークンの作成方法の詳細については、AWINのドキュメントの認証と承認を参照してください。
マーチャント（広告主ID）
適用されるAwin広告主ID。サポートについては、Awinのアカウントマネージャーにお問い合わせください。

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

重複排除

複数のマーケティングチャネルやネットワークで作業している場合、同じコンバージョンに対して複数のトラフィックソースに報酬が支払われないように、重複排除を実行する必要があります。詳細については、以下のチャネルパラメータとAwinの重複排除ドキュメントを参照してください。

チャネルパラメータ

Awinは、すべてのクライアントがトラフィックのソースに基づいて各コンバージョンを処理する方法を指示するために、チャネルパラメータの使用を強くお勧めしています。

変換が行われたチャネルのコード/名前を入力することで、リクエストを次の4つの異なる方法で処理できます：

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

アクション

アクション名	AudienceStream	EventStream
コンバージョン送信	✓	✓
製品レベルのコンバージョン	✓	✓

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

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

コンバージョン送信

サーバー間トラッキングは、トラッキングの必須要素となりました。要件としては、コンバージョンデータが（Tealiumコネクタを介したHTTPSリクエストを介して）TealiumカスタマーデータハブからAwinのサーバーに直接送信されることです。

パラメータ

パラメータ	説明
マーチャント（広告主ID）（オーバーライド）	広告主プログラムIDです。
AWCパラメータ	この値は、クリックのソースを識別するためにAwinによって着陸ページのURLに追加されます。AWCパラメータまたはバウチャーコードのいずれかに値を指定する必要があります。`awc`の値は、Awinによって着陸ページのURLに追加され、クリックのソースを識別するためにサイトがawcの値を記録するように構成する必要があります。この値は、変換時に`cks`パラメータに入力されます。この機能は、すべてのページで呼び出す必要があります。awcをキャプチャするためにクッキーを使用している場合は、次のガイドラインを参照してください：クッキーは、HTTPレスポンスヘッダーに設定する必要があります。クライアントサイドのスクリプトではなく、たとえばPHPで設定されたクッキーは問題ありません。クッキーは、HTTP Onlyフラグを使用してクッキーを設定する必要があります。クッキーは、セキュアフラグを使用してクッキーを設定する必要があります。
合計金額	（必須）関連する割引が適用された後の注文の小計金額ですが、税金、配送料、または関連するサービス料などの追加料金は含まれません。値は浮動小数点数でなければならず、千の区切り文字は許可されず、小数点は標準のドット文字である必要があります。
コミッショングループコード	トランザクションを割り当てるためのコミッショングループのコードです。受け入れられる文字は大文字の英数字、アンダースコア、ハイフンです。このパラメータが入力されていない場合、Awinはデフォルトのコミッショングループにフォールバックします。注：このパラメータは強く推奨されます。
チャネル	最後のクリックのリファラーのチャネル名です。Awinの場合は常にawを使用してください（デフォルト値）。この値は、トラフィックのソースに基づいて各コンバージョンをAwinシステムがどのように処理するかを知るために、このパラメータを含めることを強くお勧めします。例としては、`aw`（Awinに常に使用する必要があります）、`display`、`ppc`などがあります。
バウチャーコード	トランザクションのURLエンコードされたバウチャーコードです。AWCパラメータまたはバウチャーコードのいずれかに値を指定する必要があります。
通貨コード	トランザクションで使用された通貨のISO通貨コード（例：GBPまたはUSD）。注：正確なトラッキングを維持するために、このパラメータは強く推奨されます。
注文参照	（必須）一意の予約または注文IDです。
カスタムパラメータ	単一または複数のカスタムトラッキングパラメータの入力データです。
テストモード	テスト目的でのトラッキングリクエストは処理されません。

製品レベルのコンバージョン

製品レベルのトラッキングを使用すると、広告主は個々の製品のパフォーマンスを簡単に測定できます。

パラメータ

パラメータ	説明
マーチャント（広告主ID）（オーバーライド）	広告主プログラムIDです。
AWCパラメータ	この値は、クリックのソースを識別するためにAwinによって着陸ページのURLに追加されます。AWCパラメータまたはバウチャーコードのいずれかに値を指定する必要があります。awcをキャプチャするためにクッキーを使用している場合は、次のガイドラインを参照してください：クッキーは、HTTPレスポンスヘッダーに設定する必要があります。クライアントサイドのスクリプトではなく、たとえばPHPで設定されたクッキーは問題ありません。クッキーは、HTTP Onlyフラグを使用してクッキーを設定する必要があります。クッキーは、セキュアフラグを使用してクッキーを設定する必要があります。
合計金額	（必須）関連する割引が適用された後の注文の小計金額ですが、税金、配送料、または関連するサービス料などの追加料金は含まれません。値は浮動小数点数でなければならず、千の区切り文字は許可されず、小数点は標準のドット文字である必要があります。
コミッショングループコード	トランザクションを割り当てるためのコミッショングループのコードです。受け入れられる文字は大文字の英数字、アンダースコア、ハイフンです。注：このパラメータは強く推奨されます。このパラメータが入力されていない場合、Awinはデフォルトのコミッショングループにフォールバックします。
チャネル	最後のクリックのリファラーのチャネル名です。Awinの場合は常にawを使用してください（デフォルト値）。この値は、トラフィックのソースに基づいて各コンバージョンをAwinシステムがどのように処理するかを知るために、このパラメータを含めることを強くお勧めします。例としては、`aw`（Awinに常に使用する必要があります）、`display`、`ppc`などがあります。
バウチャーコード	トランザクションのURLエンコードされたバウチャーコードです。AWCパラメータまたはバウチャーコードのいずれかに値を指定する必要があります。
通貨コード	トランザクションで使用された通貨のISO通貨コード（例：GBPまたはUSD）。注：正確なトラッキングを維持するために、このパラメータは強く推奨されます。
注文参照	（必須）一意の予約または注文IDです。
カスタムパラメータ	単一または複数のカスタムトラッキングパラメータの入力データです。
テストモード	テスト目的でのトラッキングリクエストは処理されません。
製品名	（必須）トランザクション内の製品名の配列です。
製品ID	（必須）トランザクション内の各製品の一意の製品IDの配列です。
製品数量	（必須）トランザクション内の各製品の数量の配列です。
製品SKU	（必須）トランザクション内の各製品のSKUの配列です。
製品アイテム価格	（必須）トランザクション内の各製品の単一数量の価格の配列です。この単一ユニット価格は、関連する割引が適用された後の価格を反映する必要がありますが、税金や追加料金は適用されていません。値は浮動小数点数でなければならず、千の区切り文字は許可されず、小数点は標準のドット文字である必要があります。
製品カテゴリ	（必須）トランザクション内の各製品のカテゴリの配列です。
コミッショングループコード	トランザクションを割り当てるためのコミッショングループのコードです。受け入れられる文字は大文字の英数字、アンダースコア、ハイフンです。