Google Analytics

❗️

Important

No personal information from Billsby customers is passed to Google Analytics. Before integrating with Google Analytics you should make sure your usage is compliant with local data protection regulations. Learn more about Google Analytics and GDPR here.

Google Analytics helps you gauge the usage of the self-service modals by tracking customers as they move through the pages, triggering events. You'll see these events logged in real-time, helping understand your customers across different devices, platforms, and more.

Setting up your Google Analytics account

Whilst we're more than happy to help you integrate Billsby with Google Analytics, our scope of support doesn't include setting up or configuring your Google Analytics account.

Google's support champions may be able to help you configure an account to suit your business's needs, or with specific challenges you might have.

Prerequisites

1. To integrate Billsby with Google Analytics, you must have already setup and configured your Google Analytics account, including your GA property.

2. Install the Google Tag (gtag.js) on your website.

🚧

Using Universal Analytics?

Our integration only supports Google Analytics 4, not Universal Analytics. Make sure any new properties are created in GA4 and existing properties have been migrated to GA4 to ensure your data is passed correctly. You can find more details on migrating an existing UA property to GA4 here.

Please note this page details our integration between Google Analytics, not Google Tag Manager or other Google properties like Google Ads.

Integrating Google Analytics with Billsby

Billsby integrates with Google Analytics using the Measurement ID of your property's data steam.

The Google Analytics integration tracks the usage of our self-service checkout and account management modals. Events will be logged whenever these modals are opened for your company, this includes instances where the modal is loaded from within email notifications, or from inside the Billsby control panel. If you'd like to filter out internal traffic, you can read more here

1. To integrate your Google Analytics account with Billsby, copy the Measurement ID for your property's data stream. In Google Analytics 4, your Measurement ID will start with 'G-'
You can find instructions on how to locate your Measurement ID here

2. Navigate to the Settings > Configuration > Checkout and account management > Google Analytics menu and copy your Measurement ID into the Google Analytics code field.
Then click the Update code button to save changes.

You should see visitors and traffic data from Billsby being synced to your GA account in real-time. However, it can take up to 24 hours for the data to show in your reports.

Cross domain tracking

When customers are redirected to Billsby's checkout modal, they move from your domain to Billsy's domain.
For example: you have the Billsby self-service checkout modal embedded into your website > A customer visits your website, then clicks a Subscribe button that opens the Billsby checkout modal.

Events across different domains should be collected automatically, however if you find events are not being collected, you can manually configure the tag settings for your property to include Billsby's domain. Instructions on setting up cross-domain tracking are as follows, but more information can be found here

• In Admin, click Data Streams in the Property column of your GA account.
• Click Web and then click the web data stream for your website where the Billsby self-service checkout modal is embedded.
• In the web stream details, click Configure tag settings (at the bottom).
• In the Settings section, click Configure your domains.
• Under Include domains that match ANY of the following conditions:
• Choose the Contains match type.
• Under Domain, enter Billsby's domain URL ''billsby.com"
• Click Save.
• Copy the Management ID for the data stream
• Navigate to Billsby control pannel Settings > Configuration > Checkout and account management settings > Google Analytics
• Paste the Management ID into the Google Analytics code field
• Click Update code

Ignoring self-referals

Referral traffic is any traffic that is brought to your site from another source To ensure data is being reported correctly in GA, it is important to exclude traffic from within your own site so that it doesn't trigger a new session or categorize conversions from your site as a referral.
Ensure that you add your website's domain name and also the Billsby domain (billsby.com) under the unwanted referrals list.

You can find more instructions on configuring unwanted referrals here

Events passed to Google Analytics

Once you have configured your integration, you should see events being passed into Google Analytics 4 if they've been triggered. In the table below you'll find all of the Billsby events customers can trigger.

Please note that some events are automatically collected by GA. These events are triggered by basic interactions with any app and/or site, including the Billsby self-service checkout and account management modals. For example the Pageview event would be triggered and collected automatically every time a visitor views a page on your website, as well as every time they view a page in the Billsby self-service modals.

You can find a list of all of GA's automatically collected events and their parameters here

'Custom event / Billsby' type events mentioned above do not include any additional parameter data relating to the individual customer or subscription. All custom Billsby events only contain automatically collected parameter data.

Purchase event parameters

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

Google Analytics reports, dimensions and metrics

Google Analytics offers a wide selection of customisable reports that give you valuable insights into acquiring, engaging, monetizing, and retaining visitors.

Once you've integrated GA with your Billsby account, you should see data from events trigged in the self-service checkout and account management modals being sent to your property in real time. Data is typically shown in your Realtime Reports within 10 minutes, whilst all other reports may take up to 24 hours to populate.

GA reports are formulated using dimensions and metrics. Some dimensions and metrics are populated automatically when you add the Google tag (gtag.js) to your website, whilst others require additional configuration or need data from specific parameters to be sent.
Check out Google analytics' support documentation for more details on dimensions and metrics here.

Google Analytics has a variety of default reports for all of it's dimensions and metrics. You can customize default reports by using comparisons to compare data between your dimensions and metrics, or even create your own from scratch. Learn more about customizing reports here.

📘

Excluding Billsby automatically collected events

If you want to exclude data from automatically collected events triggered in Billsby from any of your reports, for example you want to only see page views from your main website not Billsby's self-service modals, you can do this by customising your chosen report and adding a new Filter.

Simply set the condition to Exclude and select the Hostname dimension, then select any URLs ending in ''.billsby'' as your dimension values. Then apply the filter and save the changes to your report.

Limitations

There are a few limitations to note with the Google Analytics integration. These are as follows:



• The Google Analytics integration will only track the usage of the self-service modals. Data generated via the API or Billsby control panel will not trigger events in GA.
  • Even though data is synced to Google Analytics in real-time, it may take up to 24 hours for the data to show in your reports.
  • Customers using an ad blocker or limiting cookies may prevent data from being tracked.
  • Events can only be triggered on specific pages of the self-service checkout and account management modals, these pages are listed below: