Validating Your Script-based Implementation

After you complete the implementation process, it's important to validate that your script, page context, events, and data feed are properly set up. This article guides you through the process of these validations for a standard web implementation.

There are 2 ways to validate implementation:

Implementation status

In the Dynamic Yield console, go to your site. The first panel on your site page is the Implementation Status. This area provides a status overview of your script, page context, events, and product feed. You can also download a log for additional implementation status details. The log covers the past 12 hours for the periodic feed and the past 7 days for the API. Page context, events, and product feed status are only available for e-commerce sites.

The following table provides details about each available status.

Periodic sync: The feed synced, but some rows did not sync due to errors, such as missing data. See the log for more details.

Sync by API: There are 0.5%-2% warnings in the sync requests. Some actions did not sync due to errors, such as missing data. View the API logs for more details.
Item Status Description / Threshold
Script Not Implemented No script detected 
  Implemented  The script is detected. This does not verify that the script is in the header.
Page Context Not detected No page context information sent in the past 12 hours.
Requires at least 100 pageviews for each page type.
  Validated There may be errors in up to:
2% of your product pages,
2% of your cart pages, or
5% of your category pages
  Accepted with Warnings There are errors in:
2-7% of your product pages,
2-7% of your cart pages, or
5-10% of your category pages
  1 error
(The number of errors is the number of page context types that have passed the error threshold)
There are errors in more than:
7% of your product pages,
7% of your cart pages, or
10% of your category pages
Events Not received No events received in the past 12 hours 
  Validated There may be errors in up to:
2% of your add to cart, sync cart, remove from cart, or purchase events,
20% of your login, subscribe, or signup events, or
50% of your filter, sort, change attribute, keyword, or video watch events
  Accepted with Warnings There are errors in 2-7% of your add to cart, sync cart, remove from cart, or purchase events
  1 error 
(The number of errors is the number of event types that have passed the error threshold)
There are errors in more than:
7% of your add to cart, sync cart, remove from cart, or purchase events,
20% of your login, subscribe, or signup events, or
50% of your filter, sort, change attribute, keyword, or video watch events
Product Feed Not synced You have not yet attempted to sync a data feed.
  Synced Periodic sync: You have successfully synced a data feed. 

Sync by API: There are up to 0.5% warnings in the sync requests.
  Synced with Warnings 
  Failed to sync Periodic sync: The data feed did not sync due to an error. See the log for more details.

Sync by API: There are more than 2% warnings, or more than 0.5% errors in the sync requests. Some actions did not sync due to errors, such as missing data. View the API logs for more details.

Note: The status of events and page context are updated every ten minutes.

If you find the described thresholds to be too sensitive or not sensitive enough for your site, contact our Support team to configure adjustments.

🚧

After you resolve an issue, it might take some additional time until the error or warning status changes. This is because thresholds are calculated based on the combined data from the past 12 hours or 7 days (periodic or API update respectively). You can verify that an issue is resolved by watching the percentage of errors in the logs gradually decrease over time.

Logs for events and page context

The log includes overall percentages of invalid items, as well as a sample of unique invalid items organized by type. It is not a fully comprehensive log with details about each event, row, and pageview.

For example, the events log in the following image displays a section for each type of event that was triggered, what percentage of the events was invalid, and a sampling of the invalid events with their errors.

Logs for data feeds

Data feed logs differ depending on whether the feed is synced or not. If the feed is synced with warnings, the log contains the list of individual rows that are not synced and some details. If the feed is not synced at all due to an error, the log contains only the error details.

Error MessageDescription
Internal errorFeed sync failed due to an unexpected error. Open a support ticket.
Too many warningsFeed sync failed because more than 90% of the rows in the feed are invalid.
JavaScript errorFeed sync failed because the parser function did not return a valid feed.
Invalid headersFeed sync failed because a required column is missing.
TimeoutFeed sync failed because there was no response from the URL for 5 minutes.
Invalid FormatFeed sync failed because the feed file was not a valid CSV, JSON, or XML file.
URL not foundFeed sync failed because the URL was not found or an error occurred when trying to download from the URL.
File size exceededFeed sync failed because it exceeded the size limit for your account. Open a support ticket to determine whether your feed size limit can be enlarged.

Implementation Helper

The Implementation Helper is a debugging tool that appears over the web page while you're browsing your site. It enables you to validate:

  • Context
  • Events
  • Audiences

To use the Implementation Helper:

  1. Log in to the Dynamic Yield console.
  2. Open your site with your desktop browser.
  3. Hover over the blue Dynamic Yield icon and click Implementation Helper (the green wrench icon).
  1. Navigate around your site to see live updates about the page you're on, events you trigger, audiences you belong to, and more.

Using the tool you can view:

  • Context Implementation: The status of the page context on the current page
  • Events: Details about any events fired during your session.
  • Audiences: The audiences that you belong to in your current session.
    While the implementation helper is mostly used during implementation, you can open it at any time to verify changes such as new events, or when troubleshooting.
  • Implementation Status: A dashboard, available for each one of your sites, providing you with status of your script, page context, events and data feed. There you will also find downloadable logs to investigate exactly what is causing an error. Learn more about the Implementation Status dashboard.
  • Web Implementation Helper: This tool opens up a panel directly on your website as you navigate, simulating a funnel or use case. The panel presents in real time:
    • The page context of the current page
    • The audiences you currently belong to
    • The events you have triggered
  • Dashboard Notifications: When you pass a predefined threshold of errors, you receive error notifications on your dashboard. The thresholds are configurable and can be set differently for each site. If you believe the errors are too sensitive, or not sensitive enough, contact your Customer Success Manager.