Developers
Accelerated Mobile Pages (AMP) is a way to build web pages for static content that render fast. AMP includes an amp-analytics
element that allows you to track user interactions with AMP pages. To learn more about analytics for AMP pages see the amp-analytics reference. For general information about AMP see What Is AMP? on the Accelerated Mobile Pages (AMP) Project site.
amp-analytics
is an extended component and must be explicitly included into the document as a custom element to use it. To add AMP analytics functionality to your page:
Include this script in the <head>
, before the AMP JS library:
<script async custom-element="amp-analytics"
src="https://cdn.ampproject.org/v0/amp-analytics-0.1.js"></script>
<amp-analytics type="mparticle" id="analytics1">
...
</amp-analytics>
amp-analytics
element to the body of your page and set the type attribute of the amp-analytics
element to mparticle
. id
attribute so that you can easily identify each amp-analytics
element (e.g. debugging).The following trigger request values are supported for the mParticle configuration:
Page tracking allows you to measure the number of views you had for a particular page on your website. Pageview hits can be sent by setting the trigger request
value to pageview
.
<amp-analytics type="mparticle" id="analytics1">
<script type="application/json">
{
"vars": {
"apiKey": "Your mParticle API Key"
},
"triggers": {
"trackPageview": {
"on": "visible",
"request": "pageview"
}
}
}
</script>
</amp-analytics>
You can set key-value pairs for the following pageview fields in the vars attribute of the trigger.
Value | Default Value | Required | Description |
---|---|---|---|
title | Defaults to title | no | The title of the page. |
ampdocUrl | Defaults to ampdocUrl | no | URL of the page being tracked. |
The following example overrides the default pageview values for title and ampdocUrl:
<amp-analytics type="mparticle" id="analytics2">
<script type="application/json">
{
"vars": {
"apiKey": "Your mParticle API Key"
},
"triggers": {
"trackPageviewWithAmpdocUrl": {
"on": "visible",
"request": "pageview",
"vars": {
"title": "Custom Title",
"ampdocUrl": "http://www.example.com"
}
}
}
}
</script>
</amp-analytics>
Events are user interactions with content that can be tracked independently from a web page or a screen load. Event hits can be sent by setting the trigger request
value to event
and providing additional event properties.
The following example uses the selector
attribute of the trigger to send an event when a particular element is clicked.
<amp-analytics type="mparticle" id="analytics3">
<script type="application/json">
{
"vars": {
"apiKey": "AppKey"
},
"triggers": {
"trackAppEvent": {
"on": "click",
"selector": "#test1",
"request": "event",
"vars": {
"eventName": "AMP Test 1 button clicked",
"eventType": "Unknown",
"eventAttributes_Keys": ["test key1","test key2"],
"eventAttributes_Values": ["test value1","test value2"],
"userAttributes_Keys": ["test user attr key1","test user attr key2"],
"userAttributes_Values": ["test user attr value1","test user attr value2"],
"userIdentities_Types" : ["facebook", "twitter"],
"userIdentities_Values" : ["example@facebook.com", "@example"],
"debug": "true",
"location": [26.4619396, -80.0691996],
"customFlags_Keys": ["custom flag1", "custom flag2"],
"customFlags_Values": ["[100, 200]", "[test val1, test val2]"],
"appVersion": "1.0"
}
}
}
}
</script>
</amp-analytics>
You can set key-value pairs for the following event fields in the vars attribute of the trigger.
Value | Default Value | Required | Description |
---|---|---|---|
eventName | no | The name of the event. | |
eventType | “Unknown” | no | The type of event. The supported event types are listed here. |
eventAttributes_Keys | no | An array of event attribute keys. | |
eventAttributes_Values | no | An array of event attribute values, corresponding to the eventAttributes_Keys. | |
userAttributes_Keys | no | An array of user attribute keys. | |
userAttributes_Values | no | An array of user attribute values, corresponding to the userAttributes_Keys. | |
userIdentities_Types | no | An array of user identities. | |
userAttributes_Values | no | An array of user identity values, corresponding to the userIdentities_Types. | |
debug | “false” | no | Set the debug flag to “true” to indicate development data or to “false” to indicate production data. |
location | no | The location where the event occurred represented as [lat,long] | |
customFlags_Keys | no | An array of custom flags. | |
customFlags_Values | no | An array of custom flag values, corresponding to the customFlags_Keys. | |
appVersion | no | Your application version. |
Was this page helpful?