Redirect offers - A4T FAQ
This topic contains answers to questions that are frequently asked about using redirect offers when using Analytics as the reporting source for Target (A4T).
Does Analytics for Target (A4T) support redirect offers?
Yes, provided that your implementation uses at.js. However, your implementation must meet the minimum requirements listed below in order to use redirect offers in activities that use Analytics as the reporting source.
What are the minimum requirements needed to use redirect offers with A4T?
Your implementation must meet the following minimum requirements:
- Experience Cloud Visitor ID Service: visitorAPI.js version 2.3.0 or later.
- Adobe Analytics: appMeasurement.js version 2.1.
- Adobe Target: at.js version 1.6.2 or later.The mbox.js library does not support redirect offers with A4T. Your implementation must use at.js.
The three libraries must be included on both the page with the redirect offer and the page to which the visitor is redirected.
Why are there sometimes data discrepancies between A4T and Analytics?
Some data discrepancies are expected. For more information, see Expected data variances between Target and Analytics when using and not using A4T.
Why are page views on the original page and on the redirect page sometimes counted?
There is a possibility that a race condition can occur that might cause the Analytics call to fire before the redirect executes on the first page. This can cause page views on the original page and on the redirect page to all be counted. This situation results in an extra page view on the first page, when the visitor never really "saw" this first page.
Using the form-based composer to build a redirect activity is recommended to increase the speed of the page redirect. This is because of where the code gets executed on the page. Also, creating a redirect offer for every experience, even the default experience, where the redirect would return the original page is recommended. This ensures that if mis-counting occurs, it happens across all experiences so reporting and analysis is still valid for the test.
This race condition affects only customers using at.js version 1.6.3 or earlier. Be aware that the Target team maintains only two versions of at.js—the current version and the second-latest version. Please upgrade at.js as necessary to ensure that you are running a supported version.
For more information about this issue, see the "Redirect offers" column in the Known Issues table.
The mbox.js library does not support redirect offers with A4T. Your implementation must use at.js.
Are both the Visual Experience Composer (VEC) and Form-Based Experience Composer supported?
Yes, both composers are supported as long as you use the built-in redirect offers.
If you use your own custom code for the redirect, you must ensure that you populate the two new parameters associated with redirect URLs ( adobe_mc_sdid and adobe_mc_ref, explained below).
What are the new query string parameters added to the redirect URLs?
The following query string parameters are associated with redirect offers:
The adobe_mc_sdid parameter passes the Supplemental Data Id (SDID) and Experience Cloud Org Id from the default page to the new page in order for A4T to "stitch" together the Target request on the default page with the Analytic request on the new page.
The adobe_mc_ref parameter passes the referring URL of the default page to the new page. When used with AppMeasurement.js version 2.1 (or later), Analytics will use this parameter value as the referring URL on the new page.
These parameters are automatically added to the redirect URLs when using the built-in redirect offers in the VEC and Form-Based Experience Composer when the Visitor Id service is implemented on the page. If you are using your own custom redirect code in the VEC or Form-Based Composer, you must be sure to pass these parameters with your custom code.
My web servers are stripping these parameters from my URLs, what should I do?
You will need to work with your IT team to have these parameters ( adobe_mc_sdid and adobe_mc_ref) whitelisted.
What if I am not using A4T with my redirect activity and don't want to have these extra parameters added to my URLs?
If you are not using A4T with your redirect activity, you have the Visitor Id service implemented, and you don't want these parameters to be automatically added to your URLs, you must use a custom-coded redirect.
However, as best practice, you might want to keep the adobe_mc_ref parameter in the URL in order to report the referrer information to Analytics correctly.
Why are the adobe_mc_ref and adobe_mc_sdid parameters double URL encoded in my implementation?
If you use A4T and redirect offers, Target appends the adobe_mc_ref and adobe_mc_sdid parameters to the URL. These values are already URL encoded. Most of the time everything works as expected, however, some customers might have load balancers or WEB servers that try to encode the query string parameters one more time.
Because of this double encoding when the Visitor API tries to decode the adobe_mc_sdid value, it can't extract the SDID value and generates a new SDID. This leads to incorrect SDID values being sent to Target and Analytics and you'll see uneven split for redirects in Analytics reports.
We recommend that you talk to their IT team to ensure that adobe_mc_ref and adobe_mc_sdid are white-listed so that these values are not transformed in any way.
Why does the referring URL need to be passed to the new page?
Suppose a visitor clicks a link on `www.google.com` to your homepage ( [www.mysite.com/index.html]) on which a redirect activity is live and is then redirected to a new page ( `www.mysite.com/index2.html`).
Previously, the Analytics request on the new page would report a referring URL of `www.mysite.com/index.html` instead of `www.google.com`. This caused inaccurate reporting in Analytics associated with the referring URLs (Marketing Channel reports, for example). The reports had lost the fact that you came to the site from `www.google.com`.
With at.js version 0.9.6 (or later) and AppMeasurement.js 2.1 (or later), the Analytics request on the new page will report a referring URL of `www.google.com`.
Can I use custom/HTML redirect offers?