Tracking Parameters | Nativo Help Center

Tracking tags may be specified as an array of JSON objects with the structure detailed below.

Example

Example PUT payload with trackers

JSON

{ "tracking_tags": [ { "devices": [ "desktop", "mobile", "tablet" ], "tags": "<img src='https://ad.doubleclick.net/...' >", "type": "primary_impression" }, { "devices": [ "desktop", "mobile", "tablet" ], "tags": "<img src='https://ad.doubleclick.net/...' >", "type": "secondary_impression" }, { "devices": [ "desktop", "mobile", "tablet" ], "tags": "<img src='https://jadserve.postrelease.com/rt.gif?...' >", "type": "re_targeting_tags" } ] }

Tracking Tag Parameters

Key	Notes
`devices`	Specify an array of device type strings which the tracker will apply to. Options include `desktop`, `mobile`, and `tablet`.
`tags`	A string representing the actual tracking tag. This is often a 1x1 pixel, url, or script. With img pixels and scripts you may concatenate multiple trackers. Example pixel: `<img src="https://ad.doubleclick.net/ddm/...>` Example url: `https://ad.doubleclick.net/ddm/...` Example script: `<script type="application/javascript" src="https://pixel.adsafeprotected.com/..."></script>` Example w/ img and script tags: `<img src="https://ad.doubleclick.net/ddm/..." ><script src="https://cdn.doubleverify.com/..." type="text/javascript"></script>`
`type`	Tracking tag event types are listed below

Tracking Event Types

Event	Notes
`primary_impression`	For delivery-based rate types, the `primary_impression` event occurs when an ad becomes billable, per the selected rate type. For all other rate types, the event occurs when an ad becomes viewable.
`ad_rendered`	`ad_rendered` events occur when the ad server has completed rendering of the in-feed unit upon page load.
`viewable_impression`	`viewable_impression` events occur when the in-feed ad unit is in-view 50% for one or more seconds.
`cta_click`	`cta_click` events occur when a user clicks on an element to an external site. This includes CTA (Call-to-Action) elements (Images, hyperlinks, and/or companion assets) that direct the user to an external site entered in the Default Click Link. Note: If a Default Click Link has been entered in the Creative, this will override that input.
`click_to_content`	`click_to_content` events occur when a user clicks on an element that leads to other ad content. For Native Article ads, the event occurs when the users click on the IFU (In-Feed Unit) to a CLP (Content Landing Page). For Native Story ads, the event occurs when the user clicks on the IFU (In-Feed Unit) to a Story slide.
`secondary_impression`	`secondary_impression` events occur when a user views the content on the content landing page.
`re_targeting_tags`	`re_targeting_tags` events occur when a user is served an ad after an initial impression was made (used with retargeting pixels).
`slide_view`	`slide_view` events occur when a user views the slideshow component (via the native slideshow ad execution, or slideshow widget within the content landing page).
`top_image_click`	`top_image_click` events occur when a user clicks on the top companion asset. Entering a click tracker URL or HTML/script will override the tracking entered on the creative.
`bottom_image_click`	`bottom_image_click` events occur when a user clicks on the bottom companion asset. Entering a click tracker URL or HTML/script will override the tracking entered on the creative.
`right_rail_one`	`right_rail_n` click events occur when a user clicks on the nth image or ad tag companion asset. Entering a click tracker URL or HTML/script will override the tracking entered on the creative.
`right_rail_two`	same as above
`right_rail_three`	same as above
`right_rail_four`	same as above
`right_rail_five`	same as above
`video_start`	`video_start` events occur when a scroll-to-play video player is in-view 50%, or when a click-to-play video is initiated by a click on the video player, preview image, play button, or video headline to start playback.
`video_viewable_impression`	`video_viewable_impression` events occur when a scroll-to-play is in-view 50% while playing for two or more seconds.
`video_billable_view`	`video_billable_view` events occur when a user views a video. The billable event will be either cost per view (CPV) or cost per completed view (CPCV) depending on the rate type selected.
`video_view`	`video_view` events occur when a click-to-play video starts or a scroll-to-play video is in view for 3 seconds.
`video_progress_25_percent`	`video_progress_25_percent` events occur when a video view reaches 25% of the total video length.
`video_progress_50_percent`	`video_progress_50_percent` events occur when a video view reaches 50% of the total video length.
`video_progress_75_percent`	`video_progress_75_percent` events occur when a video view reaches 75% of the total video length.
`video_stop`	`video_stop` events occur when a video view reaches 100% of the total video length.
`preroll_video_start`	`preroll_video_start` events occur when a scroll-to-play video player is in view 50%, and the pre-roll video plays the first frame.
`preroll_video_end`	Pre-roll video end events occur when a scroll-to-play video plays until the end, and is in-view if the user has not interacted with it, or is potentially not in-view if the user has interacted with it (unmuted).