Application collectors
Javascript Collector
The Javascript collector by Datazoom is an easy to install SDK for your Javascript collector applications that makes the following data points automatically collectable in real time. The collector can also be configured to make the data points from the media player extensions listed below automatically collectable.
Features
Configurable App Session Timeout
Sampling
Data Points
Events
Discrete occurrences driven by user interactions or system actions
Metadata
Device
Network
Location
Custom
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
Datazoom Loaded
Signifies that the Datazoom SDK has been loaded and activated.
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.
| 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.
| Data type |
string
|
| Number Type |
Not set
|
ISP
Name of the end user's internet service provider.
| Data type |
string
|
| Number Type |
Not set
|
Mobile Connection
Whether the user is on a mobile connection as determined by their IP address.
| 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.
| 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.
| Data type |
string
|
| Number Type |
Not set
|
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
| Data type |
string
|
| Number Type |
Not set
|
Browser Height
The height of the end user's browser window at the time the event occurred.
| Data type |
number
|
| Number Type |
Long
|
| Unit |
pixels
|
Browser Name
Name of the web browser according to the user agent
| Data type |
string
|
| Number Type |
Not set
|
Browser Version
Version of the web browser according to the user agent
| Data type |
string
|
| Number Type |
Not set
|
Browser Width
The width of the end user's browser window at the time the event occurred.
| Data type |
number
|
| Number Type |
Long
|
| Unit |
pixels
|
Cookies Enabled
Does the user's browser have cookies enabled?
| 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
| 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 Type
The type of the user's device
| Data type |
string
|
| Number Type |
Not set
|
| Required |
true
|
| Permitted Values |
value list
|
OS Name
The name of the operating system of the user's device.
| Data type |
string
|
| Number Type |
Not set
|
OS Version
The version of the operating system of the user's device.
| Data type |
string
|
| Number Type |
Not set
|
User
App Session ID
Datazoom generated UUID for the user's Datazoom session.
| Data type |
string
|
| Number Type |
Not set
|
| Required |
true
|
App Session Start Timestamp
Start time of the Datazoom app session
| Data type |
number
|
| Number Type |
Long
|
| Unit |
milliseconds
|
Client IP Address
Public IP address of the end user's device
| 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.
| Data type |
string
|
| Number Type |
Not set
|
Location
City
The city or town where the user is located
| 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.
| 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.
| 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
| 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 .
| 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.
| 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
| 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
| 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
| 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.
| 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.
| 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.
| 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.
| 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
| 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.
| 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.
| 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.
| Number Type |
Not set
|
Page
Page Title
The title property of the web page.
| Data type |
string
|
| Number Type |
Not set
|
Page URL
The address of the web page.
| 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.
| Data type |
string
|
| Number Type |
Not set
|
| Permitted Values |
URL
|
Site Domain
The domain of the site.
| 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.
| Device Platforms |
Browser,Console,DTV,Mobile
|
Event Count
Count of events in an app session.
| Device Platforms |
Browser,Console,DTV,Mobile
|
| Required |
true
|
Media Players
Shaka Player
Dailymotion Player
EX․CO Player
Dolby Millicast
IVS Player
Dash.js Player
HLS.js Player
JW Player
AWS IVS Player
Kaltura
Chromecast
THEOplayer
Brightcove
Bitmovin (Javascript)
Gen 2 -- Akamai AMP (Javascript)
HTML5 Media Player
Video.js Player
TBD integration instructions