__________________________________________________________________________________________________________________
本項の目的:
- 3rdパーティcookieピクセル方式から1stパーティストレージを利用したclickrefピクセル方式への切り替え方法についてご案内いたします。
__________________________________________________________________________________________________________________
目次
____________________________________________________________________________________
概要
Clickrefピクセル計測は、従来の3rdパーティcookieを利用した計測方式に変わり、Partnerizeが生成するクリックID"clickref"と広告主様サイトの1stパーティストレージを利用した計測方法となります。Clickrefピクセル計測への切り替えにより、計測の信頼性向上が見込まれます。
事前準備 :
clikrefピクセル計測の実装を始める前に下記をご確認ください :
- 現在3rdパーティcookieピクセル方式での計測が行われていること。
- サーバー間通信方式、またはPartnerizeタグへの切り替えが難しいこと
- もし現在広告主様のWebページにおいてタグマネージャーや、eコマース向けプラットフォーム(Google Tag manager, Shopify, Magento等)を使用されている場合は、Partnerizeのインテグレーションチーム (integrations.support@partnerize.com)までお問い合わせください。
_________________________________________________________________________________________________________________
実装の流れ
現在行われている3rdパーティピクセルの計測を中断することなく新しい計測(clickrefピクセル)への切り替えを行うため、下記の手順に従って実装を行なってください:
手順 | 概要 | 担当 |
1. 1stパーティストレージへのclickrefの格納処理の実装 | Partnerizeからの流入時に受け取るclickrefの値を、1stパーティストレージへ格納する処理を実装します。 | 広告主様 |
2. テスト用コンバージョンタグの実装 |
テストコンバージョンタグを追加で実装します。 ❗注: 既存の3rdパーティピクセルのコンバージョンタグは削除しないようご注意ください。 |
広告主様 |
3. Patnerizeへのテストコンバージョンタグ実装完了の連絡 | 「2」の実装完了後にPartnerizeへご連絡ください。 | 広告主様 |
4. テストclickrefピクセルデータの確認 | テストコンバージョンデータの確認を行います。 | Partnerize |
5. 本番計測の切替 | 3rdパーティピクセルからclickrefピクセルへの本番計測の切替を実施します。 | 広告主様 |
6. 本番反映後の計測確認 | 切り替え後の計測データの確認を行います。 | 広告主様 / Partnerize |
__________________________________________________________________________________________________________________
実装手順
Step 1 - 1stパーティストレージへのclickrefの格納処理の実装
Partnerizeのリンクを使用して広告主様のウェブサイトへ遷移する際に、URLのパラメータにクリック毎のID(clickref)が追加されます。
- 例) https://www.brand-site.com?clickref=ABC1234
clickrefの値はクリック毎に変更されます。
- 例) https://www.brand-site.com?clickref=DEF456
パートナーに正しく成果報酬を支払うため、このURLのパラメータとして付与された「clickref」を広告主様ページの1stパーティストレージ(クッキー、ローカルストレージ)に格納し、成果発生時にコンバージョンデータ内に含めてPartnerizeへ送信する必要があります。
❗注:
- ラストクリックに対して報酬を設定する場合、最新のclickrefの値を常に保持するよう実装してください。
- 計測方法の切り替えを行う前に、clickrefの値を広告主様1stパーティストレージに格納する処理を、現在設定しているクッキー有効期間(クリックからコンバージョンまでの有効期間)の日数分先立って実装する必要があります。たとえばクッキー有効期間を30日に設定している場合は、計測切替日から少なくとも30日前にclickrefの格納処理を実装します。これは切り替え時にクッキー有効期間の間のクリックの計測漏れを防ぐための対応となります。
- 「Clickref」はクリック毎に更新されるIDであり、この値を正しくコンバージョンに設定することで、パートナーへの成果付与を正しく行うことができます。
__________________________________________________________________________________________________________________
Step 2 - テスト用コンバージョンタグの実装
計測漏れを防ぐため、まず現在本番環境で動作中の3rdパーティピクセル計測は変更せずに設置した状態まま、別途追加する形で、「TEST-」の記述を用いたテスト用コンバージョンタグを実装することを推奨しています。
❗注:
- こちらの手順を行わず、直接clickrefピクセル形式への変更を行なった場合、新規設置タグに何らかの問題が発生した際にも、事象の把握に時間がかかり計測漏れが起きる可能性が高くなります。
■「TEST-」を付与したclickrefピクセルのURL例:
現在動作している3rdパーティピクセルのコンバージョンタグが以下の形の場合、
<img src="https://prf.hn/conversion/campaign:XXXXXXX/conversionref:CONVERSIONREF[category:CATEGORY/sku:SKU/value:VALUE/quantity:QUANTITY]" width="2" height="1" />
「TEST-」を使用したテストコンバージョンタグは以下のようになります。
<img src="https://prf.hn/conversion/campaign:TEST-XXXXXXX/tmethod:1/tplatform:1/tdetail:10/clickref:TEST-CLICKREF/conversionref:CONVERSIONREF/[category:CATEGORY/sku:SKU/value:VALUE/quantity:QUANTITY]" width="2" height="1" />
■変更点について
現在動作しているピクセルタグから2つの変更点があります。現在ページに設置されているピクセルタグは変更せず、コピーして追加する形で実装を進めてください。
- 'campaign:TEST-XXXXXXX': キャンペーンIDの値の手前に「TEST-」を追加してください。
- 'clickref:TEST-CLICKREF': clickrefというパラメータを新規に追加し、clickrefの値はStep1にて広告主様の1stパーティストレージに保持した値を取得し、その値の前に「TEST-」を追加した形で実装してください。
- 'tmethod:1/tplatform:1/tdetail:10/' : これらのパラメータは、コンバージョンをどのように追跡しているかを Partnerize に明示的に伝えます。この情報は、トラッキングの問題を調査し、問題解決を促進するのに役立ちます。
使用可能文字について
-
/
,#
,+
,\
,"
の記号はURLエンコードをしていない場合、予期せぬ変換が起こる可能性があります。 - スラッシュ ( / ) , コロン ( : ) , 角括弧 ( [ ] ) はPartnerizeシステムにおいて予約後となっており、値として使用しないようにしてください。
- 半角数字とアルファベット以外の文字/記号を使用する場合はURLエンコードを使用するようにしてください。
- 例) 半角スペースはURLエンコードを行うと
%20
となります。conversionref:test 001
をURLエンコードした値はconversionref:test%20001
となります。
- 例) 半角スペースはURLエンコードを行うと
- 金額を設定する
value
パラメータの値は、通過記号と桁区切りのカンマを除外し設定してください。- 例) "$1,980.99" の場合、 "1980.99" と設定してください。
もし現在動作している3rdパーティピクセルタグについて不明な場合、Partnerizeインテグレーションチーム( integrations.support@partnerize.com)にご連絡ください。現在計測が行われているコンバージョンを情報を共有いたします。
__________________________________________________________________________________________________________________
Step 3 - Patnerizeへのテストコンバージョンタグ実装完了の連絡
Step 1のclickref格納処理の実装と、Step 2の「TEST-」をつけたテストコンバージョンタグの追加実装が完了しましたらPartnerizeにご連絡ください。
この時点で既存の3rdパーティピクセルからのコンバージョンとclickrefピクセル形式のテストコンバージョンの両方がPartnerizeに送信されていることになります。テストコンバージョンの管理画面への反映は行われないため、広告主様管理画面での確認はできませんが、Partnierzeチームが受信ログを確認しテストコンバージョンの確認を行います。
__________________________________________________________________________________________________________________
Step 4 - テスト用clickrefピクセルデータの確認
この2つの結果の送信件数の確認やフォーマット、データ内容の比較確認を行うことで、新しいclickrefピクセル計測への切り替えを行うにあたり、問題がないかどうかの確認を行います。
確認項目は以下の通りです :
- 既存の3rdパーティピクセルの本番計測が変わらず行われていること
- 3rdパーティピクセルと同じ件数のテストコンバージョンが送信されていること。
- テストコンバージョンのフォーマットに問題がないこと
- 本番計測と比較してパラメータやデータに漏れがないこと
- テストコンバージョンに正しいclickrefの値が設定されていること
__________________________________________________________________________________________________________________
Step 5 - 本番計測の切替
テストコンバージョンデータより、切替を行うことに問題がないことが確認できた段階で、本番切り替えを行う日程について広告主様と調整を行います。本番切替を実行する日は、clickref格納処理の実装からの経過日数が、キャンペーンで設定しているクッキー有効期間の日数を超えた後の設定となります。
本番計測の切り替えは広告主様に以下の作業を行っていただくことになります。
- テストコンバージョンタグのcampaignパラメータの値から「TEST-」を削除します。
- テストコンバージョンタグのclickrefパラメータの値から「TEST-」を削除します。
- 3rdパーティピクセルタグを削除します。
- 上記3つのアクションが完了した旨、Partnerizeへご連絡ください。
修正前 - 切り替えを行う前のテストコンバージョンタグ例:
<img src="https://prf.hn/conversion/campaign:TEST-XXXXXXX/tmethod:1/tplatform:1/tdetail:10/clickref:TEST-CLICKREF/conversionref:CONVERSIONREF/[category:CATEGORY/sku:SKU/value:VALUE/quantity:QUANTITY]" width="2" height="1" />
修正後 - 切り替えを行なったあとのコンバージョンタグ例:
<img src="https://prf.hn/conversion/campaign:XXXXXXX/tmethod:1/tplatform:1/tdetail:10/clickref:CLICKREF/conversionref:CONVERSIONREF/[category:CATEGORY/sku:SKU/value:VALUE/quantity:QUANTITY]" width="2" height="1" />
「TEST-」を削除したコンバージョンが本番用のclickrefピクセルタグとなります。
本番環境のタグの切替処理が完了しましたらPartnerizeにご連絡ください。
__________________________________________________________________________________________________________________
Step 6 - 本番反映後の計測確認
本番環境での計測の切り替え後、問題なく計測が行われているか、広告主様とPartnerizeの両社で確認を行います。
引き続き計測が上がること、コンバージョンのデータに問題がないことを両社とも確認を行い、切り替え作業を完了とします。
__________________________________________________________________________________________________________________
ご質問
実装に関するその他技術的なご質問に関しましては、 integrations.support@partnerize.com までお問い合わせ下さい。