カスタム条件を作成する

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

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

条件は、リアルタイムの訪問者の行動に基づいて体験や実験をフィルタリングすることを可能にします。

JavaScriptに慣れているなら、自分でロジックを書いて手動でカスタム条件を作ることができます。既存の条件をすぐに変更したりカスタムしたり、まったく一から新しく作ったりできます。

Sitecore Cloud PortalでUser、Developer、またはAdminアプリの役割を持つユーザーはカスタム条件を作成できます。これらの条件は手動で作成するか、コードアシスタントの助けを借りて作成できます。

!注もし組織がSitecoreAIライセンスを持っている場合は、Sitecore PersonalizeとSitecoreAIページビルダーの両方でカスタム条件を作成できます。Sitecore Personalizeで作成されたカスタム条件は、SitecoreAIの条件変数を指定することでも利用可能です。

始める前に、以下のトピックに精通することをお勧めします。

手動でカスタム条件を作成するには:

ナビゲーションメニューで「 Developer center 」> 「Conditions」をクリックします。
「作成」をクリックします。あるいは、既存の条件を複製して編集することもできます。
新しい状態の名前を入力し、「作成」をクリックします。
コードエディターで**「編集**」をクリックしてJavaScriptを設定します。JavaScriptコードを自動的にフォーマット・インデントするには、「JS フォーマット」をクリックしてください。

レスポンス本体にオブジェクトを返すことを推奨しました。他の条件からコードをコピーして始めることもできます。

!tipレスポンスで返される値は、バリアントAPIレスポンスから「filter」としてアクセスできます。
右ペインの 「Data 」タブをクリックしてゲストデータモデルの属性やパスをコピーし、JavaScriptエディターに貼り付けてください。をクリックして、以下のいずれかを選択します:
- ゲストタイプに基づくランダムなゲストの属性を見るには、検索ボックスをクリックし、「 クイックセレクトカスタマー」または「クイックセレクトビジター」を選択します。システムは最近アクティブだったゲストを選択します。
- 特定のゲストからフィールドを選択するには、検索ボックスにそのゲストの固有の識別子を入力します。例えば、セグメントメンバーシップを動的データとして使いたい場合は、そのセグメントのメンバーであるゲストを検索してください。例えば、メールアドレス、他のユニークな識別子、ブラウザIDを使ってゲストを検索できます。
  
  !ヒントコードの設定やテスト時によく使うゲストがいる場合は、スター アイコンをクリックしてゲストをブックマークし、検索しなくて済むようにしましょう。
JavaScriptのコーディングペインで入力パラメータを定義すると、パラメータ名は設定タブに表示されます。
変更を適用するには 「保存 」をクリックしてください。カスタム条件を保存した後は、適切なパラメータ名を使って条件出力を定義してください。

条件出力を定義します

条件の出力は、記述的なフレーズと入力パラメータの組み合わせです。これは、ユーザーが実験や体験に適用する条件を選択するときに目にするものであり、以下に示されています。

「訪問は現在の訪問中のページ**と比較されるページから開始されていません」

この例では、has/hast、compares、pageは、ユーザーが実験や体験に条件を適用する際に選択する入力パラメータです。条件の出力は、文の構成に似た表現で表現することをお勧めします。

条件出力を定義すると:

設定タブで「出力」オプションを選択してください。
テキストとパラメータを 「構成 」テキストボックスに入力してください。これは、ユーザーが実験や体験に条件を適用した際に見るものです。入力すると、出力が プレビュー セクションに表示されます。有効なパラメータは太字で表示されています。ユーザーが選択可能な入力パラメータの値を見るには、「入力」オプションをクリックしてください。

パラメータは大文字に細かく区別され、例えばpath.name。

!注JavaScriptコーディングエディタで定義されているすべての条件パラメータは、構成テキストボックスに含めなければなりません。JavaScriptで定義されているが構成テキストボックスに含まれていないパラメータには赤い感嘆符が付いています。パラメータ名をコピーして構成テキストボックスに貼り付けるにはをクリックします。

構成テキストボックスに含まれて有効なパラメータには緑色のチェックマークが付いています。

この画像は、[ hasinput parameter(入力パラメータ)がJavaScriptで定義され、構成テキストボックスに含まれていることを示しています。緑色のチェックマークが表示され、入力パラメータが正常に含まれていることを示します。パラメータとページパラメータの比較は赤い感嘆符で表示されています。これは**、構成**テキストボックスに含まれるものの、二括弧で囲まれておらず、構文が無効だからです。構文を有効にし緑色のチェックマークを表示するには、パラメータを二重四角括弧で巻きます。
条件出力のプレビューは設定タブに表示されます。これは、実験や体験に条件を適用した際にユーザーが条件をどのように見るかを見るのに役立ちます。 入力オプションをクリックすると 、ユーザーが条件のために選択できるパラメータ値が表示されます。
ゲストデータを使って条件をテストするには「テスト」をクリックしてください。エラーを特定し、最適なパフォーマンスを確保するために、公開前に条件をテストすることをお勧めします。

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