All Collections
3rd-party Integrations
Analytics
How to connect Batch to AT Internet?
How to connect Batch to AT Internet?

Learn how to enable tracking of AT Internet campaigns to track Batch's web and mobile campaigns.

Selma avatar
Written by Selma
Updated over a week ago

AT Internet is a powerful and modern analytics solution that:

  • Enables you to collect and take control of relevant data on your website and apps.

  • Gives you simple tools to analyse your data and identify key insights that will lead to new opportunities for your business. 

  • Activate this data via their rich partnership ecosystem, which Batch is a part of.

A- Tracking Web Push Notifications

You can easily collect your Batch web campaign opens in AT Internet through two simple steps: create the xtor parameter in AT Internet and then add it to your deeplinks.

1. Creating the xtor Parameter on AT Internet

First, you will have to create a Custom Marketing Campaign on AT Internet. Go to Settings (top right menu) > Settings > Custom Marketing Campaign. Then, create a Source (named "Push Campaign" for instance) and a Campaign using that source. Once the campaign is created, it will be associated with an xtor parameter that you are going to need for the next step.

2. Linking Your AT Internet Campaign With Your Batch Campaign

The last step is to add your xtor query parameter to the deeplink of the push notification campaign you are about to send.

If your xtor is CS1-123-label1-label2-label3 , add the parameter to your deeplink: https://mywebsite.com/item?xtor=CS1-123-label1-label2-label3

Note: xtor parameters should not be more than 250 characters long and cannot contain any special characters. More information on xtor formating here.

Now, each user who opens this notification will be tracked down by AT Internet and will be visible as a "Campaign traffic source".

B- Tracking a push or an In-App campaign

You can easily collect your Batch mobile campaign data in AT Internet using our built-in event dispatcher. Simply follow the steps below.

1. Installing the AT Internet Dispatcher in Your Application

The AT Internet dispatchers use the xtor parameter from your campaign to dispatch a new set of data on AT Internet.

If you haven't already installed the AT Internet event dispatcher, please read our technical documentation for Android and iOS.

Note: The AT Internet dispatcher doesn't support the Marketing campaigns v2 javascript notation of AT Internet (as it's not available on Android and iOS), so make sure to use the xtor parameter in your links.

Marketing Campaign Module

AT Internet doesn't work the same way as Firebase or Google Analytics, especially, AT Internet allow only one campaign to be associated with every session (or visit) on your application or website (as a Traffic Source).

However, Batch allows you to trigger several campaigns per session.

So to answer this problem, Batch data are dispatched to two AT Internet modules, the Marketing Campaign module and the On-site ads module.

Only the first detected campaign during a session will be available on the AT Internet dashboard.

You can consult those data in Traffic Sources > Marketing Sources and Content > Pages.

On-site Ads Module

The on-site ads module allows you to track ads impressions and clicks on your website/application. As the marketing campaign module doesn't allow us to keep track of several campaigns running simultaneously during the same session, we also dispatch Batch data on the on-site ads module to allow our customers to retrieve all data, campaign per campaign, on the AT Internet dashboard.

You can consult those data in Content > On-site Ads > Publisher Campaigns on the AT Internet dashboard.

2. Creating the xtor Parameter on AT Internet

Similarly to web push campaigns tracking, you need to create a Custom Marketing Campaign (or publisher campaigns for Batch's In-App messaging campaigns) on AT Internet as described in section A.1 above. Once the campaign is created, it will be associated with an xtor parameter that you are going to need for the next step.

3. Linking Your AT Internet Campaign With Your Batch Campaign

Push Campaign

The dispatcher gathers the xtor parameter from the deeplink URL and from the custom payload of your campaign. You can use either. If both are filled, the custom payload's xtor parameters will be prioritized over the deeplink's parameters.

Note: xtor parameters should not be more than 250 characters long and cannot contain any special characters. More information on xtor formatting here.

In-App & Mobile Landing Campaign

The dispatcher gathers the xtor parameter from the deeplink URL and from the Tracking ID field of your campaign.

Once that is done, you will be able to track different types of events related to your push or In-App messaging campaigns on AT Internet.

⚠️ Please note that the event dispatchers are only available from Batch's 1.15 SDK version and above. If you use an older version of Batch's SDK you can integrate the AT Internet Batch plugin. However, this only allows you to track push opens and retrieve the campaign's xtor parameters.

AT Internet Plugin Integration for Older SDK Versions

The plugin's job will be to read Batch's notifications clicks, and extract the right parameters before sending them to AT Internet.

Android:

Start by copying the ATInternetBatchIntegration class to your project. The code can be found here :

As shown in the BaseActivity example of the gist, you will have to call ATInternetBatchIntegration.handleIntent in every activity, both in onCreate and onNewIntent.

iOS:

Copy the ATInternetBatchIntegration class in your project. The code can be found here (Swift 4.2):

Then, as shown in the gist, simply call ATInternetBatchIntegration.setup()

in applicationDidFinishLaunchingWithOptions before Batch.start(withAPIKey:)

If you call this method after starting Batch, the integration may work incorrectly.

Once you integrate the plugin, you can create your xtor parameters and add them to your campaign's deeplink as described in sections A.1 and A.2 of this article.


This article belongs to Batch's FAQ. Need more help? Find insightful articles, documentation, case & market studies, guides, and even more in our website's Resources section on batch.com and our blog.

Did this answer your question?