Awinコンバージョンコネクタ構成ガイド
この記事では、Awinコンバージョンコネクタの構成方法について説明します。
API情報
このコネクタは以下のベンダーAPIを使用します:
- API名:Awin API
- APIエンドポイント:
https://www.awin1.com
- ドキュメント:Awin: Awin API
- 認証タイプ:OAuth2.0
- タグドキュメント:Awinタグ
動作原理
タグとコネクタを使用したハイブリッド構成を推奨します。この構成により、データの耐久性が最大化され、サーバーサイドデータとのイベントマッチングが改善され、リアルタイムのクライアントサイドデータを保持しながらデータフローの連続性が維持されます。コネクタは、トラフィックのソースを識別するためにawc
クエリ文字列パラメータを含む紹介リンクから生じるコンバージョンを帰属するためにAwinタグを使用します。Tealiumの拡張機能を使用するか、awc
パラメータを保持してサーバーサイドコネクタから送信することで、購入が正しいコミッショングループにクレジットされることを保証します。
ブラウザの更新により、Awinはピクセルのみの実装をサポートしなくなったため、このコネクタではAwin S2S API実装をフォールバックとして使用できます。
構成
コネクタマーケットプレイスにアクセスして新しいコネクタを追加します。コネクタを追加する一般的な手順については、コネクタについてを参照してください。
コネクタを追加した後、以下の構成を構成します:
- トークン
必須。このトークンは個人のユーザーアカウントにリンクされています。トークンの作成についての詳細は、AWIN: AWAuthentication and Authorizationを参照してください。 - マーチャント(広告主ID)
適用されるAwin広告主ID。サポートについては、Awinアカウントマネージャーに連絡してください。
コネクタの構成が完了したら、完了をクリックします。
重複排除
複数のマーケティングチャネルやネットワークを使用している場合、同じコンバージョンに対して複数のトラフィックソースにコミッションが支払われないように重複排除を行う必要があります。詳細については、以下のチャネルパラメータとAwin: 重複排除を参照してください。
チャネルパラメータ
Awinは、すべてのクライアントにチャネルパラメータの使用を強く推奨しています。このパラメータは、トラフィックのソースに基づいて各コンバージョンを処理する方法をシステムに指示します。
そのパラメータに勝利チャネルコードを入力することで、Tealiumは以下の4つの方法でリクエストを処理できます:
- 処理しない。
- Awinのクッキーが存在する場合に処理する。
- Awinのクリッククッキーが存在する場合のみ処理する。
- Awinのポストビュークッキーが存在する場合のみ処理する。
アクション
アクション名 | AudienceStream | EventStream |
---|---|---|
コンバージョンの送信 | ✓ | ✓ |
商品レベルのコンバージョン | ✓ | ✓ |
コネクタアクションを構成するには、続行をクリックします。アクションの名前を入力し、ドロップダウンメニューからアクションタイプを選択します。
次のセクションでは、各アクションのパラメータとオプションの構成方法について説明します。
コンバージョンの送信
サーバーからサーバーへのトラッキングは、トラッキングの必須要素です。要件は、コンバージョンデータが(Tealiumコネクタを介してHTTPSリクエストを通じて)TealiumカスタマーデータハブからAwinのサーバーに直接送信されることです。
パラメータ
パラメータ | 説明 |
---|---|
合計金額 | 必須。適用される割引後の注文の小計金額ですが、税金、配送料、または関連するサービス料などの追加料金は含まれません。値はfloatデータタイプでなければならず、千の区切りは許可されず、小数点は標準のドット(. )文字でなければなりません。 |
注文参照 | 必須。ユニークな予約または注文ID。 |
マーチャント(広告主ID) | 広告プログラムID。この値は構成画面からの値を上書きします。 |
コミッショングループコード | 推奨。取引を帰属させたいコミッショングループのコードまたはコード。このパラメータは、単一のグループの場合は文字列、複数のグループの場合は配列であることができます。許可される文字は大文字の英数字、アンダースコア、ハイフンです。このパラメータが入力されていない場合、Awinはデフォルトのコミッショングループを使用します。 |
コミッショングループ金額 | 各コミッショングループに割り当てたいコミッション金額。このパラメータは、単一のグループの場合は文字列、複数のグループの場合は配列であることができます。配列値はコミッショングループ配列と同じ順序で表示されなければなりません。マッピングされていない場合、デフォルト値はマッピングされた合計金額です。 |
チャネル | 最後のクリックリファラーのチャネル名。常にawを使用してください。これがAwinのデフォルト値です。この値は20文字以内の英数字でなければなりません。このパラメータを含めることを強くお勧めします。そうすることで、Awinシステムがトラフィックのソースに基づいて各コンバージョンをどのように処理するかを知ることができます。例としては、aw (Awin用に常に使用されるべきです)、display 、またはppc があります。詳細については、Awin: チャネルパラメータを参照してください。 |
AWCパラメータ | この値は、クリックのソースを識別するためにAwinによってランディングページURLに追加されます。AWCパラメータまたはバウチャーコードのいずれかの値を提供する必要があります。awc 値は、クリックのソースを識別するためにAwinによってランディングページURLに追加されるパラメータです。エンドユーザーがサイトに到着したときに、サーバーサイドのスクリプト言語を使用してawc 値を記録するようにサイトを構成する必要があります。この値は、コンバージョン時にcks パラメータを入力するために使用されます。この機能はすべてのページで呼び出す必要があります。awc値をクッキーでキャプチャしている場合、以下のガイドラインに従ってください:
|
バウチャーコード | トランザクションのURLエンコードされたバウチャーコード。AWCパラメータまたはバウチャーコードのいずれかの値を提供する必要があります。 |
通貨コード |
|
カスタムパラメータ | 単一または複数のカスタムトラッキングパラメータの入力データ。 |
テストモード | 受信トラッキングリクエストはテスト目的で処理されません。 |
商品レベルのコンバージョン
商品レベルのトラッキングにより、広告主は個々の製品のパフォーマンスを測定できるようになり、より詳細なレポートを作成できます。
パラメータ
パラメータ | 説明 |
---|---|
合計金額 | 必須。適用される割引後の注文の小計金額ですが、税金、配送料、その他の関連サービス料金は含まれません。値は浮動小数点型で、千の区切りは許可されず、小数点は標準のドット(. )文字でなければなりません。 |
注文参照 | 必須。ユニークな予約または注文IDです。 |
マーチャント(広告主ID) | 広告プログラムIDです。この値は構成画面からの値を上書きします。 |
コミッショングループコード | 推奨。取引を帰属させたいコミッショングループのコードまたはコードです。このパラメータは、単一のグループの場合は文字列、複数のグループの場合は配列であることができます。許可される文字は大文字の英数字、アンダースコア、ハイフンです。このパラメータが入力されていない場合、Awinはデフォルトのコミッショングループを使用します。コミッショングループコードまたはコードはパーツパラメータにマッピングされ、製品レベルでもマッピングされます。 |
コミッショングループ金額 | 各コミッショングループに割り当てたいコミッション金額です。このパラメータは、単一のグループの場合は文字列、複数のグループの場合は配列であることができます。配列値はコミッショングループ配列と同じ順序で表示されなければなりません。マッピングされていない場合、デフォルト値はマッピングされた合計金額です。 |
チャネル | 最後のクリックリファラーのチャネル名です。Awinの場合は常にデフォルト値aw を使用してください。この値は20文字以下の英数字でなければなりません。このパラメータを含めることを強くお勧めします。これにより、Awinシステムはトラフィックのソースに基づいて各変換をどのように処理するかを知ることができます。例としては、aw (Awin用に常に使用されるべき)、display 、ppc などがあります。 |
AWCパラメータ | Awinによってクリックのソースを識別するためにランディングページURLに追加される値です。AWCパラメータまたはバウチャーコードのいずれかの値を提供する必要があります。awc値をクッキーでキャプチャする場合は、以下のガイドラインに従ってください:
|
バウチャーコード | トランザクションのURLエンコードされたバウチャーコードです。AWCパラメータまたはバウチャーコードのいずれかの値を提供する必要があります。 |
通貨コード | 推奨。取引に使用された通貨のISO通貨コードです。例えば、GBP やUSD などです。 |
商品名 | 必須。取引に含まれる商品名の配列です。 |
カスタムパラメータ | 単一または複数のカスタムトラッキングパラメータの入力データです。 |
テストモード | トラッキングリクエストはテスト目的で処理されません。 |
商品
パラメータ | 説明 |
---|---|
商品ID | 必須。取引に含まれるユニークな商品IDの配列です。 |
商品数量 | 必須。取引に含まれる各商品の数量の配列です。 |
商品SKU | 必須。取引に含まれる各商品のSKUの配列です。 |
商品単価 | 必須。取引に含まれる各商品の単価の配列です。この単価は、適用される割引後の価格を反映する必要がありますが、税金や追加料金は適用される前の価格です。値は浮動小数点で、千の区切りは許可されず、小数点は標準のドット文字でなければなりません。 |
商品カテゴリ | 必須。取引に含まれる各商品のカテゴリの配列です。 |
最終更新日 :: 2025年April月29日