GA4 for In-App Checkout and Portal

Chargebee provides built-in support for Google Analytics 4 (GA4) by sending checkout and portal events to GA. You can tailor your GA4 data collection to meet the specific requirements of your business by utilizing both the built-in Google support and Chargebee's custom GA integration. By collecting and analyzing data on user behavior, you can gain insights that help optimize your customer experience, improve your conversion rates, and ultimately drive your business growth.

Setting up GA4 for the First Time

To set up analytics data collection for the first time on your website, follow these steps:

Prerequisites

1. Set up a GA4 account and then a GA4 property. Option 1: Setting up analytics data collection for the first time. Option 2: Migrating from UA to GA4. Learn more.
2. Add the Google tag script: Add the Google tag to your web pages to begin seeing data in your new Google Analytics 4 property. Follow the steps under add the Google tag directly to your web pages on this page. See the video below as a reference to get the Google tag script:
   
3. Go to Settings > Configure Chargebee > Checkout & Self Server Portal.
4. To track and measure purchase events in Chargebee, select the Configuration tab and add your domain under the Add Domain option under Advanced Settings.
   

Setting Up GA Integration

Once the above prerequisites are met, use the built-in GA event tracking in Chargebee JS and/or use your own custom GA Integration to send events to GA using Chargebee JS callbacks.

Let's see how each can be done.

Built-in GA Integration

When built-in GA integration is enabled, Chargebee triggers events to GA based on page events on the Chargebee Checkout or Portal.

You may integrate via drop-in script or API.

A. Using Drop-in Script

Enable the data-cb-ga-enabled attribute to true when invoking Chargebee JS in the page headers of your site.

<script src="https://js.chargebee.com/v2/chargebee.js"
data-cb-site="your-chargebee-subdomain" data-cb-ga-enabled="true">
</script>

<script src="https://js.chargebee.com/v2/chargebee.js"
data-cb-site="bigshopper-test" data-cb-ga-enabled="true">
</script>

B. Using API

Pass the enableGATracking parameter as true when initializing the Chargebee instance.

var chargebeeInstance = Chargebee.init({
site: "your-chargebee-subdomain",
enableGATracking: true
});

Limitations of Built-in GA integration

• Built-in GA support is only available for checkout and portal pages and not for any other forms of modal-type action pages in Chargebee such as Pay Now or Extend Subscription.
• If checkout or portal is launched by customers via Chargebee emails sent to them such as an accept quote email or a cart abandonment notification, built-in tracking will not work because Chargebee JS is not loaded in such cases.
• If checkout or portal is opened in a new tab/window, the GA integration will not work because Chargebee JS is not loaded.

Custom GA Integration

To overcome the limitations of the built-in GA integration, you may choose to set up the GA event tracking using Chargebee JS callbacks.

The following pages will guide you to set this up:

• Chargebee JS drop-in code reference.
• Chargebee JS API-based integration reference.
• Help pages for sending data to GA using gtag.js.

Customized event tracking can be used along with built-in tracking to extend the latter's functionality. You can track a successful Checkout by passing information to your site in the query parameters of the redirect URL in your plans.

Track Chargebee Checkout and Portal Events

Events passed to GTM/GA

The table below lists the events fired when the GA/GTM integration enabled:

Purchase Event Parameters

This table lists the additional parameters passed as part of the purchase event:

Each array element for items is composed of the following:

Add GA4 to a Site with Universal Analytics(UA)

Add GA4 to your existing UA setup to enhance the tracking and analytical capabilities of your website.

Prerequisite

You should have at least an Edit role for your GA account.

Steps to Migrate

Follow the below steps to add GA4 to a site with UA.

1. In the UA property interface, click Admin.
2. Under the property column, select the property that you'd like to migrate and click GA4 setup assistant. If you're doing this for the first time, you can either create a new GA4 Analytics property or connect your existing UA property to the GA4 property.
   
3. Click Create property.

Learn more about adding a Google Analytics 4 property (to a site that already has Analytics).

How to get GA4 Measurement ID

You can use the Measurement ID to send data to a specific web data stream.

Follow the steps below to get your GA4 Measurement ID.

1. Login to your GA4 analytics account.
2. Navigate to the Admin section.
3. Under the property section, Click Data streams.
   
4. Select the data stream that you wish to track(likely to be your website). Then in the upper right corner, you can see your measurement ID. Learn more about G-ID.
   
5. Click View tag instructions > Install manually and replace the existing GA script with this one.
   

Dual Tagging for Google Analytics

If you wish to track both UA and GA4 properties, then update the existing script of your analyitcs to add the new Google tag('G-XXXXXXXXXX') on each page of your website from the JavaScript snippet for your account along with the existing script for your website.

Example:

<script async src="https://www.googletagmanager.com/gtag/js?id=UA-XXXXXXXXX-X"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
  gtag('js', new Date());
  gtag('config', 'UA-XXXXXXXXX-X');
  gtag('config', 'G-XXXXXXXXXX');
</script>

How to Migrate UA Goals to GA4 Conversions

1. Under GA4 property Click Setup Assistant.
   
2. In the Setup Assistant, scroll down to Property Settings.
3. Select Setup Conversions.
   
4. Click > Actions Import from Universal Analytics. Note that, this option will appear if you are already connected to your UA ID and you have Goals set up under UA property.

Learn more about setting up conversions.

Analyze Data in GA4

After you have configured GA4 tracking for Chargebee Checkout and Portal, you can analyze the data in your GA4 account. You can view reports related to customer behavior, subscription trends, and revenue metrics, among others.