Disclaimer: This website requires Please enable JavaScript in your browser settings for the best experience.

Dev GuideAPI Reference
Dev GuideAPI ReferenceUser GuideGitHubDev CommunityOptimizely AcademySubmit a ticketLog In
Dev Guide

ODP + Content Recommendations

How to integrate Optimizely Data Platform with Optimizely Content Recommendations

Populate your Optimizely Data Platform (ODP) visitor, lead, and customer profiles with the top three topic interests generated by Optimizely Content Recommendations. Content Recommendations automatically generates topic interests based on your site’s content and visitors’ browsing behavior. This integration also lets you optionally use AI to generate additional topics of interest based on those populated by Optimizely's content recommendations engine.

Capturing these interests on ODP profiles enables analysis, segmentation, and activation that power personalized experiences for your leads and customers.

Prerequisites

You must have access to Optimizely Content Recommendations to use this integration.

Update the ODP JavaScript tag

📘

Note

If you have not already implemented the ODP JavaScript tag on your site, see Implement the ODP JavaScript tag first.

Modify the ODP JavaScript tag on your site to properly associate your web visitors to their corresponding Content Recommendations profile.

  1. Locate the ODP JavaScript tag on your site.
  2. Insert the following code at the end of the tag, after zaius.event('pageview'); and before </script>.
    var contentIntel = document.cookie.match('(^|;)\\s_iv\\s_=\\s\_([^;]+)')?.pop() || '';  
    zaius.customer({ "content_intelligence_id": contentIntel});
    

    🚧

    Important

    If you use Google Tag Manager (GTM), do not use the code snippet above. Instead, insert the following:

    var contentIntel = document.cookie.match('(^|;)\\s_iv\\s_=\\s\_([^;]+')[1] ||'';  
    zaius.customer({ "content_intelligence_id":contentIntel})
    

Enable the integration in ODP

  1. Go to the App Directory.
  2. Select the Optimizely Content Recommendations app.
  3. Click Install App.
  4. Click the Settings tab.
  5. Copy your region's URL from the list below and paste it into the Site URL field:
    • United States (US) – https://api.usea01.idio.episerver.net/1.0/
    • Canada (CA) – https://api.caea01.idio.episerver.net/1.0/
    • Europe, Middle East, and Africa (EMEA) – https://api.emea01.idio.episerver.net/1.0/
    • Asia-Pacific (APAC) – https://api.apac01.idio.episerver.net/1.0/
    • Legacy Idio Customer – https://api.idio.co/1.0/
  6. Go to Engage > Deliveries > API in Content Recommendations and copy the Delivery Key.
  7. Go to App Directory > Optimizely Content Recommendations > Settings in ODP.
  8. Paste the delivery key into the API Key field.
  9. Click Authorize.
  10. (Optional) Toggle Enable Generative AI Topic Enrichment on. When enabled, an AI Generated Topic Interests customer attribute is made available, containing up to nine additional topics of interest in a comma-separated list. These are generated by asking generative AI to provide related topics based on those populated by Optimizely's content recommendations engine.
  11. (Optional) Click Initiate Full Import. This updates the top three topics of interest for all customers in ODP based on data from Optimizely's content recommendations engine. If the generative AI toggle is on, it also updates up to nine additional topics of interest for all customers in ODP.
  12. Click Save.

📘

Note

This integration only updates customer records added to ODP after you complete the integration setup. If you want to update all customer records in ODP, use the Initiate Full Import feature.

Optimizely Content Recommendations attributes in ODP

After the integration configuration is complete, you see three new attributes on ODP customer profiles:

  • Content Recommendations First Topic
  • Content Recommendations Second Topic
  • Content Recommendations Third Topic

Optimizely Content Recommendations automatically populates these attributes hourly for every visitor. Use these attributes in reporting, segmentation, and activation with real-time segments and campaigns.