--- title: "条件のコンテキストパラメータ" slug: "context-parameters-for-conditions" abstract: "特定の実験や体験のために条件に追加できるサポートコンテキストパラメータの概要。" --- # 条件のコンテキストパラメータ 以下のセクションでは、[条件作成](https://doc.sitecore.com/personalize/ja/users/sitecore-personalize/developer-center/conditions/create-a-custom-condition/create-a-custom-condition.html "Create a custom condition")時に含めることができるコンテキストパラメータの種類を詳しく説明します。 条件にコンテキストパラメータを追加する前に、条件の [パラメータ](https://doc.sitecore.com/personalize/ja/users/sitecore-personalize/developer-center/conditions/create-a-custom-condition/types-of-parameters-for-conditions.html "Types of parameters for conditions") や [要素](https://doc.sitecore.com/personalize/ja/users/sitecore-personalize/developer-center/conditions/create-a-custom-condition/condition-elements.html "Condition elements") の種類、そして [サポートされていないJavaScript関数](https://doc.sitecore.com/personalize/ja/users/sitecore-personalize/introduction-to-decisioning-in-sitecore-personalize/managing-programmable-decisions/supported-and-unsupported-javascript-entities/unsupported-javascript-functions-and-alternatives.html "Unsupported JavaScript functions and alternatives")に慣れておくことをお勧めします。 ## ゲストパラメータ guestオブジェクトにはサイト訪問者に関するパラメータが含まれています。[カスタム条件](https://doc.sitecore.com/personalize/ja/users/sitecore-personalize/developer-center/conditions/create-a-custom-condition/create-a-custom-condition.html "Create a custom condition")でJavaScriptを使うと、guestオブジェクトの値の存在を確認することができます。例えば、サイト訪問者のゲストタイプは、Sitecore Personalizeがサイト訪問者に対して決定したアイデンティティのレベルです。 また、実験や体験に条件を追加する際に、非技術者が値を割り当てられるguestパラメータを含めることもできます。例えば、ゲストが使う言語を実験や体験を表示する条件として選択できます。 表の互換性欄には、パラメータが互換性のある実験や体験の種類が記載されています。 guestオブジェクトのパラメータは、あらゆる種類の実験や体験で使用できます。 条件でguestオブジェクトのパラメータを使用するには、JavaScriptエディタにguestパラメータへの全パスを含めてください。このテーブルのパラメータ列にフルパスが記載されています: パラメータ 種類 互換性 概要 例 guest.language ストリング ウェブ、インタラクティブ、トリガー このゲストが使う言語は、ISO 3166-1 alpha-2形式で表される2文字で表されています。 "EN" guest.email ストリング ウェブ、インタラクティブ、トリガー ゲストのメールアドレス。 "example@email.com" 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 ストリング ウェブ、インタラクティブ、トリガー ゲストが獲得するアイデンティティのレベル。 "customer" guest.firstSeen 日付 ウェブ、インタラクティブ、トリガー ゲストが初めてあなたのブランドと関わった時。 "2015-01-01T16:17:16.000Z" guest.lastSeen 日付 ウェブ、インタラクティブ、トリガー ゲストが最後にあなたのブランドと交流した時のことです。 "2023-04-06T16:17:16.000Z" ## UTMとリファラーパラメータ エクスペリエンスリクエストサービスは、サイト訪問者のリアルタイムセッションからパラメータを返します。 [カスタム条件](https://doc.sitecore.com/personalize/ja/users/sitecore-personalize/developer-center/conditions/create-a-custom-condition/create-a-custom-condition.html "Create a custom condition")で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オブジェクトには、組織のテナント設定から得られたパラメータが含まれており、[それらは会社情報](https://doc.sitecore.com/personalize/ja/users/sitecore-personalize/managing-accounts-and-system-settings-in-sitecore-personalize/manage-company-information-in-sitecore-personalize.html "Manage company information in Sitecore Personalize")画面で設定されています。[カスタム条件](https://doc.sitecore.com/personalize/ja/users/sitecore-personalize/developer-center/conditions/create-a-custom-condition/create-a-custom-condition.html "Create a custom condition")で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](https://en.wikipedia.org/wiki/ISO_4217#Active_codes)) インタラクティブ 貨幣価値がSitecore Personalize UIに表示される通貨のアルファベット順通貨コード。 "EUR" tenant.configurations.language ストリング インタラクティブ テナントの主要言語セット。 "en-gb" ## エンティティパラメータ entityオブジェクトには[、実験や体験をトリガー](https://doc.sitecore.com/personalize/ja/users/sitecore-personalize/introduction-to-experiments-in-sitecore-personalize/introduction-to-triggered-experiments-in-sitecore-personalize/create-a-trigger-for-a-triggered-experiment.html "Create a trigger for a triggered experiment")したイベントのパラメータが含まれています。[カスタム条件](https://doc.sitecore.com/personalize/ja/users/sitecore-personalize/developer-center/conditions/create-a-custom-condition/create-a-custom-condition.html "Create a custom condition")で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です。モバイルアプリの画面では、チャネルは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"