google analytics integration guide - u-btech solutions · google analytics integration guide...

© U-BTECH SOLUTIONS LTD. GOOGLE ANALYTICS INTEGRATION GUIDE | PAGE 1

XTRABANNERGoogle Analytics Integration GuideU-BTech Solutions LTD.

Created: 18-Oct-2017

INTRODUCTION

We are excited to announce that all XtraBanner versions now supports integration with Google Analytics for collecting data, measuring and analyzing e-mail campaigns. This document will guide you, step-by-step, through configuring the

Google Analytics integration.

AUDIENCE

This document is targeted towards IT infrastructure personnel, in charge of managing and configuring XtraBanner in their organizations. However, Website owners, Webmasters and Campaign Managers may also find interest in some

parts of this document.

ABOUT XTRABANNER

XtraBanner is an E-mail enrichment system, created for organizations running Microsoft Exchange Server (versions 2007, 2010 and 2013) as their messaging infrastructure. Once configured, the system add s banners, ads or disclaimers to the organization's e-mail correspondence. XtraBanner is also available as a cloud

Service.

ABOUT XTRABANNER REPORTING CAPABILITIES

XtraBanner collects statistical information about e -mails enriched by the system. Collected information, as of version 2.0, includes:

Number of messages sent with each campaign.

Number of unique recipients for each campaign.

Per sender, per recipient, and per Exchange server counters.

Enriched e-mails can include, if configured, a clickable hyperlink to an existing page on a website (referred to as a "landing page"). Campaign Managers frequently need to measure how effective a campaign is, mostly by measuring the number of clicks per campaign ("click count") and the ratio between clicks and


impressions, referred to as "Click-through rate" (or "CTR" for short). Since the hyperlink frequently directs to a landing page on a server hosted outside the organization, XtraBanner cannot keep track of clicks on those links, what visitors do after clicking, where do they come from and other information related to web

analytics.

ABOUT GOOGLE ANALYTICS

Google Analytics (referred to as "GA") is a service offered by Google that generates detailed statistics about visits to a website. At the time of writing this document, GA is the most widely used website statistics service and the basic

service is offered free of charge.

HOW GOOGLE ANALYTICS WORK

GA collects information using a Google Analytics Tracking Code (GATC), which is a snippet of JavaScript code that the website owner adds to every page of the website. The code runs in the client browser when the client visits the page and collects visitor data and sends it to a Google data collection server .

Website owners can then view and analyze the collected data using the GA web interface.

HOW XTRABANNER INTEGRATES WITH GOOGLE ANALYTICS

GA integration is a two-fold process:

XtraBanner tags campaign hyperlinks with Urchin Tracking Module (UTM)

codes, so the source of visits can be analyzed both by GA and by XtraBanner. The following UTM tags are added by XtraBanner:

o utm_source: contains a unique ID for each XtraBanner campaign

o utm_medium: contains the value "email", as recommended by

Google for e-mail campaigns.

o utm_campaign: contains the campaign name, as configured in the

XtraBanner management console.

XtraBanner collects visit count data from GA, using an Application

Programming Interface (API) provided by Google, and displays this information in the XtraBanner management console.


GOOGLE ANALYTICS INTEGRATION ADVANTAGES

Campaign Managers can view detailed analytics data from all advertising

channels, including XtraBanner, search engines, pay-per-click networks

and display advertising, in a single user interface – the GA web interface.

Campaign Managers can view XtraBanner-specific statistics in the

XtraBanner Management Console, including click count data.

Campaign Managers can decide whether or not to integrate a specific

XtraBanner campaign with GA.

CONFIGURING XTRABANNER INTEGRATION WITH GOOGLE

ANALYTICS

This section provides a step-by-step guide for configuring GA integration. Though

it requires multiple steps to complete and may look complex, it is a one-time, "set

it and forget it" process.

STEP 1: PREREQUISITES

1. To begin, you must have at least one GA-enabled website. In case you are

new to GA and have never used it before, please refer to Google's "Getting Started with Google Analytics" guide:

https://support.google.com/analytics/answer/4553001

2. XtraBanner must be deployed in your organization. If a previous version of XtraBanner is deployed in your organization, you must first upgrade

the deployment (including the Configuration Point, all Transport Agents and all Management Consoles), as GA Integration is a new feature

introduced in XtraBanner 2.0.Removing the older version does not delete existing rules and campaigns, so you can safely uninstall an older version and install a new one. The latest version of XtraBannercan be downloaded from U-BTech's website:

http://www.u-btech.com/products/xtrabanner

If you are using the XtraBanner Cloud Service, GA Integration is already supported.

STEP 2: GET A SERVICE ACCOUNT API KEY

NOTE: This step is only required for on-premise deployments. If you are using

Google Analytics with the XtraBanner Cloud Service, please skip to Step 3

and use the pre-configured Cloud API account.

http://www.u-btech.com/products/email-enrichment.html


In this step, you will request a private key for accessing the Google Analytics API. A single API key can be used by the entire organization. This step is typically performed by the organization's IT department.

3. Open a web browser, and browse to the Google APIs Console:

https://console.developers.google.com

4. Login with a Google account. We recommend using an account controlled

by the organization's IT department, as it will be used for creating an API private key for your organization. This account will not be used for log ging in to Google Analytics.

5.

In the Google APIs Console, click "Create Project" and give it a name.

6. Click on the "Library" section and in the list of services locate the "Analytics API"service.


7.

Click on the service and enable it.

8.

The Analytics API service should now be marked as "enabled".

9. Click "Credentials" on the left menu and choose "0Auth consent screen".Under "Product Name", enter "XtraBanner" (without quotes) and then click "Save".

10. Click "Create credentials and select "Service account key""


11. In the "Create service account key" section, under "Service account",choose new service account and give it a name,a role and "Key type" P12.Then click on "Create".

12. You will be notified that a private key is saved to your computer.Save the key to a secure and well-known folder.


13.Now click the "Manage service accounts" button.

14.On the next page locate the service account ID,and copy it to the clipboard (right -click then "Copy").

15. Locate the key you just downloaded, and rename it to the value you have

just copied, keeping the .p12 file name extension. The renamed file should

look like:[email protected]

16. Copy the file to the server where the XtraBanner Configuration Point is installed, under the path: C:\ProgramData\U-BTech Solutions LTD\XtraBanner-0000\GoogleKeys Note: the C:\ProgramData folder is hidden by default.

mailto:[email protected]


17. Make sure that in "IAM" section you see the service account ID just created.

STEP 3: ALLOW THE API ACCOUNT TO READ GOOGLE ANALYTICS DATA

In this step, you will permit the API account to read Google Analytics data, so it can be fetched by XtraBanner and displayed in the XtraBanner Management Console. This step is typically performed by a Campaign Manager or a

Webmaster, and is required only for fetching and displaying click information in the XtraBanner Management Console.

18. Browse to the Google Analytics website: https://analytics.google.com/analytics/web/ Now select "ADMIN" section in the left menu:

http://www.google.com/analytics/


19. Select the GA account, property and view you wish to allow access to, then click "User Management".

20. In the "Add permissions for:" section fill-in the service account ID that you copied in stage 14. example:[email protected]

Make sure the "Read & Analyse" permissions are selected .This will allow read-only access.Click the "Add" button.


22.Make sure the service account was added to the list of accounts.

23. Repeat all sub-steps above for each GA-Enabled website or view you want to use with XtraBanner.

STEP 4: ENABLE GOOGLE ANALYTICS FOR XTRABANNER CAMPAIGNS

24. Open the XtraBanner Management Console. In the console: 1. Double-click an existing rule in the rule list 2. In the "Rule Configuration" window, click the "Campaigns" tab. 3. Check the "Analytics Enabled" checkbox for campaigns you want to enable GA for.

VIEWING ANALYTICS DATA USING THE XTRABANNER

MANAGEMENT CONSOLE

The XtraBanner Management Console displays per-rule (aggregate values) and

per-campaign click counts:

Per-rule aggregate counts are displayed in the "Clicks" column of the rules

list.

Per-campaign counts are displayed in the "Clicks" column of the

"Campaigns" tab, inside the "Rule Configuration" window.

mailto:[email protected]


VIEWING ANALYTICS DATA USING GA WEB INTERFACE

Detailed analytics data can be viewed from the Google Analytics web interface.

Since XtraBanner tags banner links with campaign names, you can easily view

XtraBanner campaigns from the "Acquisition" / "Campaigns" view. You can also

filter campaigns by:

Medium: XtraBanner tags banner links with the "email" medium.

Source: XtraBanner tags banner links with a source tag in the format

"XtraBanner-*", where * is a unique campaign identifier. You can

customize a new GA Segment that shows only sources that start with the

"XtraBanner-" pattern.

CONCLUSION

Once configured, XtraBanner can provide click count data in the management

console, and detailed analytics data in the GA web interface.

google analytics integration guide - u-btech solutions · google analytics integration guide...

Documents