この記事では次の内容について説明します：
概要
Klearは、追跡ピクセルを介してコンバージョンを追跡する機能を提供します。 [Klear設定] > [統合]には、コンバージョントラッキングを有効にするためにウェブサイトに追加する必要がある[Klear]タグとイベントスニペットを含む[Klearコンバージョンピクセル]セクションがあります。
Klearコンバージョンピクセル設定
ピクセルがインストールされると、トラッキングピクセルのステータスを確認できます。
Klearコンバージョンピクセル設定での表示
ニーズに応じて、Klearコンバージョンピクセルをフロントエンドとバックエンドの両方を通じてクッキーとして統合するサポートを提供しています。
フロントエンドの使用
コンバージョンを正常に追跡するには、独自のクライアントIDでKlearコンバージョンピクセルを初期化し、各コンバージョンイベントをKlearにプッシュする一般的なKlearタグを追加する必要があります。 両方の部分の詳細については以下で説明します。それぞれにGoogleタグマネージャーの使用ガイドが含まれています。
一般情報
クッキー名： | klear-aff-track |
プロバイダー | klear.com |
リテンション | コンバージョンは、クッキーを開始した最後のクリックから30日以内にトラッキングされます。 |
Klearタグ
最初のスニペットはKlearタグです。これはKlearコンバージョンピクセルをお客様に固有のクライアントIDで初期化します。 サイトの<head>タグ内に配置することをお勧めします。
Klearコンバージョンピクセル設定には、一意のクライアントIDを含む完全なタグが表示されます：
<script>(function(k, l, e, a, r) { if (typeof k[e] !== 'undefined') return; k[e] = []; var el = l.createElement('script'); el.async = true; var objQ = e !== 'klrq' ? '&o=' + e : '';el.src = a + '?id=' + r + objQ + '&klAff'; var m = l.getElementsByTagName('script')[0];m.parentNode.insertBefore(el, m);}) (window, document, 'klrq', 'https://klear.com/dist/klrTrack.bundle.js', 'UNIQUE_CLIENT_ID');</script> |
Klearタグ
ピクセルがウェブサイトに正しく追加されたことを確認するには、変更後に一度ウェブサイトにアクセスし、アカウント設定のKlear変換ピクセルインジケーターで接続ピクセルとして表示されるかどうかを確認します。
あるいは、次のページから呼び出しが成功したかどうかを確認できます。
https://klear.com/node-api/affTrack/verify/UNIQUE_CLIENT_ID |
Googleタグマネージャー（Klearタグ）
ウェブサイトにGoogleタグマネージャーがインストールされている場合は、次の手順に従って、それを使用してKlearタグを追加できます。
「タグ」タブで、「新規」をクリックします
「タグ設定」をクリックし、「カスタムHTML」を選択します
設定>統合>Klearコンバージョンピクセルで、Klearタグをコピーして、HTML入力フィールドに貼り付けます
「詳細設定」をクリックし、タグ起動オプションとして「ページごとに1回」を選択します
[トリガリング]をクリックし、[すべてのページ]を選択します
タグを保存します
変更を公開します
コンバージョンイベント
コンバージョンイベントをKlearにプッシュするには、
klrq.push(['conversion', PROPERTIES])にコールする必要があります。
プロパティについては、以下の通りです。
これを行うには、例えば、コンバージョンを追跡したいページの<head>タグ内にイベントスニペットを配置します（例：www.example.com/thank-you-page）。[Klear]タグのすぐ後です。
<script>klrq.push(['conversion', { value: こちらに値を挿入, name: こちらに名前を挿入, currency: こちらに通貨を挿入, 写真: こちらに写真を挿入, items: こちらにアイテムを挿入 }])</script> |
イベントのスニペット
コンバージョンには次のプロパティを含めることができますが、すべてオプションです：
プロパティタイプ | 値のタイプ | 説明 |
名前 | ストリング | バージョンアイテムの名称。 デフォルト：「コンバージョン」 |
数値 | 数字 | コンバージョンの値（該当する場合は割引後）。 デフォルト：0 |
通貨 | ストリング | コンバージョン通貨。 ISO 4217 通貨コード。 デフォルト：「USD」 |
写真 | ストリング | コンバージョンに関連付ける画像のURL |
アイテム | コンバージョンアイテムの配列 | コンバージョン内のアイテムの配列（次の表を参照） |
クーポン | ストリング | クーポンコードの名前 |
コンバージョンプロパティ
変換は次のようになります：
klrq.push(['conversion', { 値：10.1、 名前：「靴」、 通貨：「USD」、 クーポン：「SUMMERSALE20」、 }]) |
コンバージョンイベントの例
コンバージョンにはアイテムを含めることができます。 コンバージョンにアイテムが含まれている場合、そのアイテムのプロパティがコンバージョンの関連プロパティを上書きします：
プロパティタイプ | 値のタイプ | 説明 |
名前 | ストリング | コンバージョンアイテムの名前。 デフォルト：「コンバージョン」 |
数値 | 数字 | 単品の金額（割引が適用される場合は、割引後の金額）。 デフォルト：0 |
写真 | ストリング | アイテムに関連付ける画像のURL |
product_link | ストリング | アイテムに関連付ける製品のURL |
数量 | 数字 | アイテムの数量。 デフォルト：1 |
コンバージョンアイテムのプロパティ
アイテムを使用したコンバージョンは次のようになります：
リクエストヘッダー |
本文 { 「clientId」：「UNIQUE_CLIENT_ID」、 「linkId」：「KLEAR_LINK_ID」、 「coupon」：「SUMMERSALE20」、 「通貨」: 「USD」、 「items」：[{ 「value"」：9.95、 「名前」: 「靴」 「数量」: 2、 "picture":"https://klear.com/images/new/logo/logo_dark_mw.png", "product_link": "https://www.example.com/category/shoes-bags-accs/shoe" }, { 「値」: 10.5、 「名前」: 「帽子」 }] } |
アイテムを使用したコンバージョンの例 （バックエンドの使用）
重要な注意事項：靴の価格は1アイテムあたり9.95です（割引後の価格が9.95のアイテムが2つあります）。
Googleタグマネージャー（コンバージョンイベント）
ウェブサイトにGoogleタグマネージャーがインストールされている場合は、次の手順に従って、それを使用してKlearタグを追加できます。
「タグ」タブで、[新規]をクリックします
[タグ設定]をクリックし、[カスタムHTML]を選択します
Klearコンバージョンピクセル設定からイベントスニペットをコピーし、HTML入力フィールドに貼り付けます。 希望するコンバージョンプロパティを、利用可能な購入データに置き換えます。 ウェブデベロッパーにこのデータをGoogleタグマネージャーデータレイヤーに追加するように依頼する必要があるかもしれません
[詳細設定]をクリックします。使用するトリガーによっては、タグ起動オプションとして「1ページに1回」を選択することをお勧めします
[トリガー]をクリックし、コンバージョンを追跡したいページのページビューに対するトリガーを設定します（例： www.example.com/thank-you-page）
タグを保存します
変更を公開します
バックエンドの使用
上記のフロントエンドソリューションの代わりに、以下にPOSTリクエストを送ることもできます：
これを行うには、まずページからの呼び出しでクライアントIDを検証する必要があります
https://klear.com/node-api/affTrack/verify/UNIQUE_CLIENT_ID |
UNIQUE_CLIENT_IDは、Klearタグの一部としてKlearコンバージョンピクセル設定で見つけることができます。もう1つ必要なパラメータは、Klearトラッキングリンクの一部であるKLEAR_LINK_IDです。
Klearトラッキングリンクは次のようになります：
https://www.example.com?klear_link_id=KLEAR_LINK_ID&utm_source=klear&utm_medium=influencer&utm_ campaign=ambassador_program |
ホストヘッダーには、コンバージョンの起源（コンバージョンが行われた店舗のウェブサイト）を必ず含めてください。
リクエスト本文には必ずUNIQUE_CLIENT_IDを含めてください。また、リクエスト本文には、上述のKLEAR_LINK_IDプロパティ、または使用されるクーポンコードのうち少なくとも1つを含める必要があります。 追加のコンバージョンプロパティは任意です：
プロパティタイプ | 値のタイプ | 説明 |
クライアントID | ストリング | Klearコンバージョンピクセル設定のKlearタグにあるUNIQUE_CLIENT_ID（必須） |
リンクID | ストリング | KlearトラッキングリンクのKLEAR_LINK_IDクエリーパラメーター |
クーポン | ストリング | クーポンコードの名前 |
名前 | ストリング | コンバージョンアイテムの名前。 デフォルト：「コンバージョン」 |
数値 | 数字 | コンバージョンの値（該当する場合は割引後）。 デフォルト：0 |
通貨 | ストリング | コンバージョン通貨。 ISO 4217 通貨コード。 デフォルト：「USD」 |
写真 | ストリング | コンバージョンに関連付ける画像のURL |
アイテム | コンバージョンアイテムの配列 | コンバージョン内のアイテムの配列（次の表を参照） |
コンバージョンプロパティ（バックエンドの使用）
コンバージョンにはアイテムを含めることができます。 コンバージョンにアイテムが含まれている場合、そのアイテムのプロパティがコンバージョンの関連プロパティを上書きします：
プロパティタイプ | 値のタイプ | 説明 |
名前 | ストリング | コンバージョンアイテムの名前。 デフォルト：「コンバージョン」 |
数値 | 数字 | 単品の金額（割引が適用される場合は、割引後の金額）。 デフォルト：0 |
写真 | ストリング | アイテムに関連付ける画像のURL |
product_link | ストリング | アイテムに関連付ける製品のURL |
数量 | 数字 | アイテムの数量。 デフォルト：1 |
コンバージョンアイテムのプロパティ
アイテムを使用したコンバージョンは次のようになります：
リクエストヘッダー |
本文 { 「clientId」：「UNIQUE_CLIENT_ID」、 「linkId」：「KLEAR_LINK_ID」、 「coupon」：「SUMMERSALE20」、 「通貨」: 「USD」、 「items」：[{ 「value"」：9.95、 「名前」: 「靴」 「数量」: 2、 "picture":"https://klear.com/images/new/logo/logo_dark_mw.png", "product_link": "https://www.example.com/category/shoes-bags-accs/shoe" }, { 「値」: 10.5、 「名前」: 「帽子」 }] } |
アイテムを使用したコンバージョンの例 （バックエンドの使用）
重要な注意事項：靴の価格は1アイテムあたり9.95です（割引後の価格が9.95のアイテムが2つあります）。
💡ヒント
さらに詳しく知りたいですか？チャットサポートでお問い合わせいただくか、 Customer Community（英語） をご覧ください。
MeltwaterのカスタマーサポートチームとCommunityの専門家がご質問にお答えします。