__________________________________________________________________________________________________________________

本項の目的:

• 3rdパーティクッキーピクセル方式からパートナライズタグ(PZタグ) への切り替え方法についてご案内いたします。

__________________________________________________________________________________________________________________

目次

• 概要
  • 事前確認事項
• 実装の流れ
• 実装手順
  • Step 1 - Partnerizeへの切り替え連絡
  • Step 2 - Partnerizeタグの作成
  • Step 2b - Clickref設定
  • Step 3 - Partnerizeタグの実装
  • Step 4 - テスト用コンバージョンタグの実装
  • Step 5 - Partnerizeへの実装完了連絡
  • Step 6 - 「TEST-」データの確認
  • Step 7 - Partnerizeタグの本番反映
  • Step 8 - 本番テスト(オプション)
  • Step 9 - 本番切替後確認
• ご質問

概要

昨今、Safariをはじめとした多くのウェブブラウザは3rdパーティクッキーの使用に対する制限を行うようになり、従来の3rdパーティクッキーを利用したピクセルベースの計測に影響を与えています。このガイドでは、既存のピクセル方式での計測から、1stパーティとして計測を行うPartnerize Tagの利用へ切り替える方法について詳しく説明します。

Partnerizeタグとは 

Partnerizeタグは、広告主がウェブサイトに実装するJavascriptです。Partnerizeタグを実装することにより、計測を含めた様々なPartnerizeプラットフォームの機能をより効果的に利用できるようになります。 Partnerizeタグを利用した1stパーティ計測を利用するため、広告主は：

1. ランディングページ(LP)用タグの実装 : LPにPerterizeタグを設置することにより、PartnerizeのクリックID(clickref)が、自動で1stパーティストレージへ格納されます。
2. 完了ページ用タグの実装: 完了ページにPartnerizeタグを設置することにより、1のLPで格納されたclickref情報含むコンバージョンタグに自動的に生成されます。

事前確認事項：

このガイドに従って作業を進める前に以下項目についてご確認ください : 

• 現在3rdパーティクッキーピクセル方式での計測をPartnerizeで行っていること。
• サーバー間通信方式での計測が行われていないこと。
• もし現在、タグマネージャーツールのPartnerizeテンプレートやeコマースプラットフォーム連携(例. Google Tag manager, Shopify, Magento)での計測を行われており、計測方法の変更をご希望場合はintegrations.support@partnerize.com までご連絡ください。

__________________________________________________________________________________________________________________

実装の流れ

現在行われている3rdパーティピクセルの計測を中断することなく切り替えを行うため、下記の手順に従って実装を行なってください。

__________________________________________________________________________________________________________________

実装手順

Step 1 - 依頼 (広告主様)

担当CSまたはintegrations.support@partnerize.com 宛にキャンペーン名とキャンペーンID、切替スケジュール等を記載しご連絡ください。

__________________________________________________________________________________________________________________

Step 2 - Partnerizeタグの作成 (Partnerize)

Partnerizeのインテグレーションチームから実装を行うタグについてご連絡いたします:

• Partnerizeタグ :  Partneriizeの機能を利用するための広告主毎に固有なJavascrpitのコードです。本ガイド下では1stパーティ計測機能を有効にし、clickrefの処理を行ないます。
• コンバージョンタグ : 1stパーティ計測用のコンバージョンタグのhtmlコードです。

__________________________________________________________________________________________________________________

Step 2b - Clickref設定 (Partnerize)

Partnerizeのリンクを使用した広告主様ページへの遷移時にPartnerize ID(clickref)を付与する設定を行います。

• E.g) https://www.brand-site.com?clickref=ABC1234

• E.g) https://www.brand-site.com?clickref=DEF456

__________________________________________________________________________________________________________________

Step 3 - Partnerizeタグの実装 (広告主様)

※実装が必須となるページ:

• Partnerizeのクリックリンクを通して遷移先となる全てのページ

• 完了ページ (注：コンバージョンタグの実装と合わせて行います)

Partnerizeタグコード例) (広告主毎に異なります) : 

<script src="https://pzapi-kg.com/b/XXXXX/YYYYY.js"></script>

• ドメイン (pzapi-kg.com) は広告主毎に異なります。
• XXXXX は広告主IDとなります。
• YYYYY はタグ毎のIDになります。

__________________________________________________________________________________________________________________

Step 4 - コンバージョンタグの実装 (広告主)

コンバージョンタグコード例 (広告主毎にパラメータは異なります) : 

<div data-partnerize="https://prf.hn/conversion/campaign:TEST-<Brand campaign ID>/conversionref:<ORDER ID>/voucher:<VOUCHER>/customertype:<NEW|EXISTING>/[category:<CAT>/sku:<SKU>/value:<PRICE>/quantity:<QTY>]" style="display: none"></div>

従来との3rdパーティピクセルとの相違点

• <DIV> タグを使用します。
• <DIV> タグには“data-partnerize” 属性を使用します。
• タグ内の"style="display: none" のCSS設定を行い非表示にしています。

使用可能文字について

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

❗重要 : 以下切替の実装にあたり、現在動作している3rdパーティタグの削除／変更は行わないでください❗

切り替え前にテスト用タグの実装、及び検証を行うため、既存タグを引き続き利用し計測を行う形となります。新しいPartnerizeタグ計測用のコンバージョンタグは"campaign:TEST-"を付け既存タグとは別に追加で実装します。 

❗NOTE:

• Partnerizeチームは既存タグのURLのパラメータに"campaign:TEST-"を付けたコンバージョンタグを提供します。
• "TEST-" をつけることにより、本番環境での計測は行われませんが、Partnerizeチームはログから既存タグからの計測と比較を行うことが可能となります。
• もし現在複数回のイベントの計測を行っている場合は、全てのコンバージョンタグに対して同様に"TEST-"を付けたdivタグを追加実装してください。
  • 全てのタグについて切替が行えるよう、追加実装するイベントにタグに漏れがないか確認してください。

__________________________________________________________________________________________________________________

Step 5 - 実装完了連絡 (広告主様)

 「campaign:TEST-」を使用したテスト用コンバージョンタグの設定が実装完了後、Partnerizeインテグレーションチームにご連絡ください。（既存の動作している3rdパーティピクセルには変更を行なっていないことを今一度確認してください。）

この時点からPartnerizeに２つのコンバージョンデータが送信されることになります :

• 既存の本番コンバージョン (v1)
• TEST- 付きのテストコンバージョン  (v2)

既存の3rdパーティピクセル (v1) から引き続き本番計測を行い、同時に新しいPartnerizeタグでのテスト計測を送信します。Partnerizeチームはこの２つの送信データを使用し確認を行います。

__________________________________________________________________________________________________________________

Step 6 - 「TEST-」データの確認 (Partnerize)

Partnerizeチームは本番計測データ(v1)とPartnerizeタグテストデータ(v2) の確認し比較を行うことで、本番切替に問題がないかどうかを確認します。

確認内容は下記となります :

• 既存の計測が引き続き問題なく行われているかどうか
• 既存タグからの送信数と、テストPartnerizeタグからの送信数が一致するかどうか
• フォーマットやパラメータに問題がないかどうか
• テストPartnerizeタグに正しい "clickref" が設定されているかどうか
• その他、切り替えにあたり環境設定に問題がないか社内確認を行います

__________________________________________________________________________________________________________________

Step 7 - Partnerizeタグの本番反映 (広告主)

Partnerizeチームは切り替えに問題がないことの確認後、切り替え手順についてご連絡いたします。

広告主様側で下記の作業が必要になります :

• テストPartnerizeタグから「TEST-」を削除
• 既存3rdパーティピクセルタグの削除

修正前例

<div data-partnerize="https://prf.hn/conversion/campaign:TEST-XXXX/conversionref:<ORDER ID>/voucher:<VOUCHER>/customertype:<NEW|EXISTING>/[category:<CAT>/sku:<SKU>/value:<PRICE>/quantity:<QTY>]" style="display: none"></div>

修正後例

<div data-partnerize="https://prf.hn/conversion/campaign:XXXX/conversionref:<ORDER ID>/voucher:<VOUCHER>/customertype:<NEW|EXISTING>/[category:<CAT>/sku:<SKU>/value:<PRICE>/quantity:<QTY>]" style="display: none"></div>

❗注: 

• 上記の変更後、Partnerizeへご連絡ください。
• テストPartnerizeタグを実装してから本番切替までの期間をクッキー有効期限と同様とすることを推奨しています。切替直後から全ての計測に対して1stパーティ計測が行われるようになります。
  

__________________________________________________________________________________________________________________

Step 8 - 本番テスト(オプション) (広告主)

Partnerizeでは本番切替後に計測テストを行うことを推奨しています。

Partnerizeタグによるclickref処理の確認テスト手順は下記にてご案内しております。 (英語) :

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

また、コンバージョンタグについての確認は下記の確認を推奨しています :

• Partnerizeのテストリンクをクリックし、ブラウザのローカルストレージに「_pz_clickref」が作成されていること。
• ランディングページ、及び完了ページのソースコードを確認し、Partnerizeタグが正しく表示されていること。

__________________________________________________________________________________________________________________

Step 9 - 本番切替後確認 (広告主 / Partnerize)

広告主とPartnerizeの両社にて、本番切替後の計測に問題がないかを確認します。

__________________________________________________________________________________________________________________

ご質問