条件のコンテキストパラメータ

ゲストパラメータ

guestオブジェクトにはサイト訪問者に関するパラメータが含まれています。カスタム条件でJavaScriptを使うと、guestオブジェクトの値の有無を確認できます。例えば、サイト訪問者のゲストタイプ(サイト訪問者の識別レベルSitecore CDP確認できます。

また、非技術者がオーディエンスエクスポートに条件を適用する際に値を割り当てられるguestパラメータを含めることもできます。例えば、ゲストがどの言語を使うかを条件として選択できます。

条件でguestオブジェクトのパラメータを使用するには、JavaScriptエディタにguestパラメータへの全パスを含めてください。このテーブルのパラメータ列にフルパスが記載されています:

パラメータ

種類

概要

例

guest.language

ストリング

このゲストが使う言語は、ISO 3166-1 alpha-2形式で表される2文字で表されています。

"EN"

guest.email

ストリング

ゲストのメールアドレス。

"[email protected]"

guest.title

ストリング

ゲストの称号。

"Ms."

guest.firstName

ストリング

この客の名前。

"Dave"

guest.lastName

ストリング

このゲストの名字。

"Jones"

guest.gender

ストリング

このゲストの性別。

"unknown"

guest.city

ストリング

ゲストの市の住所。

"Dublin"

guest.country

ストリング

このゲストの国は、ISO 3166-1 alpha-2形式で表される2文字で表されています。

"IE"

guest.nationality

ストリング

ゲストの国籍。

"Irish"

guest.dateOfBirth

日付

このゲストの生年月日。

2001-02-15T00

guest.passportExpiry

日付

ゲストのパスポートの有効期限です。

2023-08-01'T'00:00

guest.type

ストリング

ゲストが獲得するアイデンティティのレベル。

"customer"

guest.firstSeen

日付

ゲストが初めてあなたのブランドと関わった時。

"2015-01-01T16:17

guest.lastSeen

日付

ゲストが最後にあなたのブランドと交流した時のことです。

"2023-04-06T16:17

UTMとリファラーパラメータ

カスタム条件でJavaScriptを使うと、例えばサイト訪問者のPOSの存在を確認することができます。

また、非技術者がオーディエンスエクスポート時に条件を適用する際に値を割り当てられるセッションパラメータを含めることもできます。例えば、ユーザーはゲストをエクスポートに含める条件として、サイト訪問者のURLに関連付けられたUTMキャンペーンを選択できます。

Sitecore CDPが条件評価時にパラメータを返すようにするために、JavaScriptエディタに以下の関数を含めてください。

(function () { return { request: request }; })();

条件でパラメータを使用するには、JavaScriptエディタにrequestパラメータへの全パスを含めてください。このテーブルのパラメータ列に完全なパスが記載されています:

パラメータ

種類

概要

例

request.pointOfSale

ストリング

セッションに関連する販売時点です。

"myretailsite/ireland"

request.params.referrer

ストリング

セッションに関連付けられたリファラー。

"facebook.com"

request.params.utm.campaign

ストリング

訪問者の現在のURLに含まれるUTMキャンペーン。

"content_promotion"

request.params.utm.source

ストリング

訪問者の現在のURLに含まれるUTMソース。

"bing"

request.params.utm.medium

ストリング

訪問者の現在のURLに含まれるUTMメディア。

"social"

request.params.utm.content

ストリング

訪問者の現在のURLに含まれるUTMコンテンツ。

"call_to_action"

テナントパラメータ

tenantオブジェクトには、組織のテナント設定から得られたパラメータが含まれており、それらは会社情報画面で設定されています。カスタム条件でJavaScriptを使うと、tenantオブジェクトの値の存在を確認することができます。例えば、テナントの通貨がEURかどうかを確認できます。

!警告 会社情報 画面で設定され、tenantオブジェクトで返されるパラメータ値は、組織がSitecore CDP APIに送るパラメータと必ずしも同一ではありません。

条件でtenantパラメータを使用するには、JavaScriptエディタにtenantパラメータまでの全パスを含めてください。このテーブルのパラメータ列にフルパスが記載されています:

パラメータ

種類

概要

例

tenant.configurations.dateFormat

ストリング

Sitecore CDP UIに表示される日付フォーマット。

"1985-12-24"

tenant.configurations.name

ストリング

借主の名前です。

"My Retail Site"

tenant.configurations.timeZone

ストリング

借主のタイムゾーンです。

"Europe/Dublin"

tenant.configurations.currency

ストリング

(大文字のISO 4217)

通貨価値がSitecore CDP UIに表示される通貨のアルファベット順通貨コード。

"EUR"

tenant.configurations.language

ストリング

テナントの主要言語セット。

"en-gb"

エンティティパラメータ

カスタム条件でJavaScriptを使うと、entityオブジェクトの価値の存在を確認できます。

条件でentityパラメータを使用するには、JavaScriptエディタにentityパラメータまでの全パスを含めてください。このテーブルのパラメータ列にフルパスが記載されています:

パラメータ

種類

概要

例

entity.ref

ストリング

イベントのUUID(世界統一図)です。

"717732d5-ab8a-4506-8e56-90e71ee9e008"

entity.createdAt

ストリング

Sitecore CDPがイベントを受け取った時間。

"2023-07-19T05:50

entity.modifiedAt

ストリング

イベントの時間が変更されたこと。

"2023-07-20T05:50

entity.type

ストリング

イベントの種類。

"GUEST_CREATED"、 "ORDER_CREATED"、 "ORDER_UPDATED"、 "SESSION_CLOSED"、 "GUEST_MODIFIED_CUSTOM"

entity.status

ストリング

イベントの状況について。

"PROCESSED"

entity.channel

ストリング

ユーザーがブランドと関わる接点です。例えば、ウェブページの場合、チャネルはWEBです。モバイルアプリの画面では、チャネルはMOBILE_APPです。

• "AIRPORT_KIOSK"
• "BRANCH"
• "CALL_CENTER"
• "EMAIL"
• "GDS"
• "KIOSK"
• "MOBILE_APP"
• "MOBILE_WEB"
• "SMS"
• "OFFLINE"
• "OTA"
• "OTHER"
• "WEB"

entity.pointOfSale

ストリング

ブランドとのやり取りが行われる販売ポイントの名前。

"myretailsite/ireland"

entity.browserRef

ストリング

独特のブラウザのリファレンス。

"56860bff-94ba-4d84-aa37-2b5a83d5411b"

entity.sessionRef

ストリング

ユニークなセッションリファレンス。

"a60e670f-52d6-5cd0-aec3-59de082e3953"

entity.arbitraryData

目的

カスタムデータのJSONオブジェクトです。

該当なし

entity.arbitraryData.language

ストリング

ユーザーセッションの言語。

"EN"

entity.arbitraryData.page

ストリング

あなたのブランドとのやり取りが行われるウェブページの名前。これはあなたが選んだカスタムの値です。

"contact-us.html"

entity.arbitraryData.currency

ストリング

ユーザーがアプリで使っている通貨のアルファベット順通貨コードです。

"EUR"