A design defines how recommendations appear on a page.
You can create a Recommendations design using a default design or by creating a custom design. The Recommendations > Designs screen displays both default design cards and any designs that have been created in your account.
Keep the following information in mind as you work with designs:
You can create a recommendations design by using a default design or you can create a custom design.
You cannot edit or delete a default design.
You can edit, copy, or delete a custom design.
To create a design based on a default design, you must first copy the design, and then edit the copy.
This illustration shows the default 1 x 4 design:
This illustration shows a custom design:
You can create a design during the activity-creation process from within the Visual Experience Composer (VEC) or from the design library outside of activity creation. The following sections assume you are creating designs from the library, but the steps are similar.
Create designs
You can create a design based on a default design or you can create a custom design.
Create a design based on a default design
Click Recommendations > Designs to display the Designs library.
Mouse over the card for the design you want to create, then click the Copy icon.
The Create Design dialog box displays.
In the Information panel, add a Content Name and an optional preview image to display on the design card.
When you use a default design, the design name and “Copy” appears in the Content Name field. You can edit the name. You can also select an image to display on the design card.
(Conditional) Edit the design Code, as desired.
Recommendation designs use the open-source Velocity design language. Information about Velocity can be found at and in Customize a design using Velocity.
A design can be HTML or non-HTML. By default, HTML designs are wrapped with a <div> tag to allow for click-tracking in a Web environment. Non-HTML designs are for non-Web environments where click-tracking is not possible. Slide the HTML Design toggle to the “off” position to use non-HTML code.
note note
NOTE
The maximum number of entities that can be referenced in a design, either hard-coded or via loops, is 99.
Click Save.
Create a custom design
Click Recommendations > Designs to display the Designs library.
Click Create Design.
If you want to base your new custom design on an existing design, mouse over the desired design, then click the Copy icon. You can then edit the copy to create a new custom design.
Add a Content Name and an optional preview image.
(Conditional) Edit the design Code, as desired.
Refer to the information in Step 4 above for more information.
Click Save.
Edit, copy, or delete a design
Remember that you cannot edit or copy a default design; you can only copy default designs.
Hover over the desired design in the Design library, then click the appropriate icon: edit, copy, or delete.
You can copy an existing design to create a duplicate design that you can then modify. This process lets you create a similar design with less effort.
Be aware that designs are available across the entire account. Consider usage in other accounts before deleting a design. Deleted designs cannot be recovered.
JSON Example section_75BFB2537CFF4FBD9B560F59EB32C8DD
The following example shows how JSON responses can be returned when configuring an activity via the form-based editor.
Create a design from within the Design library or within the form-based workflow. If you attempt to do create a design inside the Visual Experience Composer (VEC) workflow you cannot create anything other than an HTML design, which is wrapped in a <div> for click tracking purposes.
Ensure that the “HTML Design” option is turned off:
The following code is an example of what you could paste into your design:
code language-javascript
#*
* "Return a simple list of recommended entity ids"
*#
{
"notes":{
"purpose": "Return a simple list of recommended entity ids",
"use-case": "Use this approach if you prefer to do a real-time lookup of entity attribute details (such as inventory, price, rating) from another system (such as a CMS, PIM or ecommerce platform)",
"version": "01"
},
"recommendedItems": {
"key": "$key.id",
"slot-01": "$entity1.id",
"slot-02": "$entity2.id",
"slot-03": "$entity3.id",
"slot-04": "$entity4.id",
"slot-05": "$entity5.id",
"slot-06": "$entity6.id",
"slot-07": "$entity7.id",
"slot-08": "$entity8.id",
"slot-09": "$entity9.id",
"slot-10": "$entity10.id"
}
}
Set up a form-based Recommendations activity that uses this design.
Navigate to the Activities page.
Click Create Activity > Recommendations.
Under Choose Experience Composer, select Form, then click Next.
Under location, enter the text: “Sample_Recs_Response”
Under Default Content, click the down-arrow, then click Add Recommendation.
Choose a Page Type. This determines the initial filtering of the next screen.
Select a Criteria card, then click Next.
Select the design that you created in the previous step, then click Next.
Complete the setup process.
Click the right arrow next to Inactive, then select Activate.
After your activity is set up and activated, you can set up a sample request to get back the clean JSON response.
From the time that you save your activity, Target needs to build a model to support the selected criteria configuration. Depending on a number of factors, this process could take some time. Results appear once the model has build.
Alternatively, you can send additional information in the response. The following code file is a more complex example that returns much more than the entity ids with their associated slots (order). This design example also returns activity details, Target Profile details (as applicable), and other entity.attributes associated with the items returned.
