条件のコンテキストパラメータ
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
次のセクションでは、条件の作成時に含めることができるコンテキストパラメータのタイプについて詳しく説明します。
条件にコンテキストパラメータを追加する前に、条件のパラメータと要素のタイプ、およびサポートされていないJavaScript関数について理解しておくことをお勧めします。
ゲスト パラメータ
guestオブジェクトには、サイト訪問者に関するパラメーターが含まれています。カスタム条件でJavaScriptを使用すると、guestオブジェクトからの値が存在するかどうかを確認できます。たとえば、サイト訪問者のゲストタイプ(サイト訪問者に対してSitecore Personalizeが決定したIDのレベル)を確認できます。
また、技術者以外のユーザーが実験やエクスペリエンスに条件を追加するときに値を割り当てることができるguestパラメーターを含めることもできます。たとえば、ユーザーは、テストやエクスペリエンスを表示するための条件として、ゲストが使用する言語を選択できます。
表の 互換性 列には、パラメーターに互換性がある実験とエクスペリエンスの種類が一覧表示されます。 guestオブジェクトのパラメーターは、すべてのタイプの実験やエクスペリエンスで使用できます。
guestオブジェクトのパラメータを条件で使用するには、JavaScriptエディタにguestパラメータへのフルパスを含めます。フルパスは、このテーブルの パラメーター 列に示されています。
|
パラメーター |
種類 |
互換性 |
形容 |
例 |
|---|---|---|---|---|
|
guest.language |
糸 |
ウェブ、インタラクティブ、トリガー |
このゲストが使用する言語は、ISO 3166-1 alpha-2形式の2文字で表されます。 |
"EN" |
|
guest.email |
糸 |
ウェブ、インタラクティブ、トリガー |
ゲストのメールアドレス。 | |
|
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:00 |
|
guest.passportExpiry |
日付 |
ウェブ、インタラクティブ、トリガー |
ゲストのパスポートの有効期限。 |
2023-08-01'T'00:00:00.000'Z |
|
guest.type |
糸 |
ウェブ、インタラクティブ、トリガー |
ゲストが取得したIDのレベル。 |
"customer" |
|
guest.firstSeen |
日付 |
ウェブ、インタラクティブ、トリガー |
ゲストが初めてブランドと交流したとき。 |
"2015-01-01T16:17:16.000Z" |
|
guest.lastSeen |
日付 |
ウェブ、インタラクティブ、トリガー |
ゲストが最後にブランドとやり取りした時間。 |
"2023-04-06T16:17:16.000Z" |
UTMとリファラーのパラメータ
エクスペリエンスリクエストサービスは、サイト訪問者のリアルタイムセッションからパラメーターを返します。 カスタム条件でJavaScriptを使用すると、エクスペリエンス要求サービスからの値の存在を確認できます。たとえば、サイト訪問者のPOSを確認できます。
また、技術者以外のユーザーが実験やエクスペリエンスに条件を追加するときに値を割り当てることができるセッション パラメーターを含めることもできます。たとえば、ユーザーは、テストやエクスペリエンスを表示するための条件として、サイト訪問者のURLに関連付けるUTMキャンペーンを選択できます。
Sitecore Personalizeがエクスペリエンス要求サービスを呼び出し、条件の評価時にパラメーターを返すようにするには、JavaScriptエディターに次の関数を含めます。
表の 互換性 列には、パラメーターに互換性がある実験とエクスペリエンスの種類が一覧表示されます。パラメータは、同じタイプの実験やエクスペリエンスと互換性のある条件でのみ使用できます。
エクスペリエンス要求サービスのパラメーターを条件で使用するには、JavaScriptエディターにrequestパラメーターへのフルパスを含めます。フルパスは、このテーブルの パラメーター 列に示されています。
|
パラメーター |
種類 |
互換性 |
形容 |
例 |
|---|---|---|---|---|
|
request.pointOfSale |
糸 |
Webおよびインタラクティブ |
セッションに関連付けられた販売時点情報管理。 |
"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かどうかを確認できます。
Company Information画面で設定され、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:19.267Z" |
|
entity.modifiedAt |
糸 |
トリガー |
イベントが変更された時刻。 |
"2023-07-20T05:50:19.267Z" |
|
entity.type |
糸 |
トリガー |
テストまたはエクスペリエンスをトリガーしたイベントの種類。 |
"GUEST_CREATED", "ORDER_CREATED", "ORDER_UPDATED", "SESSION_CLOSED", "GUEST_MODIFIED_CUSTOM" |
|
entity.status |
糸 |
トリガー |
イベントのステータス。 |
"PROCESSED" |
|
entity.channel |
糸 |
トリガー |
ユーザーがブランドとやり取りするタッチポイント。たとえば、Webページの場合、チャネルはWEBです。モバイルアプリの画面の場合、チャネルはMOBILE_APPです。 |
|
|
entity.pointOfSale |
糸 |
トリガー |
ブランドとのインタラクションが行われるPOSの名前。 |
"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" |