Administer the Recommendations Portal

  • Updated

The Recommendations Portal is the user interface for accessing Product Recommendations, Email Product Recommendations, Email Content Recommendations, Triggered Messages, and Promoted content. Features include automatic product recommendations online and through email.

You can see how a site is configured, but you must contact Optimizely Support to modify Optimizely Recommendations site attributes. Recommendations Portal is available only if you have Product Recommendations or Email Product Recommendations installed on your site.

You can do the following functions with the Admin view.

  • Site management. You can see how a site is configured but can modify site attributes only through contacting Optimizely Support. 
  • User Management. Using a user's CUID or IP address, you can view a snapshot of current user activity.

Feed configuration

You can view the status of the import of your site’s product catalog feeds. The status is either Successful or Error. If you get an error status, click Error for more details about the error.

Feeds are automatically imported daily by schedule into the Optimizely Recommendations system, but you can contact Optimizely Support to have a feed processed manually.

PP-feed.png

 

Products

The Products tab shows products that are enabled according to your agreement with Optimizely.

The Product Recommendations, Email Product Recommendations, and Email Content Recommendations tabs are not shown in this section because they show only whether the product is enabled. Triggered Messages and Personalize Find are shown in this section.

PP-general.png

Viewing trigger settings

The Manage Triggers for this site view shows trigger settings. Contact Optimizely Support if you need to change the settings.

  • In-session triggers. Select whether in-session triggers are enabled.
  • Daily triggers. Select whether daily triggers are enabled.
  • Scheduled time. Enter the time when daily triggers go into effect.
  • Hashed email address. Select whether hashed email addresses can be viewed.
  • Manage ESP. Select the email service provider.
  • Save. Save the specified settings.
  • Cancel. Dismiss changes and return to the previous settings.

PP-manage-triggers.png

Viewing Personalized Find (Search & Navigation) settings

The Manage Personalized Find for this site view shows the strategy for Personalized Search & Navigation. Contact Optimizely Support if you need to change the settings.

  • Personalized Find. Indicates whether Personalized Search & Navigation is enabled.
  • Strategy. Shows the strategy that is select for Personalized Search & Navigation. If there are more than one strategy, you can select another strategy though Optimizely Support.
  • Save. Saves the specified settings.
  • Cancel. Dismisses changes and return to the previous settings.

PP-find.png

 

Settings

The Site settings view shows the following site attributes. Contact Optimizely Support if you need to change the settings.

  • Default currency. Click to change the default currency for your site.
  • Default time zone. click to change the time zone for your site.
  • Online order updates. Shows whether online order updates are accepted. If this is Off and a customer wants to add something to their online order, the customer will have to make a separate online order; if On, the customer can make changes to their online order.
  • Offline order updates. Shows whether offline order updates are accepted. If this is Off and a customer wants to add something to their in-store order, the customer will have to make a separate in-store order; if On, the customer can make changes to their in-store order.
  • Save. Saves the specified settings.
  • Cancel. Dismisses changes and return to the previous settings.

PP-site-settings.png

Viewing your site groups

The Groups view shows groups that exist for client sites. Optimizely Support can modify the following.

  • Add. Click to add a group.
  • Edit. Click to modify an existing group.
  • Delete. Click to remove the group from the site.
  • Sort. You can sort the group attribute columns by clicking the headings.
  • Search. Enter the name of a group to find it in the list. Partial names are allowed.

PP-groups.png

Accessing site tokens

For native clients, the Site tokens view shows the values of your tokens. The Site admin token is necessary when embedding the Recommendations Portal in the Optimizely global navigation; the client tokens are what you provide in the tracking request. See clientToken in the Common Elements topic.

PP-site-tokens.png

 

Viewing session data

You can view a user’s session activity on a site using their CUID or you can view your own session activity by using your CUID or your IP address. The Session viewer lets you verify that tracking is being sent to the Recommendations servers and that recommendations are being returned, with user interactions being tracked correctly. See Tracking and Recommendations for information about how to use the Session viewer after you set it up, and what you should look for when you debug your site.

To view a user's session activity in the Recommendations Portal:

  1. Go to AdminUser Management > Session viewer.
  2. Enter the CUID into the CUID field and click Find session.

    PP-Session-viewer-cuid.png

To find your CUID:

  1. Go to your website.
  2. Press F12. DevTools menu appears.
  3. In Chrome, click Application. In Edge or Firefox, click Storage.
  4. Open the Cookies drop-down list and select the domain for your website.
  5. In the table, for native clients, find the value of epi_RecommendationsTrackingUserId cookie, or for standalone clients find the value of the peerius_user cookie, and copy the CUID number ('cuid=1234567890|xxx_xxxxxxxxxxxxxxxxxxxxxxxxxxx_xxxxxxxxxxxxxx').

You also can enter your IP address to view your activity.

PP-Session-viewer.png

If your CUID and session are active, you should see an entry under the session tab that will match your session and CUID values (as shown in the following image).

PP-Session-viewer-entry.png

If no sessions are shown, try refreshing the page on the site being tested, or go to some other page on your site and try again.

Clicking the area that contains the session information activates a list of tracking history on the right-hand side of the page for that user/session. The rows include information about the page type being tracked and the timestamp of the request, which can help to find specific requests when debugging issues. The rows are ordered from top to bottom by most recent to oldest requests. New requests are added to the top of the stack.

Clicking a row on the right-hand side opens the Console tab, containing more detail about the page. This is divided into the following sections:

  • Request. Contains information about the page such as URL and timestamp. Most importantly, this tab shows the JSON payload received by Recommendations. See Tracking request format for information about the payload contents.
  • Response. Shows the widgets returned for the current request and the generated recommendations. This is available in JSON format, or as an indexed list of recommendations and the key data associated with each, such as recommendationId, refcode, and title.
  • Track Info. Shows key tracking information after being processed by the system. For example, product page requests show more details related to the product, such as associated attributes and prices from the latest feed import.

You can view each tab as the default JSON format, or the raw format for a more condensed view. You can expand or collapse entries in the JSON view.