© 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
© U-BTECH SOLUTIONS LTD. GOOGLE ANALYTICS INTEGRATION GUIDE | PAGE 2
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.
© U-BTECH SOLUTIONS LTD. GOOGLE ANALYTICS INTEGRATION GUIDE | PAGE 3
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.
© U-BTECH SOLUTIONS LTD. GOOGLE ANALYTICS INTEGRATION GUIDE | PAGE 4
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.
© U-BTECH SOLUTIONS LTD. GOOGLE ANALYTICS INTEGRATION GUIDE | PAGE 5
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""
© U-BTECH SOLUTIONS LTD. GOOGLE ANALYTICS INTEGRATION GUIDE | PAGE 6
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.
© U-BTECH SOLUTIONS LTD. GOOGLE ANALYTICS INTEGRATION GUIDE | PAGE 7
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.
© U-BTECH SOLUTIONS LTD. GOOGLE ANALYTICS INTEGRATION GUIDE | PAGE 8
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:
© U-BTECH SOLUTIONS LTD. GOOGLE ANALYTICS INTEGRATION GUIDE | PAGE 9
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.
© U-BTECH SOLUTIONS LTD. GOOGLE ANALYTICS INTEGRATION GUIDE | PAGE 10
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.
© U-BTECH SOLUTIONS LTD. GOOGLE ANALYTICS INTEGRATION GUIDE | PAGE 11
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.