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

日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

重要

機能の利用可能性は段階的に展開される一環です。あなたの組織はまだこの機能に気づいていないかもしれません。環境が導入された際に利用可能になります。

以下のセクションでは、条件作成時に含めることができるコンテキストパラメータの種類を詳しく説明します。

条件にコンテキストパラメータを追加する前に、条件のパラメータや要素の種類、そしてサポートされていないJavaScript関数に慣れておくことをお勧めします。

ゲストパラメータ

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	Date	ウェブ、インタラクティブ、トリガー	このゲストの生年月日。	2001-02-15T00:00
guest.passportExpiry	Date	ウェブ、インタラクティブ、トリガー	ゲストのパスポートの有効期限です。	2023-08-01'T'00:00:00.000'Z
guest.type	ストリング	ウェブ、インタラクティブ、トリガー	ゲストが獲得するアイデンティティのレベル。	"customer"
guest.firstSeen	Date	ウェブ、インタラクティブ、トリガー	ゲストが初めてあなたのブランドと交流した時のことです。	"2015-01-01T16:17:16.000Z"
guest.lastSeen	Date	ウェブ、インタラクティブ、トリガー	ゲストが最後にあなたのブランドと交流した時のことです。	"2023-04-06T16:17:16.000Z"

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かどうかを確認できます。

警告

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"

この記事を改善するための提案がある場合は、お知らせください!