Scroll tracking
For client-side implementations, scroll-tracking events are automatically handled within the JavaScript, requiring no additional scripts or payloads.
Example triggers
To determine the correct triggers to use for sending events to AI Paywall, such as firing a 44 event when a paywall component loads, we highly recommend leveraging any existing triggers and event listeners you have on your site.
If you don’t already have these in place, you can use one of the following methods for setting up triggers:
- Through an event listener
- Through dataLayer form events
Prerequisites
Before proceeding, ensure the following conditions are met:
- You are using a client-side implementation (these options are not compatible with server-side solutions).
- There are no existing triggers or listeners that can be leveraged.
- Your forms are built using Zephr’s in-built functionality (event triggers through a listener or dataLayer form events are supported for custom forms).
Via Event Listener
You can deploy an event listener on your page using JavaScript before rendering the forms.
The following example adds a listener for key impression, click, and conversion events, using a switch statement to handle each event:
window.addEventListener( "message", (event) => { if (event.origin !== window.origin || !event.data?.["zephr-form-datalayer-event"]) return; const formEvent = event.data["zephr-form-datalayer-event"]; switch (formEvent.event) { case 'zephr_form_render': console.log('Form rendered, action 44', formEvent); break; case 'begin_checkout': console.log('Begin checkout, action 28', formEvent); break; case 'zephr_form_purchase': console.log('Form purchase complete, action 151', formEvent); break; default: console.log(`Form event: ${formEvent.event}`, formEvent); } }, false, );
Via dataLayer form events
You can push form events to the dataLayer and use these events as your triggers.
To enable this, go to Zephr > Settings > Data Layer and enable the Send form events to the dataLayer toggle.
Once enabled, use the list of available dataLayer events in the following table as triggers for AI Paywall Event Tracking:
dataLayer Event | Equivalent AI Paywall Event | Action | Description |
Zephr_form_render | Paywall impression | 44 | This event is pushed to the dataLayer when a Zephr form is rendered. |
zephr_form_section_change attribute: previousPartId = plan-select |
Paywall click | 28 | This event is pushed to the dataLayer when a user clicks to choose a plan on the Zephr form. |
zephr_form_register | Registration conversion | 71 | This event is pushed to the dataLayer when a user creates an account through a Zephr form. |
Zephr_form_purchase | Paywall conversion | 151 | This event is pushed to the dataLayer on a completed purchase through the Zephr form. |