Events
Custom Event
event
Released in version 1.111
Definition: Add any user or system behavioral event to the Datazoom data stream. Requires custom coding on the page or in the app by customer developer.
Technical Name: {custom_event_name}
Applicable for: Ad, Content, Live, VOD
Node Location: event.type
Max Decimals: 0
Datazoom Loaded
event
Released in version 1.92
Definition: Signifies that the Datazoom SDK has been loaded and activated. At this point, the video player can be instantiated or custom events can be sent by the application.
Technical Name: datazoom_loaded
Applicable for:
Node Location: event.type
Max Decimals: 0
Heartbeat
event
Released in version 1.105
Definition: Periodic event that provides updated insight into all of the selected FluxData metrics fired at the specified Heartbeat interval.
Technical Name: heartbeat
Applicable for: Content, Live, VOD, Ad
Node Location: event.type
Max Decimals: 0
Media Loaded
event
Released in version 1.111
Definition: Fired when the video is fully loaded into the player & ready to begin playback.
Technical Name: media_loaded
Applicable for: Content, Live, VOD, Ad
Node Location: event.type
Max Decimals: 0
Qualified View
event
Released in version 1.99
Definition: This event is fired when the user has watched a specified duration of video playback.
Technical Name: qualified_view
Applicable for: Content, Live, VOD
Node Location: event.type
Max Decimals: 0
Event Attributes
Heartbeat Count
metadata
Released in version 1.105
Definition: Incremental tracker identifying the order of Heartbeat events from the Collector.
Technical Name: heartbeat_count
Applicable for: Content, Live, VOD
Field Type: number
Node Location: event.attributes
Permitted Values: any
Example Value: 1
Unit: count
Max Decimals: 0
Message Metadata
Configuration ID
metadata
Released in version 1.111
Definition: Datazoom Collector configuration ID. Allows customers to differentiate data on the Connector from different Collectors. This could be useful for separating test content from production data.
Technical Name: configuration_id
Applicable for: Ad, Content, Live, VOD
Field Type: string
Node Location: root
Permitted Values: UUID
Example Value: 3bba4192-8105-4498-ae34-587154d56fa6
Max Decimals: 0
Event ID
metadata
Released in version 1.92
Definition: 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.
Technical Name: event_id
Applicable for: Ad, Content, Live, VOD
Field Type: string
Node Location: root
Permitted Values: any
Example Value: ddee8570-3dd5-4cfa-aeac-04d694c4c22a_00.00001
Max Decimals: 0
User Details
App Session ID
metadata
Released in version 1.92
Definition: Unique identifier for the user's current Datazoom session. Session will persist as long as the user is viewing content uninterrupted. A 20 minute pause in activity will close the session.
Technical Name: app_session_id
Applicable for: Ad, Content, Live, VOD
Field Type: string
Node Location: user_details
Permitted Values: any
Example Value: 43DHE-EROILKER-EREOATE
Max Decimals: 0
Client IP Address
metadata
Released in version 1.92
Definition: IP address of the user's device
Technical Name: client_ip
Applicable for: Ad, Content, Live, VOD
Field Type: string
Node Location: user_details
Permitted Values: IP address
Example Value: 173.19.65.222
Max Decimals: 0
Content Session ID
metadata
Released in version 1.111
Definition: A unique id for the current video playback session.
Technical Name: content_session_id
Applicable for: Ad, Content, Live, VOD
Field Type: string
Node Location: user_details
Permitted Values: UUID
Example Value: 3bba4192-8105-4498-ae34-587154d56fa6
Max Decimals: 0
User Agent
metadata
Released in version 1.111
Definition: Contains a number of tokens that refer to aspects of the user device, including the user's browser name and version, rendering engine, device’s model number, operating system and its version, etc.
Technical Name: user_agent
Applicable for: Ad, Content, Live, VOD
Field Type: string
Node Location: user_details
Permitted Values: any
Example Value: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/94.0.4606.71 Safari/537.36
Max Decimals: 0
Player
Player Name
metadata
Released in version 1.92
Definition: States which video player generated the event
Technical Name: player_name
Applicable for: Ad, Content, Live, VOD
Field Type: string
Node Location: player
Permitted Values: any
Example Value: JW Player
Max Decimals: 0
Player Version
metadata
Released in version 1.111
Definition: States the version of the video player that generated the event
Technical Name: player_version
Applicable for: Ad, Content, Live, VOD
Field Type: string
Node Location: player
Permitted Values: any
Example Value: 8.01
Max Decimals: 0
Video
Media Type
metadata
Released in version 1.111
Definition: Specifies whether the event relates to an Ad or Content asset.
Technical Name: media_type
Supported Ad Networks: Google IMA
Applicable for: Ad, Content, Live, VOD, Ad
Field Type: string
Node Location: video
Permitted Values: value list
Example Value: Ad
Value List: ad, content
Max Decimals: 0
Location
City
metadata
Released in version 1.111
Definition: The city or town where the user is located
Use Case
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.
Technical Name: city
Applicable for: Ad, Content, Live, VOD
Field Type: string
Node Location: geo_location
Permitted Values: any
Example Value: Santa Rosa Beach
Max Decimals: 0
Country
metadata
Released in version 1.111
Definition: Full name of the user's country
Use Case
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.
Technical Name: country
Applicable for: Ad, Content, Live, VOD
Field Type: string
Node Location: geo_location
Permitted Values: any
Example Value: United States
Max Decimals: 0
Country Code
metadata
Released in version 1.111
Definition: The country from which the browser initiated the event. For a list of country codes, see ISO 3166-1 alpha-2 .
Use Case
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.
Technical Name: country_code
Applicable for: Ad, Content, Live, VOD
Field Type: string
Node Location: geo_location
Permitted Values: 2 letter code
Example Value: US
Max Decimals: 0
Latitude
metadata
Released in version 1.111
Definition: Location information for the user
Use Case
When used in conjunction with longitude, this can provide an exact location for the viewer.
Technical Name: latitude
Applicable for: Ad, Content, Live, VOD
Field Type: number
Node Location: geo_location
Permitted Values: any
Example Value: 30.3659
Unit: degrees
Max Decimals: 4
Scale: -90 .. 90
Longitude
metadata
Released in version 1.111
Definition: Location information for the user
Use Case
When used in conjunction with latitude, this can provide an exact location for the viewer.
Technical Name: longitude
Applicable for: Ad, Content, Live, VOD
Field Type: number
Node Location: geo_location
Permitted Values: any
Example Value: -86.2458
Unit: degrees
Max Decimals: 4
Scale: -180 .. 180
Postal Code
metadata
Released in version 1.111
Definition: The specific administrative division within a country where the event occurred. In the United States, zip codes correspond to postal region locator
Use Case
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.
Technical Name: postal_code
Applicable for: Ad, Content, Live, VOD
Field Type: string
Node Location: geo_location
Permitted Values: any
Example Value: 32459
Max Decimals: 0
Region
metadata
Released in version 1.111
Definition: 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.
Use Case
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.
Technical Name: region
Applicable for: Ad, Content, Live, VOD
Field Type: string
Node Location: geo_location
Permitted Values: any
Example Value: Florida
Max Decimals: 0
Region Code
metadata
Released in version 1.111
Definition: 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.
Use Case
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.
Technical Name: region_code
Applicable for: Ad, Content, Live, VOD
Field Type: string
Node Location: geo_location
Permitted Values: any
Example Value: FL
Max Decimals: 0
Network
ASN
metadata
Released in version 1.111
Definition: 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
Technical Name: asn
Applicable for: Ad, Content, Live, VOD
Field Type: string
Node Location: network
Permitted Values: any
Example Value: AS30036 Mediacom Communications Corp
Max Decimals: 0
ASN Org
metadata
Released in version 1.111
Definition: The organization that owns the Autonomous System Number. Often an ISP, sometimes a private company or institution.
Technical Name: asn_org
Applicable for: Ad, Content, Live, VOD
Field Type: string
Node Location: network
Permitted Values: any
Example Value: MEDIACOM
Max Decimals: 0
ISP
metadata
Released in version 1.111
Definition: Name of the end-user's internet service provider.
Technical Name: isp
Applicable for: Ad, Content, Live, VOD
Field Type: string
Node Location: network
Permitted Values: any
Example Value: Mediacom Communications Corp
Max Decimals: 0
Page
DZ SDK Version
metadata
Released in version 1.92
Definition: Version number of the Datazoom SDK that generated the event message.
Technical Name: dz_sdk_version
Applicable for: Ad, Content, Live, VOD
Field Type: string
Node Location: page
Permitted Values: any
Example Value: 1.40
Max Decimals: 0
Custom
Custom Metadata
metadata
Released in version 1.111
Definition: 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.
Technical Name: {custom_metadata_name}
Applicable for: Ad, Content, Live, VOD
Node Location: custom
Permitted Values: any
Max Decimals: 0
|
Comments
0 comments
Article is closed for comments.