Integration QA Steps: Conversion

Steps to QA your integration of Chartbeat Conversion

Conversion QA Checklist

Reviewing your code

Conversion Event Guidelines

Review the guidelines below to ensure your conversion events are being fired according to our best practices:

Verify subscriptions.js loads

In order to track events with Chartbeat, the subscriptions.js script must load first. Use your browser's developer tools to confirm that it is loading.

Select the Network tool and filter for subscriptions.js:

Verify events are being tracked

Conversion data is sent via a ping request to Chartbeat, you can review the data being sent by using using your browser's developer tools: Select Network and filter for conversion_event :

Click Payload and review the query string parameters. Verify that the values match what you intended to send.

Parameter

Value

p

path

h

siteID or host

d

actual domain

cec

event category (e.g. paywall)

cet

event type (e.g. shown)

cel

event label

cev

event value

If you are using the optional pathOverride parameter, make sure to check that the p parameter contains the pathOverride value. Otherwise p should match the article's page path that you're sending to Chartbeat in your standard configuration.

Using Debug Mode

When debug mode is enabled for each event, the event details will display in the console.

Enable Debug Mode for an Event: Add the debug parameter set to true for an event method to print the event configuration to the console. This will only print to the console if a ping was successfully sent to Chartbeat.

chartbeat('trackPaywallStart', {
    debug: true
})

In your browsers's developer tools, select Console to find your event debug details:

Implementation Review

Our Implementation Review dashboard lets Admin users view data snapshots from the latest full calendar day we have on hand. The Conversions Audit tab provides a way to verify correct Conversion implementation and to help self-diagnose data discrepancies or issues.

To access Implementation Review:

  1. Sign in to your Chartbeat account.

  2. Navigate to Settings from the menu top right-head

  3. Click the Implementation Review pages on the left side menu

  4. Navigate to the Conversions Audit Tab

Tip: If you cannot access the Implementation Review, verify with your organization if your account has the required Admin role.

Next Steps

Read through the next article in this guide to review a list of supported conversion flows

Last updated