Plan and implement Recommendations
Information to help you plan and implement Adobe Target Recommendations.
Before setting up your first Recommendations activity in Adobe Target, complete the following steps:
- Implement Target on the web and mobile app surfaces that you want to use for capturing user behavior and delivering recommendations.
- Set up your Recommendations catalog of products or content that you want to recommend to your users.
- Pass behavioral information and context to Target Recommendations to allow it to deliver personalized recommendations.
- Configure global exclusions.
- Configure Recommendations settings.
- (Optional) Administer Recommendations using Admin APIs.
1. Implement Target
Target Recommendations requires you to implement the Adobe Experience Platform Web SDK or at.js 0.9.2 (or later). See the Target client-side implementation guides for more information.
2. Set up your Recommendations catalog
To deliver high-quality recommendations, Target must know about the products or content that you want to recommend. Catalogs typically include three types of information about recommended items. Suppose you are recommending movies. Include the following:
- Data that you want to display to the user receiving the recommendation. For example, you can display the name of the movie and a URL for a thumbnail image of the movie poster.
- Data that is useful for applying marketing and merchandising controls. For example, you can display the rating of the movie so that you do not recommend NC-17 movies.
- Data that is useful for determining the similarity of items to other pieces of items. For example, you can display the genre of the movie and director of the movie.
Target offers multiple integration options to populate your catalog. These options can be used in combination to update different items in the catalog or to update different item attributes on different frequencies.
Most customers should implement at least one feed. You can then choose to complement your feed with updates for frequently changed attributes or items using either the Entities API or on-the-page method.
3. Pass behavioral information and context
The behavioral information and context you should pass to Target depends on the action your visitor is taking, which is often associated with the type of page your visitor is interacting with.
Item views or product pages
On pages where a visitor is viewing a single item, such as a product detail page, you should pass the identity of the item the visitor is viewing. You should also pass the most granular category of the item that the visitor is viewing, to allow filtering recommendations to the current category.
You can also pass certain quickly changing attributes on the product page itself. For example, you can pass the price (value
) and inventory/stock level.
Pass price and inventory
<script type="text/javascript">
function targetPageParams() {
return {
"entity": {
"id": "32323",
"categoryId": "running-shoes",
"value": 119.99,
"inventory": 329
}
}
}
</script>
Category views/category pages
On a category page, you likely want to restrict your recommendations to products or content within that category. To do so, ensure you pass the identity of the currently viewed category.
Pass current category
function targetPageParams() {
return {
"entity": {
"categoryId": "running-shoes"
}
}
}
Cart adds/cart views/checkout pages
On a cart page, you can recommend items based on the contents of the visitor’s current cart. To do so, pass the IDs of all items in the visitor’s current cart using the special parameter cartIds
.
Pass items currently in cart
function targetPageParams() {
return {
"cartIds": "352,223,23432,432,553"
}
}
For more information about Cart-Based recommendations, see Cart-Based in the Adobe Target Business Practitioner Guide.
Exclude items already in the visitor’s cart
On pages throughout your site, you can exclude some items from recommendations. For example, you might not want to recommend items that are already in the visitor’s current cart. To do so, pass the IDs of all items you want to exclude using the special parameter excludedIds
.
Pass items to exclude
function targetPageParams() {
return {
"excludedIds": "352,223,23432,432,553"
}
}
Purchases/order confirmation pages
When a purchase event occurs, pass the identity of the purchased item or items. See Track Conversions in the the How to Deploy at.js > Implement Target without a tag manager article.
4. Configure global exclusions
Exclude any items on a global level that you never want recommended to a visitor. See Exclusions in the Adobe Target Business Practitioner Guide.
5. Configure Recommendations settings
Use settings to manage your Recommendations implementation.
To access the Recommendations Settings options, open Target in the Adobe Experience Cloud, then click Recommendations > Settings.
The following options are available:
(Optional) Specify the custom global mbox used to serve Target activities. By default, the global mbox used by Target is used for Recommendations.
Note: This option is set on the Target Administration page. Open Target, then click Administration > Visual Experience Composer.
Enable this option to show only those criteria where the selected page passes the required data. Not every criteria runs correctly on every page. The page or mbox must pass in entity.id
or entity.categoryId
for the current item/current category recommendations to be compatible. In general, it is best to show only compatible criteria. However, if you want incompatible criteria to be available for the activity, uncheck this option.
It is recommended that you disable this option if using a tag management solution.
For more information about this option, see Recommendations FAQ in the Adobe Target Business Practitioner Guide.
Select your default host group.
The host group can be used to separate the available items in your catalog for different uses. For example, you can use host groups for Development and Production environments, different brands, or different geographies. By default, preview results in Catalog Search, Collections, and Exclusions are based on the default host group. (You can also select a different host group to preview results, by using the Environment filter.) By default, newly added items are available in all host groups unless an environment ID is specified when creating or updating the item. Delivered recommendations depend on the host group specified in the request.
If you don’t see your products, make sure that you are using the correct host group. For example, if you set up your recommendation to use a staging environment and you set your host group to Staging, you might need to re-create your collections in the staging environment for the products to show. To see which products are available in each environment, use Catalog Search with each environment. You can also preview the contents of Recommendations collections and exclusions for a selected environment (host group).
Note: After changing the selected environment, you must click Search to update the returned results.
The Environment filter is available from the following places in the Target UI:
- Catalog Search (Recommendations > Catalog Search)
- Create Collection dialog box (Recommendations > Collections > Create New)
- Update Collection dialog box (Recommendations > Collections > Edit)
- Create Exclusion dialog box (Recommendations > Exclusions > Create New)
- Update Exclusion dialog box (Recommendations > Exclusions > Edit)
For more information, see Hosts in the Adobe Target Business Practitioner Guide.
Setting a base URL for your product catalog makes it possible to use relative URLs when specifying thumbnails of your products when passing in your thumbnail URL.
For example:
"entity.thumbnailURL=/Images/Homepage/product1.jpg"
sets a URL relative to the thumbnail base URL.
6. (Optional) Administer Recommendations using Admin APIs
See the Use Recommendations APIs hands-on guide to learn how to configure and use the Target admin and delivery APIs for Recommendations.