Use an analytical model in a decision

Abstract

How to use an analytical model in a decision model variant in (Sitecore Personalize).

Sitecore Personalize enables you to use external analytical models in decision model variants such as propensity models, forecast models, and outlier models. A decision model variant can pass parameters to an analytical model to retrieve information or perform a calculation.

To add an analytical model to a decision model in Sitecore Personalize:

  1. From the decision canvas, click and drag the Analytical Model component from the Palette to the decision canvas. A list of analytical model displays.

  2. Next to the analytical model you want to add, click Add. The Analytical Model component displays on the decision canvas.

  3. Click cdp_datasystems_editicon.png. A tab displays with the name of the Data System component.

  4. In the Map Request Inputs section, enter a value for each attribute in the mapping field.

    If no attributes display in the Map Request Inputs section, the user who created the connection did not include any template literal syntax in the Request Body window or Request URL field.

    Tip

    You must use double quotes (") around any string values that you enter in the attribute fields in the Map Request Inputs section. Do not use any quotes for string values that you enter in the Test Parameters section.

  5. To use an output from the Data System component as an input into another decision, click Copy next to the Output Reference attribute, and paste the copied output reference when configuring the input column in a decision table. You can also use the output reference when writing the programmable decision in JavaScript.

    Note

    When using an output reference, you must connect the data system to the reliant decision component on the decision canvas.

  6. Click Test Connection. The Test Connection screen displays.

  7. Click Test Now. If the user who set up the connection to the analytical model included template literal syntax ${} in the Request Response, the Test Parameters window displays.

  8. For each parameter, click one of the following parameter types from the drop-down list:

    • String

    • Number

    • Boolean

  9. For each parameter, enter a test value to pass to the analytical model, in the field next to the parameter type.

  10. Click Run Test. The Test Connection screen displays the results of the test in the response window with the relevant status code.

  11. Click Back to return to the Connections list screen.