概要
Piano Insight では、ページをクロールして、そのページからキーワードを抽出します。
その抽出したキーワードをそのページを見たユーザーのプロファイルに格納していきます。
各ページにカスタムのユーザー属性として、意図的に任意のパラメーターを付与することができます。
そのパラメーターを付与されたページにアクセスしたユーザーは、そのパラメーターを
自分のプロファイルとして格納していきます。
カスタムのユーザー属性の付与方法として、下記の2種類の方法があります。
-
Javascriptによる付与（推奨）
-
HTTP API による付与
カスタムユーザーの属性は、グループとバリューで構成されます。
例えば、cat:it の場合、catというグループでそのバリューがitという形です。
他のページでは、categoryグループに別のfinanceというバリューを定義することもできます。
また、categoryグループではなく、任意の他のグループを定義することもできます。
それで、各グループごとに異なるバリューを定義できます。
広告主は、このカスタムユーザー属性に対してターゲティングができます。
利用可能なテンプレートは、下記のテンプレートです。
-
キーワードテンプレート
属性のグループ名は関係なく、カスタムユーザー属性として設定した値を広告主は入札する。
例：カスタム属性値がcategory:it であれば、itというキーワードで入札します。
-
リターゲティングテンプレート
広告主は、グループと値を指定して入札を行います。
例：広告主は、グループ名がcategoryでありitという値を持つユーザーに対して入札します。
また、どちらのテンプレートで利用するかにより、設定するグループ名の接頭辞が変わります。
詳細は下記に記載します。
Javascriptによるカスタム属性の付与（推奨）
Piano Insight のスクリプトに下記の行を追加します。
cX.callQueue.push(['setCustomParameters', {'グループ名': ['バリュー']}]); // ターゲティングには使用しない場合（Piano Insightで特定のトラフィックを参照したい場合） cX.callQueue.push(['setUserProfileParameters', {'グループ名': 'バリュー'}]); // キーワードテンプレートを利用する場合 cX.callQueue.push(['setRetargetingParameters', {'グループ名':'バリュー'}]); // リターゲティングテンプレートを利用する場合
例：category(グループ):it(値)でキーワードテンプレートで利用する場合
<script type="text/javascript"> var cX = cX || {}; cX.callQueue = cX.callQueue || []; cX.callQueue.push(['setAccountId', 'XXX']); cX.callQueue.push(['setSiteId', 'YYY']); cX.callQueue.push(['setUserProfileParameters', {'category': ['it']}]); cX.callQueue.push(['sendPageViewEvent']); </script> <script type="text/javascript"> (function() { try { var scriptEl = document.createElement('script'); scriptEl.type = 'text/javascript'; scriptEl.async = 'async'; scriptEl.src = ('https:' == document.location.protocol) ? 'https://scdn.cxense.com/cx.js' : 'http://cdn.cxense.com/cx.js'; var targetEl = document.getElementsByTagName('script')[0]; targetEl.parentNode.insertBefore(scriptEl, targetEl); } catch (e) {};} ()); </script>
※キーワードテンプレートを利用したい場合には、setUserProfileParametersを利用します。
例：category(グループ):it(値)でリターゲティングテンプレートで利用する場合
<script type="text/javascript"> var cX = cX || {}; cX.callQueue = cX.callQueue || []; cX.callQueue.push(['setAccountId', 'XXX']); cX.callQueue.push(['setSiteId', 'YYY']); cX.callQueue.push(['setRetargetingParameters', {'category': 'it'}]); cX.callQueue.push(['sendPageViewEvent']); </script> <script type="text/javascript"> (function() { try { var scriptEl = document.createElement('script'); scriptEl.type = 'text/javascript'; scriptEl.async = 'async'; scriptEl.src = ('https:' == document.location.protocol) ? 'https://scdn.cxense.com/cx.js' : 'http://cdn.cxense.com/cx.js'; var targetEl = document.getElementsByTagName('script')[0]; targetEl.parentNode.insertBefore(scriptEl, targetEl); } catch (e) {};} ()); </script>
※リターゲティングテンプレートを利用したい場合には、setRetargetingParametersを利用します。
また、同じキーで複数の値を送付したい場合には下記のようにします。
cX.callQueue.push(['setRetargetingParameters', { 'category':['it', 'enterprise'] }]);
HTTP API による付与
Javascriptを利用できないアプリケーションなどで利用します。
HTTP API でCustom parameterを付与します。
&cp_u_グループ名=値 // キーワードテンプレートを利用する場合 &cp_t_グループ名=値 // リターゲティングテンプレートを利用する場合
例：category(グループ):it(値)でキーワードテンプレートで利用する場合
http://comcluster.cxense.com/Repo/rep.html?ver=1&typ=pgv&sid=1234&ckp=user12345&rnd=0.52254374988082919&loc=http%3A//example.com/app%3Fa%3Db%26c%3D&cp_u_category=it
例：category(グループ):it(値)でリターゲティングテンプレートで利用する場合
http://comcluster.cxense.com/Repo/rep.html?ver=1&typ=pgv&sid=1234&ckp=user12345&rnd=0.52254374988082919&loc=http%3A//example.com/app%3Fa%3Db%26c%3D&cp_t_category=it
また、同じキーで複数の値を送付したい場合には、値を,(カンマ)で区切ります。
&cp_t_category=it,enterprise