Once you have implemented Dynamic Yield, it is 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:
- Periodic sync: A summary of the past 12 hours
- API sync: A summary of the past 7 days
- Implementation Helper: Immediate debugging tool over the browser
Implementation status
An overview of the implementation 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, event, and product feed status are only available for e-commerce sites.
The following table gives more details about the meanings of each status.
| 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 |
Periodic sync: The feed synced, but some individual 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. |
|
| 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 once 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.
Note: After resolving an issue, it may take some time until the error or warning status is changed. This is because the 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 has been successfully resolved by watching the percentage of errors in the logs gradually decrease over time.
Logs for events and page context
Overall percentages of invalid items are presented, 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 was synced or not. If the feed was synced with warnings, the log contains the list of individual rows that were not synced and some details. If the feed was not synced at all due to an error, the log only contains the error details.
| Error Message | Description |
|---|---|
| Internal error | Failed to sync the feed due to an unexpected error. Open a support ticket. |
| Too many warnings | Failed to sync the feed because more than 90% of the rows in the feed were invalid. |
| Javascript error | Failed to sync the feed because the parser function did not return a valid feed. |
| Invalid headers | Failed to sync the feed because a required column was missing. |
| Timeout | Failed to sync the feed because there was no response from the URL for 5 minutes. |
| Invalid Format | Failed to sync the feed because the feed file was not a valid CSV, JSON, or XML file. |
| URL not found | Failed to sync the feed because the URL was not found or an error occurred when trying to download from the URL. |
| File size exceeded | Failed to sync the feed because it has exceeded the size limit for your account. Open a support ticket to determine if 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
- Event
- Audiences
To use the Implementation Helper:
- Log in to the Dynamic Yield console.
- Open your site with your desktop browser (say, Chrome).
- Hover over the Dynamic Yield button
and click Implementation Helper 
.
- 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
Learn more about the Implementation Helper.
- 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.