Difference between revisions of "ATC/Current/AdminGuide/DeployTrackingSnippet"

From Genesys Documentation
Jump to: navigation, search
(Published)
(Published)
Line 8: Line 8:
 
|sectionHeading=About the tracking snippet
 
|sectionHeading=About the tracking snippet
 
|anchor=AboutSnippet
 
|anchor=AboutSnippet
|Type=Unstructured
+
|Type=Structured
|freetext=The following code is the Altocloud tracking snippet that enables you to track visitor activity on your webpages.
+
|alignment=Vertical
 +
|structuredtext=The following code is the Altocloud tracking snippet that enables you to track visitor activity on your webpages.
  
 
<source lang="javascript">
 
<source lang="javascript">
Line 21: Line 22:
 
</script>
 
</script>
 
</source>
 
</source>
 +
|fullwidth=No
 
}}{{Section
 
}}{{Section
 
|sectionHeading=Prerequisites
 
|sectionHeading=Prerequisites
 
|anchor=prerequisites
 
|anchor=prerequisites
|Type=Unstructured
+
|Type=Structured
|freetext=In order to deploy the Altocloud tracking snippet on your website, you will need:
+
|alignment=Vertical
 +
|structuredtext=In order to deploy the Altocloud tracking snippet on your website, you will need:
 
* Your organization ID. Use your organization ID v<span>alue to replace ''''YOUR-ORGANIZATION-ID'''' in the '''ac('init')''' function. </span>
 
* Your organization ID. Use your organization ID v<span>alue to replace ''''YOUR-ORGANIZATION-ID'''' in the '''ac('init')''' function. </span>
 
* Your organization region. Look up the '''datacenter''' value in [https://all.docs.genesys.com/ATC/Draft/Developers/Regions Altocloud Regions] and replace ''''YOUR-ORGANIZATION-REGION'''' with the corresponding datacenter in the '''ac('init')''' function. If you do not know which region your organization is in, contact [mailto:customercare@genesys.com customercare@genesys.com]
 
* Your organization region. Look up the '''datacenter''' value in [https://all.docs.genesys.com/ATC/Draft/Developers/Regions Altocloud Regions] and replace ''''YOUR-ORGANIZATION-REGION'''' with the corresponding datacenter in the '''ac('init')''' function. If you do not know which region your organization is in, contact [mailto:customercare@genesys.com customercare@genesys.com]
 +
|fullwidth=No
 
}}{{Section
 
}}{{Section
 
|sectionHeading=Use a tag management system
 
|sectionHeading=Use a tag management system

Revision as of 21:20, December 10, 2018

Deploy the Altocloud tracking snippet to enable visitor tracking on your website.

About the tracking snippet

The following code is the Altocloud tracking snippet that enables you to track visitor activity on your webpages.

<script>
(function(a,t,c,l,o,u,d){a['_genesysJourneySdk']=o;a[o]=a[o]||function(){
(a[o].q=a[o].q||[]).push(arguments)},a[o].l=1*new Date();u=t.createElement(c),
d=t.getElementsByTagName(c)[0];u.async=1;u.src=l;d.parentNode.insertBefore(u,d)
})(window, document, 'script', 'https://app.genesys.cloud/journey/sdk/js/web/v1/ac.js', 'ac');
ac('init', 'YOUR-ORGANIZATION-ID', { datacenter: 'YOUR-ORGANIZATION-REGION' });
ac('pageview');
</script>

Prerequisites

In order to deploy the Altocloud tracking snippet on your website, you will need:

  • Your organization ID. Use your organization ID value to replace 'YOUR-ORGANIZATION-ID' in the ac('init') function.
  • Your organization region. Look up the datacenter value in Altocloud Regions and replace 'YOUR-ORGANIZATION-REGION' with the corresponding datacenter in the ac('init') function. If you do not know which region your organization is in, contact customercare@genesys.com

Use a tag management system

To easily deploy the tracking snippet, use a tag management system such as Google Tag Manager, Tealium, Adobe, and any others that provide the option to add custom JavaScript code.

Use the Admin UI

The Altocloud Admin UI also provides a way to copy and paste the tracking snippet.

  1. Copy and paste the code from this article, or go to Settings> Account Settings.
  2. On the Tracking Code tab, copy the code.
  3. Paste the tracking snippet in the element of the website template page before the closing tag.
  4. Supply your organization ID and your Genesys data center.
Important
  • Do not load the Altocloud tracking snippet unless the visitor provides consent to be tracked. For an example of how to do this, see [[ATC/Current/Developers/GDPRReqs|]].
  • The last argument in the Altocloud tracking snippet is 'ac'. If your webpage or any third-party JavaScript uses this variable name globally, pass a custom value.
  • When you call `ac`, the commands after it, such as init, pageview, and so on, are queued. When the website template file is completely downloaded, the queued commands are executed.
Comments or questions about this documentation? Contact us for support!