---
title: "カスタム条件を作成する"
slug: "create-a-custom-condition"
abstract: "リアルタイムの行動に基づいたカスタム条件をPersonalize作成し、ターゲットを絞ったマーケティング活動を強化します。"
---
# カスタム条件を作成する

> !重要カスタム条件はSitecoreAIと[Sitecore Personalize](https://doc.sitecore.com/personalize/en/users/sitecore-personalize/create-a-custom-condition.html)の両方で作成可能です。Sitecore Personalizeでカスタム条件を作成するには、組織が独立したSitecore Personalizeライセンスを持っている必要があります。

SitecoreAIには、オーディエンスを構築するための標準条件セットが[](https://doc.sitecore.com/sai/ja/users/sitecoreai/personalize/specifying-variables-for-conditions.html "Specifying variables for conditions")付属しています。しかし、パーソナライズロジックが標準条件でカバーされておらず、JavaScriptに慣れている場合は、手動でカスタム条件を作成できます。カスタム条件は、特定のニーズに合わせた洗練された再利用可能なパーソナライズロジックを可能にしつつ、独自のビジネスニーズにも柔軟に対応します。AI Code Assistantや包括的なテストツールと組み合わせることで、複雑な条件でも管理可能で保守可能です。

カスタム条件は、訪問者プロファイルを評価するサーバーサイドのJavaScript式です:·

-   トゥルーシーなリターン値があれば、訪問者にコンテンツが表示されます。
-   偽の数値はコンテンツの表示を妨げます。

*User*、*Developer*、または*Admin*アプリの役割を持つユーザーは、カスタム条件を作成SitecoreAIできます。既存の条件をすぐに変更したりカスタムしたり、まったく一から新たに作成したりできます。これらの条件は手動で作成するか、AI[コードアシスタント](https://doc.sitecore.com/sai/ja/users/sitecoreai/personalize/create-a-custom-condition/create-a-condition-with-the-code-assistant.html "Create a condition with the Code Assistant")の助けを借りて作成できます。

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

-   [パラメータの種類](https://doc.sitecore.com/sai/ja/users/sitecoreai/personalize/create-a-custom-condition/types-of-parameters-for-conditions.html "Types of parameters for conditions")、 [コンテキストパラメータ](https://doc.sitecore.com/personalize/en/users/sitecore-personalize/en/context-parameters-for-conditions.html) 、条件で使われる [要素](https://doc.sitecore.com/sai/ja/users/sitecoreai/personalize/create-a-custom-condition/condition-elements.html "Condition elements") 。
-   [サポート済みおよびサポートされないJavaScript関数](https://doc.sitecore.com/personalize/en/users/sitecore-personalize/en/supported-and-unsupported-javascript-entities.html)
-   [カスタム条件を作るためのベストプラクティス](https://doc.sitecore.com/personalize/en/users/sitecore-personalize/en/best-practices-for-creating-custom-conditions.html)。

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

1.  ページビルダーの**Personalize**モードで、左側のパネルで「 **Create variant**」をクリックします。
    
2.  ページバリアントの名前を入力し、**次にクリック**します。
    
3.  「 **オーディエンスを作成** 」ダイアログ **の条件右側** パネルで **「作成**」をクリックします。
    
4.  新しい状態の名前を入力してください。
    
5.  コードエディターでJavaScriptを編集してください。
    
    レスポンス本文にオブジェクトを返すことを推奨しました。他のカスタム条件からコードをコピーすると、始めるのに便利です。
    
    > !tipレスポンスで返される値は、バリアントAPIレスポンスから「filter」としてアクセスできます。
    
6.  JavaScriptのコーディングペインで入力パラメータを定義すると、右側パネルの**Output**タブにパラメータ名が表示されます。
    
7.  変更を適用するには **「保存** 」をクリックしてください。カスタム条件を保存した後は、適切なパラメータ名を使って [条件出力を定義](https://doc.sitecore.com/sai/ja/users/sitecoreai/personalize/create-a-custom-condition.html#define-the-condition-output "Define the condition output") してください。
    

## 条件出力を定義します

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

![Selecting a condition](https://doc.sitecore.com/api/markdown-image/sai/ja/users/sitecoreai/images/selectCondition.png)

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

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

条件出力を定義すると:

1.  右側のパネルで「 **出力** 」タブを選択します。
    
2.  テキストとパラメータを **「構成** 」テキストボックスに入力してください。これは、ユーザーが実験や体験に条件を適用した際に見るものです。入力すると、出力が **プレビュー** セクションに表示されます。有効なパラメータは太字で表示されています。ユーザーが選択可能な入力パラメータの値を見るには、「 **入力** 」オプションをクリックしてください。
    
    パラメータは大文字に細かく区別され、例えばpath.name。
    
    > !注JavaScriptコーディングエディタで定義されているすべての条件パラメータを、コンセクトテキストボックスに含めなければなりません。JavaScriptで定義されているがコンセッテッドテキストボックスに含まれていないパラメータには赤い感嘆符が付いています。パラメータ名をコピーしてコンセクトテキストボックスに貼り付けるには、:mdiFileDocumentMultipleOutline: をクリックしてください。
    > 
    > 構成テキストボックスに含まれて有効なパラメータには緑色のチェックマークが付いています。
    
    この画像は、**\[ has**input parameter(入力パラメータ)がJavaScriptで定義され、**構成**テキストボックスに含まれていることを示しています。緑色のチェックマークが表示され、入力パラメータが正常に含まれていることを示します。**パラメータとページ**パラメータの比較は赤い感嘆符で表示されています。これは**、構成**テキストボックスに含まれるものの、二括弧で囲まれておらず、構文が無効だからです。構文を有効にし緑色のチェックマークを表示するには、パラメータを二重四角括弧で巻きます。
    
    ![Configuring a condition](https://doc.sitecore.com/api/markdown-image/sai/ja/users/sitecoreai/images/condition_firstpg.png)
    
3.  条件出力のプレビューは「 **出力** 」タブに表示されます。これは、実験や体験に適用した際にユーザーが条件をどのように見るかを見るのに役立ちます。 **入力オプションをクリックすると** 、ユーザーが条件のために選択できるパラメータ値が表示されます。
    
4.  ゲストデータを使って[条件をテスト](https://doc.sitecore.com/sai/ja/users/sitecoreai/personalize/create-a-custom-condition/test-a-condition.html "Test a condition")するには「**テスト**」をクリックしてください。エラーを特定し、最適なパフォーマンスを確保するために、[公開](https://doc.sitecore.com/personalize/en/users/sitecore-personalize/en/manage-conditions.html#UUID-04369032-3c1b-5080-c03e-3d6998089166_section-idm4582172472156833683000622423)前に条件をテストすることをお勧めします。