Segregate Internal & External Traffic In Adobe Analytics

Within the Adobe Analytics tool there are 4 main ways to deal with IP address exclusions:

1) Out of the box “Exclude by IP” functionality

This method can be accessed by going to the global ‘Admin’ drop down menu and selecting “Exclude by IP”.  Instructions on how to use this are contained within the page and it is by far the easiest method of removing traffic from specific IP addresses/ranges.

However, the disadvantage of this is that any excluded data is effectively lost for ever so this is not suitable if you ever want to analyse data from internal traffic for a given report suite.

Hint: what is not immediately obvious is that the exclusions work on a report suite by report suite basis – you need to make sure the correct report suite is selected in the top right hand corner

2) Get Adobe engineering to build a DB VISTA Rule

Typically this method would be used if you wanted to siphon off the internal traffic into a separate report suite to analyse separately from your external traffic.  However, Adobe engineering have an awful lot of flexibility within VISTA rules you are not limited on just siphoning data to a separate report suite if you can think of something more creative that you want to do!

The basic approach would be for Adobe Engineering to build a “DB” (Database) Vista rule that allow you to upload and manage via FTP a list of IP address that are excluded (i.e. allowing you to manage going forward without further intervention from Adobe Engineering).

As with all VISTA rules there will almost certainly be a cost associated with this.

3) Use Processing Rules in combination with Virtual Report Suites

IP address is available in processing rules, even if you’ve set your privacy settings to remove IP a ddress from your data.

This means you can using processing rules to set a value into a variable whenever you see an internal IP address (e.g. overwrite prop1 with a custom value of “internal traffic”)

The value captured can be used to segment your data or, as we do, used to created virtual report suites (e.g. one with external traffic, one with internal traffic)

The advantages of this is that it is non destructive and there is no cost. Though it is not retroactive process and will be affective after the setup.

4) Use segment or VRS

If you have list of IP address available in report suite then you can create segment and apply that on reports or create a VRS and you can share that VRS to stake holders. It is retro-active process.

How To Enable Or Disable Activity Map in Adobe Launch

Once Activity Map is enabled for an Adobe Analytics report suite, it can not be disabled, and so instead Adobe recommends that you remove the Activity Map module from your implementation to disable the functionality. 

AppMeasurement.js self-hosted

This can be completed simply by accessing your AppMeasurement.js and removing the Activity Map module. 

AppMeasurement.js hosted via the Adobe CDN

By default on console if you type s_c_il it will show the following.

Now to disable Activity Map.You have to use the available latest version of Adobe Analytics Extension so if it is not upgraded then upgrade that.

Go to the configuration of Adobe Analytics Extension and disable Activity Map by unchecked the box

After this publish the build and reload the page and this time the Activity Map will not load and can be checked through console.

In case you don’t want to stop the tracking through Activity Map but want to limit the tracking then you can check Activity Map Customizer Extension.

Feel free to comment in case you have any question or add any insights.

Never Tag for an eVar or Mbox Again,Meet Alloy.js

Over the years, as Adobe has built or acquired new technology and collected lots of JavaScript libraries — AppMeasurement.js, mbox.js, at.js, DIL.js, Visitor.js, just to name a few. Each has its own strengths, features, history, functions, schema, quirks and interdependencies. Although Adobe Experience Platform Launch makes it as easy as possible to manage all these libraries, customers have been asking us for years why we can’t just have one JavaScript tag and library. 

Now meet the new Alloy.js. Adobe worked hard all year to take all the best features of our current libraries and build a new one that supports Adobe Experience Platform, Adobe Analytics, Adobe Audience Manager and Adobe Target. One library and beacon, sent to a single destination, then mapped and sent to all your Adobe solutions server side. And that’s just the beginning.

Alloy is the code name for the Adobe Experience Platform Web SDK. It allows for streaming data into the platform, syncing identities, personalizing content, and more.

For documentation on how to use Alloy, please see the user documentation.

For documentation on how to contribute to Alloy, please see the developer documentation

Adobe Web SDK (alloy.js) FAQ’s

Download

How to Run Analysis on Adobe Launch Rules

Combination of Launch,Tagtacian & Adobe analytivs

If you want to do analysis on your Adobe Launch Rules.

 Find out what rules are most frequently used? Or which rules are failing?

This document provides a quick and simple way to leverage Tagtician (3rd party tool) and Adobe Analytics to track the performance of your Adobe Launch configuration and answer some of the basic questions surrounding your implementation. It will help answer the following questions:

  • Which rules run most, and which haven’t run over a period of time?
  • Which rules triggered but failed over conditions?
  • Which rules have triggered a certain Tag/Extension/Action most?
  • Which page of your site is the rule firing?

Getting these answers wouldn’t be just interesting but would help you to optimize/audit your Launch property by:

  • Removing rules/tags/extensions which haven’t run lately and have become obsolete.
  • Checking rules which aren’t supposed to run before/after a certain point in time.
  • Auditing if a certain rule/tag has stopped working suddenly.
  • Auditing if there are too many rules which fail over conditions on a single page (You might want to change the event).

To achieve this, here is high level plan:

  1. Tagtician Export of your Launch Library. (https://tagtician.com/)
  2. A Launch rule to track rule names using Launch library monitoring APIs.
  3. A list prop to capture rules’ names and classification reports to upload other data pertaining to Launch Rules.

Alright! Let’s get started…

1. Getting Ready:

1. Get Tagtician export of your Launch property.

2. Copy names of all the rules from Tagtician export and paste them in a new sheet. In the next column, name them as R1, R2, R3 so on…

Tagtician Export Launch Rules

3. Now create a JSON with rule names as Keys and abbreviations as Values. You can name JSON as “ruleLookUp”.

var ruleLookUp = {
"All Pages | DOM Ready | AA":"R1",
"All Pages | Lib Loaded | AT":"R2",
"User Login | Successful | AA":"R3",
"Impression | Media Pixels | gTag":"R4",
"PDP | DOM Ready | AA":"R5",
"Search Results | DOM Ready | AA":"R6",
"Search | Direct Call | AA":"R7",
"PDP | Add to Cart| Click | AA":"R8",
"Cart | Coupon | Click | AA":"R9",
"Cart | Removal | Click | AA":"R10",
"Transaction | DOM Ready | AA":"R11",
"FirstPage | LinkText | Click | FB - addToCart":"R12",
"Form Submit | Direct Call | AA":"R13",
"All Pages | Window Loaded | AA - Send Beacon":"R14",
"Video | Direct Call | AA":"R15",
"Link Click | Click | AA":"R16",
"Search | Filters | Direct Call | AA":"R17"
}

4. Enable two props in Adobe Analytics e.g. prop1 and prop2, name them “Rules Fired” and “Rules Failed Over Conditions” respectively.

5. Turn list support ON for these props with delimiter ‘|’.

2. Launch configurations

1. Create a rule in Launch with the following configurations:

Event: Library Loaded (Page Top) with Order 1
Condition: N.A.

This rule is supposed to run 1st on each page load. In case of SPA, you might want to change the event but ensure the order.

2. Now add Action – custom code JavaScript type – in the rule.

3. Now the idea is to capture rules which completed and those which failed over conditions into two separate arrays and put them in list props and send them in page load beacon.

For this, you will need to use Adobe Launch monitoring APIs.

var ruleCompleted = new Array();
var ruleConditionFailed = new Array() ;
window._satellite = window._satellite || {};
window._satellite._monitors = window._satellite._monitors || [];
window._satellite._monitors.push({
ruleCompleted: function (event) {
ruleCompleted.push(event.rule.name);
},
ruleConditionFailed: function (event) {
ruleConditionFailed.push(event.rule.name);
}
});

Disclaimer*

The above APIs (both _satellite._monitors and _satellite._container) should not be accessed from production code. They are intended only for debugging purposes and may (will) change over time as needs dictate. If you have debugging turned on, you’ll see a related warning in the console when using these APIs. Please take this warning seriously.

4. At this moment we have two problems:

  • How to capture rules which triggers after the send beacon rule e.g. click/interaction rules, direct calls rules, 3rd party rules, etc.
  • Max size of list props is 100 bytes and may easily run out of it.

Solution to these problems are Local Storage and using Rules abbreviation (instead of full name) respectively.

5. Here is how the final code will look like:

var ruleCompleted = new Array();
var ruleConditionFailed = new Array();
var ruleLookUp = {
"All Pages | DOM Ready | AA":"R1",
"All Pages | Lib Loaded | AT":"R2",
"User Login | Successful | AA":"R3",
"Impression | Media Pixels | gTag":"R4",
"PDP | DOM Ready | AA":"R5",
"Search Results | DOM Ready | AA":"R6",
"Search | Direct Call | AA":"R7",
"PDP | Add to Cart| Click | AA":"R8",
"Cart | Coupon | Click | AA":"R9",
"Cart | Removal | Click | AA":"R10",
"Transaction | DOM Ready | AA":"R11",
"FirstPage | LinkText | Click | FB - addToCart":"R12",
"Form Submit | Direct Call | AA":"R13",
"All Pages | Window Loaded | AA - Send Beacon":"R14",
"Video | Direct Call | AA":"R15",
"Link Click | Click | AA":"R16",
"Search | Filters | Direct Call | AA":"R17"
}
if(localStorage.getItem("ruleCompleted")){
ruleCompleted.push(localStorage.getItem("ruleCompleted"));
}
window._satellite = window._satellite || {};
window._satellite._monitors = window._satellite._monitors || [];
window._satellite._monitors.push({
ruleCompleted: function (event) {
ruleCompleted.push(ruleLookUp[event.rule.name]);
localStorage.setItem("ruleCompleted", ruleCompleted.join("|").toString());
},
ruleConditionFailed: function (event) {
ruleConditionFailed.push(ruleLookUp[event.rule.name]);
localStorage.setItem("ruleConditionFailed", ruleConditionFailed.join("|").toString());
}
});

Note:

ruleLookUp[event.rule.name] – returns rules abbreviation
join(“|”).toString() – converts array into pipe separated string to cater list props
localStorage.setItem – put rules fired after send beacon rule into local Storage

6. Now, go to your rule which sends page load beacon on every page e.g. “All Pages | Window Loaded | AA – Send Beacon”

7. Go to that rule > Actions > Set Variable – Adobe Analytics > Open Editor and paste the below snippet.

s.prop1=ruleCompleted.join("|").toString();
s.prop2=ruleConditionFailed.join("|").toString();
localStorage.removeItem("ruleCompleted");
localStorage.removeItem("ruleConditionFailed");
ruleCompleted = [];
ruleConditionFailed = [];

8. Add these changes to your library > Build and Publish it. And we are DONE from Launch configurations.

3. Adobe Analytics configurations

1. Create Classifications reports on the list props e.g. You can add/remove classification reports as per your needs.

2. Download the classification template and fill it using Tagtician export file.

3. Upload the file using Browser Import and check the reports after some time.

4. Now you can run classification reports to pull some cool insights for both prop1 & prop2

Note: This report is from sandbox account so showing very less data.

Adobe Analytics dashboards-Mobile App

I believe that you are aware that the Adobe Analytics dashboards is launched if not then the wait is over. Mobile App is launched now and it is available in Andriod and iOS. it provides anytime, anywhere insights from Adobe Analytics.

The app allows users mobile access to intuitive scorecards.

Adobe Analytics dashboards In-App Experience
Adobe Analytics dashboards Scorecard Builder

For more details check the overview and download the App,

How to Fix Referrer Data Getting Lost

Email : A referring domain is considered as an email referring domain when visitors click an emailed message link containing the protocol imap:// or mail:// and arrive at your site. For example, anything coming from https://mail.yahoo.com is not counted as an email referrer because the protocol is https://. Emails from Outlook are reported in the Typed/Bookmarked line, while any referrer with an HTTP protocol where the domain is a known search engine is reported in the Search Engine line.

Reference: https://docs.adobe.com/content/help/en/analytics/components/variables/dimensions-reports/reports-ref-types.html

When you get a email or a mobile campaign, and keep a close eye on the url window, you’ll notice the click goes to your campaign solution provider and is then redirected to your site.

That’s one example of a redirect.

That is not an issue.

Make sure they are permanent, 301, redirects. The delicious type of redirects that dutifully pass the referrer string to the landing page telling your web analytics provider where the person originally came from.

You use temporary, 302, redirects and the referrer never gets passed on. Depending on how the redirect server is configured either the click looks like it came from the redirect server or with a blank referrer (direct!).

This is particularly important for URLs that are entry points on your site, as without original referrer data, you cannot know the source of sales and conversions on your site. Anyway, on to the results.

Redirect methodBrowserResultImpact on analytics
Meta refresh – 0Firefox 3Blank referrerLost data
IE8Blank referrerLost data
Opera 9Internal referrerLost data
Javascript:location.hrefFirefox 3Internal referrerLost data
IE8Blank referrerLost data
Opera 9Internal referrerLost data
Javascript:location.replaceFirefox 3Internal referrerLost data
IE8Blank referrerLost data
Opera 9Internal referrerLost data
Server-side 301Firefox 3Original referrer
IE8Original referrer
Opera 9Original referrer
Server-side 302Firefox 3Original referrer
IE8Original referrer
Opera 9Original referrer
Server-side 301 – chainedFirefox 3Original referrer
IE8Original referrer
Opera 9Original referrer

Conclusion

While there’s nothing too unexpected in the results, it’s clear that the only way to redirect visitors and have reliable web analytics data is to use a server-side redirect. No javascript or meta-based method works, in all cases resulting in an empty or internal referrer (which will misleadingly show up as bookmark/direct in most analytics packages). Interestingly, javascript and meta redirects can result in totally blank referrer data in some browsers.

Server-side methods worked across all major browser tested, and you can get away with chaining redirects together while still keeping the referrer data.

Basic Steps To Launch setup

Steps to follow for Launch setup:

  1. Create web property in Launch
  2. Set up Host
  3. Setup environment
  4. Install extension
  5. Deploy the script in web/mobile app
  6. Capture data in context data and use processing rule to map that data into analytics variable in case of mobile
  7. Capture the data in data element and put the value of data element in analytics variable
  8. Setup Rules
  9. Send Beacon
  10. Publish the Library

Launch guide : https://docs.adobe.com/content/help/en/launch/using/overview.html

Mobile app implementation guide:https://aep-sdks.gitbook.io/docs/getting-started/create-a-mobile-property

Check this if you are planning to upgrade from DTM to Launch: https://docs.adobe.com/content/help/en/launch/using/reference/upgrade/overview.html

Adobe Analytics /Resources/Article/Post Index

Often we need to check for reference or to clear doubt what we know about Adobe Analytics. So I manage to maintain reference list in Excel for my personal use, today I thought to share this list on my blog that others can take benefit out of it too. Some of them are now outdated due to new advances in Adobe Analytics. I tried my best to give credit to actual author of the blog/article, even I tried to keep this list in order as much as possible and will keep on updating it as I come across other good reference links. Feel free to share your feedback or share the link which you want me to add in this list or do let me know if you have any questions.

Stay safe!