_________________________________

本項の目的:

• Partnerizeの Clickref ピクセル方式の実装手順についてご案内いたします。

❗注: すでにPartnerizeでの計測を行なっており、計測方法の変更手順について確認される場合は Optimisation Guides をご参照ください。

__________________________________________________________________________________________________________________

Index

• 概要
• 実装手順
  • Step 1 - クリック計測
  • Step 2 - コンバージョン計測
    
    • コンバージョンタグ例
    • コンバージョンレベルのパラメータ
    • 設定例
    • メタデータ計測

    • 業種別メタパラメータ 設定例

• テスト

• その他

• ご質問

概要

Clickref ピクセルトラッキングは、アフィリエイトマーケティングにおいて、一般的なトラッキング方法であったピクセルに代わるトラッキング方式です。3rdパーティクッキーによるトラッキングに対して、リアルタイムトラッキングの代替ソリューションになります。

Partnerizeの Clickref ピクセルトラッキングは下記のような広告主に適しています

• 3rdパーティクッキーによるトラッキングを避けたい広告主
• PartnerizeタグやS2Sによるトラッキングを行うことができない広告主
• 3rdパーティ社製のツールを用いてトラッキングの実装を行いたい広告主

Clickref ピクセルは、Partnerize のサードパーティ cookie に依存するのではなく、Partnerize ID「clickref」を利用して流入元を識別するソリューションです。広告主は、1stパーティとしてのストレージに「clickref」を保持するため、より堅牢で信頼性の高いトラッキングソリューションが実現します。

__________________________________________________________________________________________________________________

実装手順

Clickrefピクセル方式でトラッキングを行うには、下記の通り2種類の実装が必要となります。

__________________________________________________________________________________________________________________

Step 1 - クリック計測

• 例 1 : https://www.brandsite.com?clickref=abc123

広告主様は最新のclickrefの値を、広告主のローカルストレージや1stパーティCookieに保存する必要があります。ユーザーが初回の訪問で購買アクションを行わず、再度Partnerizeリンクをクリックして再訪問した場合は新しいclickrefの値を上書き、及び有効期限を再設定する必要があります。

• 例 2 : https://www.brandsite.com?clickref=def456

❗注:

• 広告主サイト遷移時に付与されるclickrefというパラメータ名は、ご希望のパラメータ名に変更可能です。実装開始前にPartnerizeにご相談ください。
  

• clickrefの値はクリック毎発行されるIDです。ラストクリックベースでの報酬設定を予定されている場合、正確にパブリッシャーに報酬を付与するため、広告主は最新のclickrefの値を保持する必要があります。

__________________________________________________________________________________________________________________

Step 2 - コンバージョン計測

購入／申込完了の成果発生時に、最新のclickref情報を含めてタグの発火を行う必要があります。コンバージョンデータを送信するURLは、広告主様のご要望内容に応じて異なる点にご注意ください。

コンバージョンタグ例

<img src="https://prf.hn/conversion/campaign:{CAMPAIGNID}/tmethod:{TMETHOD}/tplatform:{TPLATFORM}/tdetail:{TDETAIL}/clickref:{CLICKREF}/conversionref:{ORDERID}/country:{COUNTRY}/currency:{CUR}/customertype:{new|existing}/voucher:{VOUCHER}/[category:{CAT}/sku:{SKU}/value:{VALUE}/quantity:{QTY}]" height ="1" width ="2" />

使用可能文字について

• /, #, +, \ , " の記号はURLエンコードをしていない場合、予期せぬ変換が起こる可能性があります。
• スラッシュ ( / ) , コロン ( : ) , 角括弧 ( [ ] ) はPartnerizeシステムにおいて予約後となっており、値として使用しないようにしてください。
• 半角数字とアルファベット以外の文字/記号を使用する場合はURLエンコードを使用するようにしてください。
  • 例)  半角スペースはURLエンコードを行うと %20 となります。conversionref:test 001 をURLエンコードした値は  conversionref:test%20001 となります。
• 金額を設定するvalueパラメータの値は、通過記号と桁区切りのカンマを除外し設定してください。
  • 例)  "$1,980.99" の場合、 "1980.99" と設定してください。

コンバージョンレベルのパラメータ

コンバージョンタグののURLに複数のパラメータを設定しコンバージョンデータの登録を行います。パラメータ名と値をコロン ( : ) で組み合わせ、各パラメータ毎にスラッシュ ( / ) を区切りとしてパラメータの設定を行ってください。

❗注: パラメータに登録する値がない場合、空文字のまま送付することが可能です。（.../voucher:/...)

__________________________________________________________________________________________________________________

アイテムレベルのパラメータ：

コンバージョンは成果単位のみでなく、[ ](角括弧)を使用することで、成果に紐づく各アイテムレベルのデータを登録を行うことが可能です。(例、1回の購入行動だけでなく、それぞれの購入商品などの情報をアイテムレベルに登録が可能)

ご利用できるパラメータは以下の通りです。全てのパラメータは必須ではありませんが、より多くのデータを可視化できるよう、可能な限り多くの情報をコンバージョンデータとして生成することを推奨しています。

❗注:

• 成果単位の金額はアイテムレベルのvalueとquantityを乗算した値を全てのアイテムで合計した値が表示されます。

• 個人情報（Personal Identifiable Information, PII）を特定できるようなデータを設定しないよう注意してください (例: email アドレス、住所、電話番号等).

_________________________________________________________________________________________________________________

設定例

単一商品時の実装例 :

Note certain parameters are left blank if no value 

<img src="https://prf.hn/conversion/campaign:XXXXXX/tmethod:1/tplatform:1/tdetail:10/clickref:def456/conversionref:87971/country:GB/currency:GBP/customertype:/voucher:/[category:SHOES/sku:4A7CAA/value:50.99/quantity:1]" height ="1" width ="2" />

複数商品時の実装例:

Example Involving 2 Bags and 1 Shoes. Note the usage of two separate item blocks [ ] :

<img src="https://prf.hn/conversion/campaign:XXXXXX/tmethod:1/tplatform:1/tdetail:10/clickref:def456/conversionref:787977/country:US/currency:USD/customertype:existing/voucher:Discount10/[category:BAG/sku:bao98/value:35.00/quantity:2]/[category:SHOES/sku:4A7CAA/value:50.99/quantity:1]" height ="1" width ="2" />

❗注:

• 成果レベルの合計金額は各商品ごとの単価(valueに設定された値)を元に自動で計算されます。
• campagin:XXXXXXはテスト用の表示です。XXXXXXの部分には個別のキャンペーンIDを設定してください。キャンペーンIDがわからない場合はPartnerizeにご確認ください。
• clickrefには最新の値を設定するようにしてください。ユーザーが最後に利用したパブリッシャーに成果が紐付けされます。

__________________________________________________________________________________________________________________

メタデータ計測

Partnerizeは、標準で用意されたパラメータ以外にも、任意のパラメータを利用可能な柔軟な成果計測を提供しています。広告主は可能な限りのメタデータを成果データとして付与することが可能です。これにより広告主は最適化を目的とした、より詳細な分析が可能になります。 

メタパラメータは標準パラメータと同様にはスラッシュ”/”により区切られ、「/parameter_name:value/」の形で設定します。parameter_nameは広告主が必要に沿った名称で設定します。

メタデータ実装例 (例 : パラメータ : delivery_cost)

<img src="https://prf.hn/conversion/campaign:XXXXXX/tmethod:1/tplatform:1/tdetail:10/clickref:def456/conversionref:87971/country:GB/currency:GBP/customertype:new/voucher:/[category:SHOES/sku:4A7CAA/value:45.20/quantity:1/delivery_cost:free]" height ="1" width ="2" />

業種別メタパラメータ 設定例

以下のページにて各業種で頻繁に利用されるパラメータ一覧が参照できます。 

https://help.phgsupport.com/hc/en-us/articles/4410042606225-Vertical-Specific-Tracking-Parameters 

❗注:

• 「destination」はパラメータ名として設定できません。

__________________________________________________________________________________________________________________

トラッキング方法、プラットフォーム&詳細の設定

トラッキングの方法とプラットフォームの情報をコンバージョンに付与することで、計測に不具合が起きた際の調査をよりスムーズにすることができます。

トラッキング方法 (tmethod)

プラットフォーム (tplatform)

詳細 (tdetail)

クリックレフピクセル計測においては「tmethod:1/tplatform:1/tdetail:10」をURLに追加してください。

Example:

<img src="https://prf.hn/conversion/campaign:XXXXXX/tmethod:1/tplatform:1/tdetail:10/clickref:def456/conversionref:87971/country:GB/currency:GBP/customertype:new/voucher:/[category:SHOES/sku:4A7CAA/value:45.20/quantity:1/delivery_cost:free]" height ="1" width ="2" />

__________________________________________________________________________________________________________________

テスト

実装完了後に広告主様側にて本番環境でテストを実施し、正常に計測が行われるか確認を行います。ノーセッションテストは必ず行うようにしてください。リンクをクリックしてからコンバージョンの発生がクッキー有効期限内であれば計測が行われます。

基本的なテスト手順は下記URLから参照いただけます。(英語)

https://help.phgsupport.com/hc/en-us/articles/360019824018-Testing-Tracking-Solutions-FAQs

コンバージョンテストの前に、clickrefが正しく広告主様の1stパーティのストレージ(localstorage, 1st party cookie)に格納されているか確認することで、よりスムーズにテストを実施することができます。

※確認手順

• テストリンクを使用しLPに遷移
• ブラウザの開発者ツール等を使用し、URLのパラメータに付与されたclickrefの値が格納されているか確認
• テストリンクを再度使用してLPへの遷移を行い、格納されたclickrefの値が新しいものに変更されることを確認

__________________________________________________________________________________________________________________

その他

• キャンペーンIDとURLのパラメータにclickrefが付与される設定になっているかご確認ください。不明な場合は、Partnerizeインテグレーションチーム integration.support@partnerize.com へご連絡下さい。
• 計測漏れを防ぐため、必ず上記の手順に従って実装、及びキャンペーン開始前の本番環境テストを実施して下さい。
  

__________________________________________________________________________________________________________________

ご質問

別途、ClickrefピクセルのQ&Aとして以下ページもご参照ください。

Clickref pixel FAQ's

その他実装に関するその他技術的なご質問に関しましては integrations.support@partnerize.com までお問い合わせ下さい。