Troubleshoot Optimizely Content Recommendations
This guide helps you diagnose common issues with missing content, interactions, or recommendations in your dashboard.
1. I do not see any content in the dashboard
If your dashboard is empty or is not displaying any content, there are two common causes:
A. The tracking script ip.js is not installed
The ip.js script must be included on every page you want to track or display widgets on. Without this script, Optimizely cannot track content or render recommendations.
- Check that the script is present and loading correctly by opening the browser console and looking for network requests to ip.js.
B. Our scraper cannot fetch your content
You might still see missing content after installing ip.js, if the Content Recommendations scraper cannot access your site's data.
- Verify that your domain is allowlisted so our system can crawl it.
- Check for any robots.txt rules, firewall settings, or password protection that might block scraping.
- Contact [email protected] to discuss access options if your content is gated behind a login or a paywall..
2. I cannot see any interaction activity in the dashboard
Interaction data, like clicks, views, and more, depends on tracked content. If no content is displayed in the dashboard, interactions are also not displayed.
- Start by resolving any content tracking issues in step 1.
3. My recommendations are not working
If recommendations are not displaying on your site or in the dashboard, the issue is usually related to tracking or missing content.
- Ensure the ip.js script is installed so widgets can load and render properly.
- Confirm that there is tracked content available for recommendations to be generated.
- Verify that the page where you expect recommendations has the proper widget embed code.
Verify your configuration checklist
Use the following checklist to verify your configuration:
- ip.js is installed on every page to track content and display widgets.
- Your domain is allowlisted so the Content Recommendations scraper can access content.
- Content is displayed in the dashboard before checking for interactions.
- Recommendation widgets are configured correctly on your site.
Still having issues?
If you checked all of the above and are still experiencing problems, contact [email protected] with the following items:
- A screenshot of your dashboard
- The URL of a page where ip.js is installed
- Browser console logs showing network requests
This will help us diagnose the issue effectively.