Data dictionaries
Application Data Dictionary
Along with any custom event or custom metadata you want to capture, Datazoom Application Collectors make the following events, metadata and fluxdata automatically collectable, known as the Datazoom Application Data Dictionary.
The Application Data Dictionary can be extended with the Media Player Data Dictionary and Ad Framework Data Dictionary.
Overview
Events
Discrete occurrences driven by user interactions or system actions
Metadata
Attributes describing the context of an event
Custom
Device
Location
Network
Events
Custom Event
Add any event to the Datazoom data stream. Requires customer to implement a Datazoom method into their app. https://help.datazoom.io/hc/en-us/articles/360059000311-Sending-Custom-Events-and-Custom-Metadata
| Supported Collectors | 4 |
Datazoom Loaded
Signifies that the Datazoom SDK has been loaded and activated.
| Supported Collectors | 4 |
Metadata
Network
ASN
Autonomous System Number: a unique number identifying a group of IP networks that serves the content to the end-user. Client ASN as determined from a lookup of the client IP.
| Supported Collectors | 4 |
| Data type |
string
|
| Number Type |
Not set
|
ASN Org
The organization that owns the Autonomous System Number. Often an ISP, sometimes a private company or institution.
| Supported Collectors | 4 |
| Data type |
string
|
| Number Type |
Not set
|
ISP
Name of the end user's internet service provider.
| Supported Collectors | 4 |
| Data type |
string
|
| Number Type |
Not set
|
Mobile Connection
Whether the user is on a mobile connection as determined by their IP address.
| Supported Collectors | 4 |
| Data type |
bool
|
| Number Type |
Not set
|
| Notes |
This value is ideal to utilize when enforcing content rights: any player identified within a specific country can be blocked from accessing the content. Note that proxy servers can be used by viewers to make their request appear to be originating from an approved country. Matching the countryCode received during a request to the country specified in the subscriber's profile information can help mitigate proxy use.
|
| Permitted Values |
value list
|
Device
Ad Blocker
Whether an ad blocker was detected or not. Web only.
| Supported Collectors | 4 |
| Data type |
bool
|
| Number Type |
Not set
|
| Permitted Values |
value list
|
Ad ID
An ad server-defined identifier for the ad. To collect this data point, Datazoom collectors require ad framework integration unless media player supports ad framework natively.
| Supported Collectors | 4 |
| Data type |
string
|
| Number Type |
Not set
|
Ad Tracking Opt Out
Whether the user has opted out of advertising tracking on their device.
| Supported Collectors | 3 |
| Data type |
bool
|
| Number Type |
Not set
|
| Permitted Values |
value list
|
Advertising ID
Advertising ID depends on the device platform: -- Apple: IDFA (https://developer.apple.com/documentation/adsupport/asidentifiermanager/advertisingidentifier) -- Android: AAID (https://developers.google.com/android/reference/com/google/android/gms/ads/identifier/AdvertisingIdClient) -- Roku: RIDA (https://developer.roku.com/en-gb/docs/developer-program/advertising/roku-advertising-framework.md) -- Javascript: depends on device platform
| Supported Collectors | 4 |
| Data type |
string
|
| Number Type |
Not set
|
Browser Height
The height of the end user's browser window at the time the event occurred.
| Supported Collectors | 1 |
| Data type |
number
|
| Number Type |
Long
|
| Unit |
pixels
|
Browser Name
Name of the web browser according to the user agent
| Supported Collectors | 1 |
| Data type |
string
|
| Number Type |
Not set
|
Browser Version
Version of the web browser according to the user agent
| Supported Collectors | 1 |
| Data type |
string
|
| Number Type |
Not set
|
Browser Width
The width of the end user's browser window at the time the event occurred.
| Supported Collectors | 1 |
| Data type |
number
|
| Number Type |
Long
|
| Unit |
pixels
|
Cookies Enabled
Does the user's browser have cookies enabled?
| Supported Collectors | 1 |
| Data type |
bool
|
| Number Type |
Not set
|
| Permitted Values |
value list
|
Device ID
Unique identifier of the user's device. -- Javascript: DZ generated UUID-V4 -- iOS / tvOS: IDFV (identifierForVendor) -- Android: DeviceID -- Roku: ChannelClientID
| Supported Collectors | 4 |
| Data type |
string
|
| Number Type |
Not set
|
| Notes |
Javascript: persists in the browser’s localStorage and is reused in different app sessions on the same browser. When the Device Id data point is deselected in the data pipe, data is deleted from the browser's localStorage.
iOS / tvOS: IDFV is assigned to all apps by one vendor. It does not persist once all vendor apps are uninstalled.
Android: randomly hex string generated on first boot and persists for the lifetime of the device.
Roku: a combination of deviceInfo and channel (i.e., app) info and is unique for that device/app combination. Not affected by opting out.
|
Device Manufacturer
Manufacturer of the user's device.
| Supported Collectors | 3 |
| Data type |
string
|
| Number Type |
Not set
|
Device Name
Name of the user's device model
| Supported Collectors | 3 |
| Data type |
string
|
| Number Type |
Not set
|
Device Type
The type of the user's device
| Supported Collectors | 4 |
| Data type |
string
|
| Number Type |
Not set
|
| Required |
true
|
| Permitted Values |
value list
|
Orientation
Whether the user's mobile device is in portrait or landscape mode.
| Supported Collectors | 3 |
| Data type |
string
|
| Number Type |
Not set
|
| Permitted Values |
value list
|
OS Name
The name of the operating system of the user's device.
| Supported Collectors | 4 |
| Data type |
string
|
| Number Type |
Not set
|
OS Version
The version of the operating system of the user's device.
| Supported Collectors | 4 |
| Data type |
string
|
| Number Type |
Not set
|
User
App Session ID
Datazoom generated UUID for the user's Datazoom session.
| Supported Collectors | 4 |
| Data type |
string
|
| Number Type |
Not set
|
| Required |
true
|
App Session Start Timestamp
Start time of the Datazoom app session
| Supported Collectors | 4 |
| Data type |
number
|
| Number Type |
Long
|
| Unit |
milliseconds
|
Client IP Address
Public IP address of the end user's device
| Supported Collectors | 4 |
| Data type |
string
|
| Number Type |
Not set
|
| Permitted Values |
IP address
|
User Agent
For web collectors, this is the browser's defined string for user agent. For application collectors, Datazoom composes a psuedo-user agent that contains a number of tokens that refer to aspects of the user device.
| Supported Collectors | 4 |
| Data type |
string
|
| Number Type |
Not set
|
Location
City
The city or town where the user is located
| Supported Collectors | 4 |
| Data type |
string
|
| Number Type |
Not set
|
| Notes |
When aggregated with other player sessions, this can provide a definitive number of viewers within a city. This can be helpful when targeting local advertising.
|
Continent
The name of the continent from which the event originated based on the user's IP address.
| Supported Collectors | 4 |
| Data type |
string
|
| Number Type |
Not set
|
| Notes |
This value is ideal to utilize when enforcing content rights: any player identified within a specific country can be blocked from accessing the content. Note that proxy servers can be used by viewers to make their request appear to be originating from an approved country. Matching the countryCode received during a request to the country specified in the subscriber's profile information can help mitigate proxy use.
|
Continent Code
The continent from which the event originated based on the user's IP address.
| Supported Collectors | 4 |
| Data type |
string
|
| Number Type |
Not set
|
| Notes |
This value is ideal to utilize when enforcing content rights: any player identified within a specific country can be blocked from accessing the content. Note that proxy servers can be used by viewers to make their request appear to be originating from an approved country. Matching the countryCode received during a request to the country specified in the subscriber's profile information can help mitigate proxy use.
|
| Permitted Values |
2 letter code
|
Country
Full name of the user's country
| Supported Collectors | 4 |
| Data type |
string
|
| Number Type |
Not set
|
| Notes |
For content rights that have global distribution, country is often the value most used to enforce access making it relatively easy to blacklist and/or whitelist certain countries.
|
Country Code
The country from which the browser initiated the event. For a list of country codes, see ISO 3166-1 alpha-2 .
| Supported Collectors | 4 |
| Data type |
string
|
| Number Type |
Not set
|
| Notes |
This value is ideal to utilize when enforcing content rights: any player identified within a specific country can be blocked from accessing the content. Note that proxy servers can be used by viewers to make their request appear to be originating from an approved country. Matching the countryCode received during a request to the country specified in the subscriber's profile information can help mitigate proxy use.
|
| Permitted Values |
2 letter code
|
District
The district, subdivision of city from where the event originated as determined by the user's IP address.
| Supported Collectors | 4 |
| Data type |
string
|
| Number Type |
Not set
|
| Notes |
This value is ideal to utilize when enforcing content rights: any player identified within a specific country can be blocked from accessing the content. Note that proxy servers can be used by viewers to make their request appear to be originating from an approved country. Matching the countryCode received during a request to the country specified in the subscriber's profile information can help mitigate proxy use.
|
Latitude
Location information for the user
| Supported Collectors | 4 |
| Data type |
number
|
| Number Type |
Float
|
| Unit |
degrees
|
| Notes |
When used in conjunction with longitude, this can provide an exact location for the viewer.
|
Longitude
Location information for the user
| Supported Collectors | 4 |
| Data type |
number
|
| Number Type |
Float
|
| Unit |
degrees
|
| Notes |
When used in conjunction with latitude, this can provide an exact location for the viewer.
|
Postal Code
The specific administrative division within a country where the event occurred. In the United States, zip codes correspond to postal region locator
| Supported Collectors | 4 |
| Data type |
string
|
| Number Type |
Not set
|
| Notes |
When aggregated with other player sessions, this can provide a definitive number of viewers within a specific area of a city. This can be helpful when targeting local advertising.
|
Region
The specific administrative division within a country where the event occurred. In the United States, regions correspond to state names ; for example, Washington or New York.
| Supported Collectors | 4 |
| Data type |
string
|
| Number Type |
Not set
|
| Notes |
This is the full form of the regionCode (i.e., Florida instead of FL). As a result, this value is often used for display purposes, rather than programmatically. If the fullname of a country region is needed, pulling this field is more efficient than employing memory or CPU to programmatically match the regionCode to a region name.
|
Region Code
The specific administrative division within a country where the event occurred. In the United States, regions correspond to state abbreviations; for example, WA or NY but in other countries the region code may be represented by numbers or some other identifier.
| Supported Collectors | 4 |
| Data type |
string
|
| Number Type |
Not set
|
| Notes |
Like the countryCode, this value can be used to enforce content rights, especially when those rights are tied to only certain regions within a country. For example, a sporting event on the West Coast of the U.S. may not be available on the East Coast of the U.S., therefore all states on the East Coast (NY, FL, NH, etc.) would be blocked from content access.
|
Timezone Name
The name of the user's timezone where the event originated based on their IP address.
| Supported Collectors | 4 |
| Data type |
string
|
| Number Type |
Not set
|
| Notes |
This value is ideal to utilize when enforcing content rights: any player identified within a specific country can be blocked from accessing the content. Note that proxy servers can be used by viewers to make their request appear to be originating from an approved country. Matching the countryCode received during a request to the country specified in the subscriber's profile information can help mitigate proxy use.
|
Timezone Offset
The difference in hours, relative to UTC, of the user's timezone.
| Supported Collectors | 4 |
| Data type |
number
|
| Number Type |
Float
|
| Unit |
hours
|
| Notes |
This value is ideal to utilize when enforcing content rights: any player identified within a specific country can be blocked from accessing the content. Note that proxy servers can be used by viewers to make their request appear to be originating from an approved country. Matching the countryCode received during a request to the country specified in the subscriber's profile information can help mitigate proxy use.
|
System
Configuration ID
Datazoom generated identifier for the collector configuration
| Supported Collectors | 4 |
| Data type |
string
|
| Number Type |
Not set
|
| Notes |
Allows customers to differentiate data on the Connector from different Collectors (e.g., could be useful for separating test content from production data).
|
| Required |
true
|
| Permitted Values |
UUID
|
DZ SDK Version
Version number of the Datazoom SDK that generated the event message.
| Supported Collectors | 4 |
| Data type |
string
|
| Number Type |
Not set
|
| Required |
true
|
Event ID
Unique identifier for each event message fired by a Collector or log file received by Datazoom. The string includes an incremental counter at the end to allow for sequencing the events from a user session.
| Supported Collectors | 4 |
| Data type |
string
|
| Number Type |
Not set
|
| Required |
true
|
Custom
Custom Metadata
Customers can add any user or system data to the Datazoom data stream. Requires custom coding on the page or in the app by customer developer.
| Supported Collectors | 4 |
| Number Type |
Not set
|
Page
Page Title
The title property of the web page.
| Supported Collectors | 1 |
| Data type |
string
|
| Number Type |
Not set
|
Page URL
The address of the web page.
| Supported Collectors | 1 |
| Data type |
string
|
| Number Type |
Not set
|
| Permitted Values |
URL
|
Referrer URL
The URL of the page the user from which the user navigated before coming to the active page.
| Supported Collectors | 1 |
| Data type |
string
|
| Number Type |
Not set
|
| Permitted Values |
URL
|
Site Domain
The domain of the site.
| Supported Collectors | 1 |
| Data type |
string
|
| Number Type |
Not set
|
FluxData
Engagement Duration
Cumulative time of the app session. Event timestamp minus the timestamp of the app session start minus background time.
| Supported Collectors | 4 |
| Device Platforms |
Browser,Console,DTV,Mobile
|
Event Count
Count of events in an app session.
| Supported Collectors | 4 |
| Device Platforms |
Browser,Console,DTV,Mobile
|
| Required |
true
|