MetaLocator can send analytics events to Adobe Analytics through the Adobe Data Layer on the host page where your MetaLocator interface is installed.
This article explains how to enable Adobe Analytics event forwarding from MetaLocator to your website’s parent page.
Overview
MetaLocator interfaces are commonly embedded in a website using an IFRAME. Because Adobe Analytics is normally installed on the website page itself, analytics events should be sent from the host page, not directly from inside the MetaLocator IFRAME.
MetaLocator provides a setting for this purpose:
Adobe Analytics: Send Events from Host Page
When enabled, MetaLocator sends supported analytics events from the host page to the Adobe Data Layer. Your Adobe-provided installation code must be present on the same host page where the MetaLocator interface is embedded.
Requirements
Before enabling this setting, confirm the following:
Adobe Analytics is installed on the host page.
The Adobe-provided installation code is included on the host page on your Website, not inside MetaLocator.
The Adobe Data Layer is available on the host page.
You have access to update the MetaLocator interface settings.
Your Adobe Analytics implementation is configured to consume events from the Adobe Data Layer.
If Adobe Analytics is not installed on the host page, enabling this setting in MetaLocator will not send data to Adobe Analytics.
Enable Adobe Analytics events in MetaLocator
To enable Adobe Analytics event forwarding:
Log in to MetaLocator.
Open the interface you want to configure.
Go to the Analytics settings.
Locate the setting named Adobe Analytics: Send Events from Host Page.
Set the option to Yes.
Save your changes.
Once enabled, MetaLocator will send supported analytics events from the host page to the Adobe Data Layer.
Important installation note
The Adobe Analytics installation code must be installed on the host page where the MetaLocator interface appears.
Do not place the Adobe Analytics installation code inside the MetaLocator IFRAME. The purpose of this setting is to allow analytics events to be sent from the parent page so they can be handled by the Adobe Data Layer available on your website.
Testing the integration
After enabling the setting, test the page where MetaLocator is installed.
Recommended testing steps:
Open the website page containing the MetaLocator interface.
Confirm that Adobe Analytics and the Adobe Data Layer are loading on the host page.
Interact with the MetaLocator interface.
Perform common locator actions such as searching, viewing results, clicking locations, or submitting forms.
Use your browser developer tools, Adobe Experience Platform Debugger, or your organization’s analytics QA process to confirm events are being sent to the Adobe Data Layer.
Confirm that Adobe Analytics receives the expected events.
Troubleshooting
No Adobe Analytics events are received
Confirm that the Adobe Analytics installation code is present on the host page where the MetaLocator interface is embedded. The code must be installed on the parent page, not within MetaLocator.
The Adobe Data Layer is not receiving events
Confirm that Adobe Analytics: Send Events from Host Page is set to Yes in the MetaLocator interface settings.
Also confirm that the Adobe Data Layer is available on the host page before testing MetaLocator interactions.
Events are not appearing in Adobe Analytics reports
Confirm that your Adobe Analytics implementation is configured to consume the events sent to the Adobe Data Layer. Your Adobe Analytics administrator may need to review your Adobe Data Layer rules, event mapping, report suite configuration, and variable assignments.
The setting is enabled but nothing changes
This setting only sends supported MetaLocator analytics events to the Adobe Data Layer on the host page. Adobe Analytics must still be installed and configured separately by your website or analytics team.
Best practices
Install Adobe Analytics on the same host page where the MetaLocator interface is embedded.
Enable Adobe Analytics: Send Events from Host Page only when your Adobe Data Layer is configured to receive MetaLocator events.
Test in a staging environment before enabling the setting on a production page.
Coordinate with your Adobe Analytics administrator to confirm event mapping and reporting.
Avoid adding duplicate custom tracking for the same MetaLocator interactions unless your analytics team has confirmed that duplication will not occur.
Getting help
If you need help enabling this setting, contact MetaLocator support and include:
The URL where the MetaLocator interface is installed.
The MetaLocator interface ID, if available.
Confirmation that Adobe Analytics is installed on the host page.
A description of the MetaLocator actions you expect to track.
Any testing details from your Adobe Analytics or Adobe Experience Platform Debugger tools.
MetaLocator support can help confirm that the setting is enabled and that MetaLocator is configured to send events from the host page. Your Adobe Analytics administrator should confirm the Adobe Analytics installation, Data Layer configuration, and reporting setup.