Information to help you plan and implement Adobe Target Recommendations.
In addition to this article, the Adobe Target Business Practitioner Guide contains in-depth information about Target Recommendations.
Before setting up your first Recommendations activity in Adobe Target, complete the following steps:
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.
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:
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.
Method | What it is | When to use it | Additional information |
---|---|---|---|
Catalog feed | Schedule a feed (CSV, Google Product XML, or Analytics Product Classifications) to be uploaded and ingested on a daily basis. | For sending information about multiple items at a time. For sending information that changes infrequently. | See Feeds. |
Entities API | Call an API to send to-the-minute updates for a single item. | For sending updates as they happen about one item at a time. For sending information that changes frequently (for example price, inventory/stock level). | See the Entities API developer documentation. |
Pass updates on the page | Send to-the-minute updates for a single item using JavaScript on the page or using the Delivery API. | For sending updates as they happen about one item at a time. For sending information that changes frequently (for example price, inventory/stock level). | See Item views/product pages below. |
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.
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.
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.
<script type="text/javascript">
function targetPageParams() {
return {
"entity": {
"id": "32323",
"categoryId": "running-shoes",
"value": 119.99,
"inventory": 329
}
}
}
</script>
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.
function targetPageParams() {
return {
"entity": {
"categoryId": "running-shoes"
}
}
}
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
.
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.
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
.
function targetPageParams() {
return {
"excludedIds": "352,223,23432,432,553"
}
}
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.
Exclude any items on a global level that you never want recommended to a visitor. See Exclusions in the Adobe Target Business Practitioner Guide.
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:
Setting | Description |
---|---|
Custom Global Mbox | (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. |
Industry Vertical | The industry vertical is used to help categorize your recommendations criteria. This information helps members of your team find criteria that make sense for a particular page, such as criteria that are best for the shopping cart page or for a media page. |
Filter Incompatible Criteria | 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. |
Default Host Group | 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:
|
Thumbnail Base URL | 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:
sets a URL relative to the thumbnail base URL. |
Recommendations API Token | Use this token in Recommendations API calls, such as the Download API. |
See the Use Recommendations APIs hands-on guide to learn how to configure and use the Target admin and delivery APIs for Recommendations.