TV ads attribution


AppsFlyer supports TV install ads attribution.

Advertisers running install ads on TV can define the timeframe (in minutes) they want organic installs from a specific GEO or city (optional) to be attributed to a TV ad. The attributed installs are shown in the AppsFlyer dashboard under the "TV" media source. As with all media sources, they have post-install analytics calculated for them, such as retention, LTV analytics, and Cohort reports.

Advertisers can define the Campaign, Channel and TV Show names, as well as geographical data, to receive the relevant data in the reports.



Media Source: "TV"

Campaign: "My TV Campaign"

af_siteid: "ESPN"

af_sub1: "SportsCenter HD"


City: "Detroit"



Check out our comprehensive guide on OTT television to learn about advanced TV terminology, buying methods, content formats, how OTT attribution works and much more!

Setting up a TV campaign

AppsFlyer supports bulk upload of media plans using the TV attribution upload file, in CSV format. See the Fields Format table below and the attached example file for more details.

To upload the file please contact your dedicated AppsFlyer customer success manager. 

Fields format

It's important to fill in the fields' values of the TV attribution file correctly. Otherwise, TV attribution may not work as expected.
Field Name Notes Example
app_id You can set TV campaigns for multiple apps using the same file. For each aired ad you can set the specific app ID it relates to.
Note that for TV campaigns targeting both Android and iOS users, you need to set a separate table entry for each platform.
com.sababa, id123456789
Campaign name Optional parameter (leave empty if not needed).
Especially useful if you have several ad formats and wish to A/B test them.
10 sec teaser, full 30 sec 
TV channel name Optional parameter (leave empty if not needed) CWTV
TV show name Optional parameter (leave empty if not needed) Arrow
Start date

Required format: yyyy-mm-dd format

The time and date must be in the future

Start time

The starting hour for the TV attribution window. The time should be in 24h format in the UTC time zone.
Required format: hh:mm

The time and date must be in the future

Attribution window
  • TV attribution windows have a maximum time of 180 minutes.
  • TV campaigns get an attribution if a user launches an app—for the first time—within the 180-minute window.
Country code 2 letter country code. For the full list of country codes click here. US, RU - see here for a list of supported country codes.
City name Optional parameter (leave empty if not needed)

New York - see here for a list of supported cities.

If the city name is not in the CSV file linked above you can use it for TV attribution if it appears in your raw data.


Avoid setting the same time slot for two separate campaigns of the same app.


The newest addition to this category is using Shazam. An ad on TV (or radio) can be Shazamed with the app, and the user who Shazams it is redirected to the market as if clicking on a specific URL. This URL may contain parameters to identify the specific ad, which can be reached via the conversion data.
Was this article helpful?