At a glance: Attribute mobile users to TV ads aired in specific locations and at specific times.
Attributing TV ad campaigns
- 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.
- Installs are attributed to the TV media source with the associated campaign details populated by TV channel and TV show name.
- Post-install analytics are available in the same manner as for other media sources.
- Avoid setting the same time slot for two separate campaigns of the same app.
- To view the list of AppsFlyer integrated partners supporting TV attribution, go to Integration > Integrated Partners. Select TV in the filter panel.
Attributed installs populate attribution fields as listed in the following table.
Attribution field | API name | Populate with |
---|---|---|
Media source | media_source | TV (always) |
Campaign |
campaign |
Campaign name |
Site ID | af_siteid | TV channel name. Example: ESPN |
Sub Param 1 | af_sub1 | TV show name. Example: SportsCenter HD |
Country | country | Country code |
City | city | City name |
Tip
Check out our comprehensive guide on OTT television to learn about advanced TV terminology, buying methods, content formats, how OTT attribution works
Setting up a TV campaign
- AppsFlyer supports bulk upload of media plans using the TV attribution upload file having a CSV format according to the schema that follows.
- To upload the file, please contact your customer success manager.
TV schedule schema
- File schema for TV schedule uploads.
- Optional columns must be sent; the fields should be left empty.
Column name | Mandatory | Remarks | Example |
---|---|---|---|
app_id | Yes |
|
com.example, id123456789 |
Campaign name | No |
Especially useful if you have several ad formats and wish to A/B test them. |
10-sec teaser, full 30-sec |
TV channel name | No | CWTV | |
TV show name | No | Arrow | |
Start date |
Yes |
|
2020-01-15 |
Start time |
Yes |
|
13:30 |
Attribution window | Yes |
|
20 |
Country code | Yes | 2 letter country code. List of country codes. | US, CN |
City name | No |
List of supported cities. If the city name is not in the CSV file but appears in attribution data, you can use it. |
London |
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.