カスタマープリフィックス

概要

Piano Insightでは「カスタマープリフィックス」と呼んでいる３文字の接頭辞をサイトグループレベルに設定しています。こちらは導入時に設定を行います。

お客様のカスタマープリフィックスが不明な場合や新規に作成したい場合についてはサポートにお問い合わせください。

記法

英数字３文字の文字列です。例） "xyz", "cxn", "cx2"

使用方法

Piano Insight が提供するサービスにおいて、このプリフィックスによってお客様のデータの見え方が制御されています。

これにより、一つのユーザプロファイルにより複数のお客様固有の計測値をサポートすることができます。また、そのカスタマープリフィックスを持つサイトグループへのアクセス許可を持っているユーザは、そのプロファイルデータへアクセスすることができるように制御されます。

クロスリファレンス

カスタマープリフィックスはそのまま（３文字のみ）で使用される場合もあれば、プリフィックスとしてキー名に付与して使用されることもあります。このWikiサイトにおいてカスタマープリフィックスの使用した例示をする場合は、大抵"xyz"が使われています。

Use Case	Description	Examples
カスタムパラメータ	プリフィックスとして使用	`cX.callQueue.push(['setCustomParameters', { 'xyz-registered': 'true', 'xyz-subscriber': 'yes'` `}]);`
Document parsing	プリフィックスとして使用	`<meta name="cXenseParse:xyz-fruit" content="banana"/>`
User Interests and User Intents	ExcelワークブックまたはJSONオブジェクトの辞書の設定において'`group-prefix`'のキー値として使用ユーザプロファイルのグループ'`xyz-categories`'や'`xyz-intent`'のプリフィックスとして使用
Audience Estimation	プリフィックスとして使用	`<meta` `name="cXenseParse:xyz-audience"` `content="age/25-40"/>`
Traffic filters	"`group`"の値のプリフィックスとして使用または`"type":"user"`の場合の"`group`"のキー値として使用	`{"type":"custom", "group":"xyz-subscriber", "item":["yes", "no"]}` `{"type":"keyword", "group":"xyz-fruits", "item":"banana"]}` `{"type":"user-keyword", "group":"xyz-categories", "items":["news/business/bank", "news/business/investments"]}` `{"type":"intent", "group":"xyz-intent", "items":["travel", "shopping"]}` `{"type":"user", "group":"xyz", "item":"subscriber14"}`
Content recommendations `/public/widget/data`	リクエスト時に"user":{"ids":{"xyz":"subscriber14"}}の形式で使用	通常のPiano Insightのユニーク cookie id: `"user": {` `"ids": { "usi": "12343123411343595" }` `},` プリフィックス"`xyz`"とリンクしている外部IDで指定できます。 `"user": {` `"ids": { "xyz": "subscriber14" }` `},`
External User Identifiers `/profile/user/external/*` API family	'`type`'というキー名で使用 1stパーティーデータプロファイルオブジェクトの'`group`'値で使用	クライアントサイドの場合 `cX.callQueue.push(['addExternalId', { 'id': 'subscriber14', 'type': 'xyz'}]);)` サーバーサイドの場合（認証されたAPIリクエスト） `cx.py /profile/user/external/link/update '{"id":"subscriber14", "type":"xyz", "cxid":"12343123411343595"}'` `cx.py /profile/user/external/update '{"id":"subscriber14","type":"xyz","profile":[{"group":"xyz-gender","item":"male"},{"group":"xyz-interests","item":"cooking"},{"group":"xyz-interests","item":"motorcyckling"}]}'`

Last updated: January 18, 2022