Awin変換コネクタ構成ガイド
この記事では、Awin変換コネクタの構成方法について説明します。
API情報
このコネクタは以下のベンダーAPIを使用します：
動作原理
タグとコネクタを使用したハイブリッド構成を推奨します。この構成により、データの耐久性が最大化され、サーバーサイドデータとのイベントマッチングが改善され、リアルタイムのクライアントサイドデータを保持しながらデータフローの連続性が維持されます。コネクタは、トラフィックのソースを識別するためにawcクエリ文字列パラメータを含む紹介リンクからの変換を帰属するためにAwinタグを使用します。Tealiumの拡張機能を使用するか、awcパラメータを保持してサーバーサイドコネクタから送信することで、購入が正しいコミッショングループにクレジットされることを保証します。
ブラウザの更新により、Awinはピクセルのみの実装をサポートしなくなったため、このコネクタではAwin S2S API実装をフォールバックとして使用できます。
構成
コネクタマーケットプレイスにアクセスして新しいコネクタを追加します。コネクタを追加する一般的な手順については、コネクタについてを参照してください。
コネクタを追加した後、以下の構成を構成します：
- トークン
必須。このトークンは個人のユーザーアカウントにリンクされています。トークンの作成に関する詳細は、AWIN: AW認証および承認を参照してください。 - マーチャント（広告主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があります。 |
| AWCパラメータ | この値は、クリックのソースを識別するためにAwinによってランディングページURLに追加されます。AWCパラメータまたはバウチャーコードのいずれかの値を提供する必要があります。awc値は、クリックのソースを識別するためにAwinによってランディングページURLに追加されるパラメータです。エンドユーザーがサイトに到着したときに、サーバーサイドのスクリプト言語を使用してawc値を記録するようにサイトを構成する必要があります。この値は変換時にcksパラメータを入力するために使用されます。この機能はすべてのページで呼び出す必要があります。awc値をクッキーでキャプチャしている場合、以下のガイドラインに従ってください：
|
| バウチャーコード | トランザクションのURLエンコードされたバウチャーコード。AWCパラメータまたはバウチャーコードのいずれかの値を提供する必要があります。 |
| 通貨コード |
|
| カスタムパラメータ | 単一または複数のカスタムトラッキングパラメータの入力データ。 |
| テストモード | トラッキングリクエストはテスト目的で処理されません。 |
商品レベルの変換
商品レベルのトラッキングにより、広告主は個々の製品のパフォーマンスを測定できるようになり、より詳細なレポートを作成することができます。
パラメータ
| パラメータ | 説明 |
|---|---|
| 合計金額 | 必須。適用される割引後、税金、配送料、その他の関連サービス料金を加算する前の注文の小計。値はfloatデータ型で、千の区切りは使用せず、小数点は標準のドット(.)文字である必要があります。 |
| 注文参照 | 必須。ユニークな予約または注文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の配列。 |
| 商品単価 | 必須。トランザクション内の各商品の単価の配列。この単価は、適用される割引後、税金や追加料金が適用される前の価格を反映する必要があります。値はfloatで、千の区切りは使用せず、小数点は標準のドット文字である必要があります。 |
| 商品カテゴリ | 必須。トランザクション内の各商品のカテゴリの配列。 |
| カスタムパラメータ | 単一または複数のカスタムトラッキングパラメータの入力データ。 |
| テストモード | トラッキングリクエストはテスト目的で処理されません。 |
最終更新日 :: 2025年March月27日