Marketing Cloud Personalization Trends

Marketing Cloud Personalization Trends (IS Trends) uses the power of social validation to increase conversions. Most consumers are overwhelmed by the product choices available to them and can find it challenging to confidently buy products online. Use the “wisdom of the crowd” to influence visitors on your site in real time and build confidence in products viewed by using view and purchase counters. These view and purchase counters drive both validation and urgency ultimately influencing conversions on your site.

By enabling this feature, you’re allowing Personalization to return catalog object purchase and view data via a public API.

Given one or more catalog object IDs and a number of lookback minutes, the IS Trends API is designed to return the number of views and recent purchases for those catalog object IDs within that lookback period.

Requests to the IS Trends API can be made to URL endpoints that adhere to the following basic structure.

For your API requests to work correctly, your request URLs must include your Personalization account name and instance identifier.

The following table lists the required and optional request URL parameters included in the preceding example.

URL Parameter	Required?	Description
`accountName`	Yes	Your Personalization account name. You can retrieve it by accessing Gears from the Personalization UI and reviewing the URL. For example, if your Gears URL is `demo.us-1.evergage.com`, then your account name is `demo`.
`instance`	Yes	Your Personalization instance identifier. You can retrieve it by accessing Gears from the Personalization UI and reviewing the URL. For example, if your Gears URL is `demo.us-1.evergage.com`, then your instance identifier is `us-1`.
`dataset`	Yes	The name or identifier of the Personalization dataset you’re sending data to.
`itemIds: string`	Yes	Provide either a singular item ID or a comma-separated list of item IDs.
`lookbackMins: integer`	No	An integer representing the number of minutes to be used for a lookback period. This value can’t exceed 2880 minutes (2 days).

Given parameters:

Single ID: https://example.us-1.evergage.com/api/dataset/engage/social/smartTrends/Product?itemIds=4100323&lookbackMins=120
Multiple IDs: https://example.us-1.evergage.com/api/dataset/engage/social/smartTrends/Product?itemIds=1010263,1050855,1031064,1050946&lookbackMins=120

Returns an object with keys representing the itemID(s). The value for these keys each have an object containing stats for visitViews and purchases within the lookback period provided in the request.

The stat values in the response reflect the stats that 's been tracked against only the specific catalog objects within the lookback period, meaning that the stat values don’t account for views and/or purchases of the catalog object through a relationship to another catalog object. For instance, if a purchase is tracked for Product X and Category Y is related to it, a request to the IS Trends API with the itemId for Category Y results in a response with 0 purchases.

With the preceding note in mind, it is expected that the value for purchases is only greater than 0 when sending itemIds for the Product catalog object.

Single ID: {"4100323":{"visitViews":1,"purchases":0}}
Multiple IDs: {"1050946":{"visitViews":0,"purchases":0},"1010263":{"visitViews":0,"purchases":0},"1050855":{"visitViews":0,"purchases":0},"1031064":{"visitViews":0,"purchases":0}}

Use one of the following links to download a ZIP file containing the sample IS Trends template for your SDK namespace.

While the default configuration of the example template is for Products, you can use it with other catalog types by making the following changes.

Change the value of settings.id to reference the desired Catalog Object type.
Change the URL string returned by settings.url to reference the desired Catalog Object type.

For example, if you’re customizing this template for Articles, you would make the following changes to the properties in settings.

The sample IS Trends template consists of the following:

Handlebars code
CSS
Server-side TypeScript code
Client-side JavaScript code for the SalesforceInteractions and the Evergage SDK namespaces