カスタム条件を作成する
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
JavaScriptに精通している場合は、カスタム条件を作成できます。条件を使用すると、リアルタイムの訪問者の行動に基づいてエクスペリエンスや実験をフィルタリングできます。
条件を公開した後、マーケターはそれをエクスペリエンスや実験に適用できます。エクスペリエンスまたは実験が実行されると、Sitecore Personalizeはサーバー側でJavaScriptを実行して、エクスペリエンスまたは実験を特定のゲストに表示するかどうかを検証します。応答に真値が含まれている場合、Sitecore Personalizeは実験またはエクスペリエンスをサイト訪問者に表示します。
Sitecore Cloud PortalでUser、Developer、またはAdminロールを持つチームメンバーは、カスタム条件を作成できます。
組織にXM Cloud + Personalizeライセンスがある場合、Sitecore Personalizeで作成したカスタム条件は 、XM CloudのパーソナライゼーションのためにPagesでも使用できます。
開始する前に、条件で使用されるパラメータ、コンテキストパラメータ、要素のタイプ、およびカスタム条件を作成するためのサポートされている関数とサポートされていないJavaScript関数、およびベストプラクティスについて理解しておくことをお勧めします。
カスタム条件を作成するには:
-
ナビゲーション メニューで、Developer center > Conditionsをクリックします。
-
「 Create」をクリックします。または、既存の条件を複製して編集することもできます。
-
新しい条件の名前を入力し、Createをクリックします。
-
コード エディターで、Edit
をクリックしてJavaScriptを構成します。JavaScriptコードを自動的に書式設定してインデントするには、 
をクリックします。応答本文でオブジェクトを返すことをお勧めします。別の条件から コードをコピーして 、作業を開始することができます。
先端レスポンスで返された値には、バリアントAPIレスポンスから「filter」としてアクセスできます。
-
右側のペインの「 Data 」タブをクリックして、ゲスト・データ・モデルの属性またはパスをコピーし、JavaScript・エディターに貼り付けます。
をクリックし、次のいずれかのオプションを選択します。-
ゲストのタイプに基づいてランダムなゲストの属性を表示するには、検索ボックスをクリックし、Quick Select CustomerまたはQuick Select Visitorを選択します。システムは、最近アクティブだったゲストを選択します。
-
特定のゲストのフィールドを選択するには、検索ボックスに一意の識別子を入力します。たとえば、セグメント メンバーシップを動的データとして使用する場合は、セグメントのメンバーであるゲストを検索します。ゲストは、メールアドレス、その他の一意の識別子、ブラウザIDなどを使用して検索できます。
先端コードの設定やテスト時に頻繁に使用するデータを持つゲストがいる場合は、starアイコンをクリックしてゲストをブックマークすると、そのゲストを検索する必要がなくなります。
-
-
JavaScriptコーディング ウィンドウで入力パラメーターを定義すると、パラメーター名がConfigurationタブに表示されます。条件出力は、次のセクションで説明するように、パラメータ名を使用して定義する必要があります。
条件出力の定義
条件出力は、説明的なフレーズと入力パラメーターの組み合わせです。これは、次に示すように、ユーザーがテストまたはエクスペリエンスに適用する条件を選択すると表示されます。
「今回の訪問中にcompares topageページから訪問has / has not始まりました」
この例では、has / has not、compares to、pageは、ユーザーが条件を実験またはエクスペリエンスに適用するときに値を選択する入力パラメーターです。条件出力は、文の構成と同様の方法で表現することをお勧めします。
条件出力を定義するには、次のようにします。
-
Configurationタブで、Outputオプションを選択します。
-
テキストとパラメータをConfigureテキストボックスに入力します。これは、ユーザーが条件を実験またはエクスペリエンスに適用したときに表示される内容です。入力すると、出力がPreviewセクションに表示されます。有効なパラメータは太字で示しています。ユーザーが選択できる入力パラメータ値を表示するには、Inputオプションをクリックします。
パラメーターは大文字と小文字が区別され、二重角括弧で囲む必要があります (例: path.name)。
手記Configureテキスト・ボックスには、JavaScriptコーディング・エディターで定義されているすべての条件パラメーターを含める必要があります。JavaScriptで定義されているが、Configureテキスト ボックスに含まれていないパラメーターには、赤い感嘆符が表示されます。
をクリックしてパラメータ名をコピーし、Configureテキスト ボックスに貼り付けます。Configureテキストボックスに含まれており、有効なパラメータには、緑色のチェックマークが付いています。
この画像は、has入力パラメーターがJavaScriptで定義され、Configureテキスト ボックスに含まれていることを示しています。入力パラメータが正常に含まれたことを示す緑色のチェックマークが表示されます。 compares toパラメーターとpageパラメーターには、Configureテキスト ボックスに含まれているにもかかわらず、二重角かっこで囲まれておらず、構文が無効であるため、赤い感嘆符が付いています。構文を有効にし、緑色のチェックマークを表示するには、パラメータを二重角括弧で囲みます。
-
条件出力のプレビューがConfigurationタブに表示されます。これは、ユーザーが条件を実験やエクスペリエンスに適用するときに、その条件をどのように見るかを確認するのに役立ちます。「 Input 」オプションをクリックすると、ユーザーが条件に対して選択できるパラメータ値が表示されます。
-
Testをクリックして、ゲスト データを使用して 条件をテストします 。 公開する前に条件をテストして、エラーを特定し、最適なパフォーマンスを確保することをお勧めします。