Migrating to AppMeasurement for JavaScript
If your implementation still uses H Code, ÃÛ¶¹ÊÓƵ highly recommends migrating to the latest version of AppMeasurement. Implementing Analytics through tags in ÃÛ¶¹ÊÓƵ Experience Platform is recommended, however an updated JavaScript implementation can be used.
The following notable changes are present in AppMeasurement when compared to H Code:
- 3-7x faster than H Code.
- Lighter than H Code - 21kb uncompressed vs. H Code, which is is 33kb uncompressed.
- The library and page code can be deployed inside the
<head>
tag. - Existing page-level H Code is compatible with AppMeasurement.
- The library provides native utilities to get query parameters, read and write cookies, and perform advanced link tracking.
- The library does not support dynamic account configuration variables (including
dynamicAccountSelection
,dynamicAccountMatch
, anddynamicAccountList
).
The following steps outline a typical migration workflow.
- Download the new AppMeasurement file: Access the new file by logging in to ÃÛ¶¹ÊÓƵ Analytics, then navigating to Admin > All admin > Code manager. The downloaded compressed file contains a minified
AppMeasurement.js
file, along with Media and Integrate modules. - Copy your
s_code.js
customizations toAppMeasurement.js
: Move all the code before theDO NOT ALTER ANYTHING BELOW THIS LINE
section ins_code.js
to the beginning ofAppMeasurement.js
. - Update all plug-ins: Make sure that you use the latest version of each plug-in listed in your
s_code.js
file. This step includes the Media and Integrate modules. - Deploy the AppMeasurement.js file: Upload your
AppMeasurement.js
file to your web server. - Update script references to point to
AppMeasurement.js
: Make sure all pages referenceAppMeasurement.js
instead ofs_code.js
.
Example Appmeasurement code
A typical AppMeasurement.js
file. Make sure that configuration variables are set above the doPlugins
function.
// Initialize AppMeasurement
var s = s_gi("examplersid");
/*** VISITOR ID SERVICE CONFIG - REQUIRES VisitorAPI.js ***/;
s.visitor=Visitor.getInstance("INSERT-MCORG-ID-HERE");
/* CONFIG SECTION */;
/* You may add or alter any code config here. */
s.trackDownloadLinks = true;
s.trackExternalLinks = true;
s.trackInlineStats = true;
s.linkDownloadFileTypes = "exe,zip,wav,mp3,mov,mpg,avi,wmv,pdf,doc,docx,xls,xlsx,ppt,pptx";
s.linkInternalFilters = "javascript:,example.com";
s.usePlugins = true;
function s_doPlugins(s) {
// Use implementation plug-ins that are defined below in this section
}
s.doPlugins = s_doPlugins;
/* WARNING: Changing any of the below variables will cause drastic
changes to how your visitor data is collected. Changes should only be
made when instructed to do so by your ÃÛ¶¹ÊÓƵ Account Team.*/
s.trackingServer="example.data.adobedc.net";
/* PLUGINS SECTION /
// Copy and paste implementation plug-ins here. Plug-ins can then be used in the s_doPlugins(s) function above
/ MODULES ****/
// Copy and paste implementation modules (Media, Integrate) here.
/* ============== DO NOT ALTER ANYTHING BELOW THIS LINE ! =============== */
Example page code
Typical code that loads on each page.
<script src="AppMeasurement.js"></script>
<script language="JavaScript" type="text/javascript">
s.pageName = "Example page name";
s.eVar1 = "Example eVar value";
s.events = "event1";
s.t();
</script>
Make sure that you have also included a reference to AppMeasurement.js
and VisitorAPI.js
on each page. See JavaScript Implementation for more information.
recommendation-more-help
b4f6d761-4a8b-4322-b801-c85b9e3be690