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

ゲストパラメータ

guestオブジェクトにはサイト訪問者に関するパラメータが含まれています。カスタム条件でJavaScriptを使うと、guestオブジェクトの値の存在を確認することができます。例えば、サイト訪問者のゲストタイプは、Sitecore Personalizeがサイト訪問者に対して決定したアイデンティティのレベルです。

また、実験や体験に条件を追加する際に、非技術者が値を割り当てられるguestパラメータを含めることもできます。例えば、ゲストが使う言語を実験や体験を表示する条件として選択できます。

表の互換性欄には、パラメータが互換性のある実験や体験の種類が記載されています。 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を使用すると、エクスペリエンスリクエストサービスの値の有無を確認できます。例えば、サイト訪問者の販売時点を確認することができます。

また、実験や体験に条件を追加する際に、非技術ユーザーが値を割り当てられるセッションパラメータを含めることもできます。例えば、ユーザーは実験や体験を表示する条件として、サイト訪問者のURLに関連付けられたUTMキャンペーンを選択できます。

Sitecore Personalize経験リクエストサービスを呼び出し、条件評価時にパラメータを返すことを確実にするために、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 Personalize APIに送るパラメータと必ずしも同一ではありません。

表の互換性欄には、そのパラメータが互換性のある実験や体験の種類が一覧化されています。パラメータはインタラクティブな実験や体験と互換性のある条件でのみ使用可能ですtenant 。

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

パラメータ

種類

互換性

概要

例

tenant.configurations.dateFormat

ストリング

インタラクティブ

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

"1985-12-24"

tenant.configurations.name

ストリング

インタラクティブ

借主の名前です。

"My Retail Site"

tenant.configurations.timeZone

ストリング

インタラクティブ

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

"Europe/Dublin"

tenant.configurations.currency

ストリング

(大文字のISO 4217)

インタラクティブ

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

"EUR"

tenant.configurations.language

ストリング

インタラクティブ

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

"en-gb"

エンティティパラメータ

entityオブジェクトには、実験や体験をトリガーしたイベントのパラメータが含まれています。カスタム条件でJavaScriptを使うと、entityオブジェクトの値の存在を確認できます。例えば、SESSION_CLOSEDイベントが実験をトリガーしたかどうかを確認できます。

適合性欄は、そのパラメータが互換性のある実験や体験の種類を一覧にしています。トリガーされた実験や経験と互換性のある条件でのみパラメータentity使用できます。

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

パラメータ

種類

互換性

概要

例

entity.ref

ストリング

トリガー

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

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

entity.createdAt

ストリング

トリガー

Sitecore Personalizeがイベントを受け取った時のこと。

"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"