条件のコンテキストパラメータ
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
次のセクションでは、条件の作成時に含めることができるコンテキストパラメータのタイプについて詳しく説明します。
条件にコンテキストパラメータを追加する前に、パラメータのタイプ と条件の パラメータのタイプ 、およびサポートされていないJavaScript関数について理解しておくことをお勧めします。
ゲスト パラメータ
guestオブジェクトには、サイト訪問者に関するパラメーターが含まれています。カスタム条件でJavaScriptを使用すると、guestオブジェクトからの値が存在するかどうかを確認できます。たとえば、サイト訪問者のゲストタイプ(サイト訪問者に対してSitecore CDPが決定したIDのレベル)を確認できます。
また、技術者以外のユーザーがオーディエンスのエクスポートで条件を適用するときに値を割り当てることができる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 CDPがパラメータを返すようにするには、JavaScriptエディタに次の関数を含めます。
条件でパラメータを使用するには、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 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: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" |