Learn how to implement Google Analytics tracking in your Display

Overview

Google Analytics tracking is configurable on a license-level: the same Google Analytics Tracking ID will be applied to all your Display instances in the same license, once configured.

Events

All events are tracked to the iPaper Display category in the following format:

Event name Interactive 1 Data 2 Comments
Load No
{
  Url: [DISPLAY_URL]
}
Time Spent No
{
  Duration: [DURATION_IN_SECONDS]
}
Button Click Yes
{
  Url: [BUTTON_ENTITY_ACTION_URL]
}
Image Click Yes
{
  Url: [IMAGE_ENTITY_ACTION_URL]
}
Product Click Yes
{
  Id: [PRODUCT_ENTITY_PRODUCT_ID],
  Url: [PRODUCT_ENTITY_PRODUCT_URL]
}
Video Click Yes
{
  Url: [VIDEO_ENTITY_ASSET_URL]
}
Only available for autoplaying video
Video Start Yes
{
  Url: [VIDEO_ENTITY_ASSET_URL]
}
Only available for non-autoplaying video. Fires once per video entity, when a user manually plays video.
Video Played 25 Percent Yes
{
  Url: [VIDEO_ENTITY_ASSET_URL]
}
Only available for non-autoplaying video. Fires once per video entity, once the timestamp of a video exceeds the stated percentage of its total duration.
Video Played 50 Percent Yes
{
  Url: [VIDEO_ENTITY_ASSET_URL]
}
Video Played 75 Percent Yes
{
  Url: [VIDEO_ENTITY_ASSET_URL]
}
Video Played 100 Percent Yes
{
  Url: [VIDEO_ENTITY_ASSET_URL]
}

Interactive flag

There are some events that we want to mark as non-interactive (or “non-interaction events” by Google Analytics’ definition). This will mean that even if these events are fired, the session will be considered as bounced if the user does not further interact with the page.

Event labels

The data format below is represented in JSON. It is converted to a string for the eventLabel object using the following convention:

  • Key names are PascalCased
  • Key-value pairs are separated by the pipe character |

Example:

{
  Id: [PRODUCT_ENTITY_PRODUCT_ID],
  Url: [PRODUCT_ENTITY_PRODUCT_URL]
}

…is converted into:

Id: [PRODUCT_ENTITY_PRODUCT_ID] | Url: [PRODUCT_ENTITY_PRODUCT_URL]