Skip to main content

Scroll tracking

Zuora

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.