Skip to main content

AppsFlyer Integration for Clients

tvScientific-AppsFlyer integration tracks & attributes mobile app installs and in-app events from Connected TV (CTV) advertising campaigns.

Updated over 4 months ago

Table of Contents

Overview of the Integration

The integration between tvScientific and AppsFlyer enables precise tracking and attribution of your mobile app installs and in-app events resulting from Connected TV (CTV) advertising campaigns.

How It Works

tvScientific sends impression data through server-side requests using your AppsFlyer OneLink template. This enables attribution of TV ad views to mobile app installs, providing complete cross-device and platform visibility.

  1. TV Impression Tracking :
    tvScientific captures when and where your Connected TV (CTV) ad is shown across supported regions. The impression data here is sent to AppsFlyer through the AppsFlyer OneLink.

  2. Install & Event Attribution :
    When a user installs the app after viewing a CTV ad, AppsFlyer attributes the install and in-app events using view-through attribution.

  3. Data Sharing via Postbacks :
    AppsFlyer sends postbacks to tvScientific for installs and in-app events, based on your configured event mapping.

  4. Attribution & Optimization :
    tvScientific combines impression data with AppsFlyer postbacks to attribute installs to TV impressions and optimize campaign performance.

Supported regions:
tvScientific only processes install and in-app event data from Appsflyer for the United States, Canada, Mexico, Panama, Colombia, and Australia.

⚠️ Important: If you need to run campaigns in other regions, contact the TechOps team or your account manager before proceeding.

Pre-Integration Checklist

Before you begin integrating tvScientific with AppsFlyer for campaigns, make sure the following items are completed:
✅ AppsFlyer Admin Access :
You have admin-level access to your app’s AppsFlyer dashboard.

✅ App is Live in AppsFlyer :
Your mobile app is already registered and tracking events within AppsFlyer.

✅ Obtain Your tvScientific Tracking ID :
Reach out to your tvScientific account manager to receive your unique Advertiser UID (Tracking Key).

✅ Identify Key In-App Events :
Determine which events (e.g., install, in_app_purchase, activated_app) you want to map and share with tvScientific.

✅ Ensure IP Address is Captured in Events :
Make sure IP address is sent to AppsFlyer for all events you want to track and attribute through tvScientific.
This is required for accurate view-through attribution.

✅ Enable View-Through Attribution :
Required to allow attribution from CTV ad impressions. Must be turned on in the partner settings.

✅ Disable Advanced Privacy (iOS only) :
Ensure Advanced Privacy Mode is disabled for iOS apps to allow complete postback data sharing.

✅ Plan to Create a OneLink Template :
A OneLink template is needed to track server-side TV impressions and associate them with app installs.

✅ Coordinate With Technical Team (if needed) :
Involve your mobile dev or marketing ops team to assist with postback configuration and OneLink setup.

Integration Steps

Step 1: Activate tvScientific Partner

  1. Go to Integrated Partners in AppsFlyer.

  2. Search for and select tvScientific.

  3. Enter your tvScientific Tracking ID in the Advertiser UID field.

  4. For iOS apps: Disable Advanced Privacy Mode.
    ​

  1. Enable view-through attribution.
    ​

    Screenshot of the AppsFlyer Integrated Partners screen where tvScientific is selected and the Advertiser UID is being added


​Explanation of Key Fields in Step 1

  • Advertiser UID: Unique identifier provided by tvScientific.

  • Advanced Privacy Mode: Must be disabled for iOS to allow full attribution data

  • View-Through Attribution: Enables attribution for users who viewed but didn't click ads​

Step 2: Set Cross-Platform Attribution Priority

Why This Matters: Cross-platform attribution is essential for CTV campaigns because users often see ads on TV but install apps on mobile devices. Without this setting, you'll miss most of your CTV-driven conversions.
​

1. Within the tvScientific partner settings, find the Cross-Platform section.
2. Turn on Equal Attribution Priority.
3. Set the Lookback Window. This can be for up to a 6 hours.
​

Explanation of Key Fields in Step 2 :

  • Equal Attribution Priority: Gives CTV impressions the same priority as mobile clicks for attribution

  • Lookback Window: Time window for counting impressions toward attribution.

Step 3: Set Up Event Postbacks

  1. Under Default Postbacks, set the following:

    1. Event Name: Install

    2. Send for users from: All media sources, including organic

  2. Enable In-App Event Postbacks.

  3. Add your tvScientific Tracking ID in the In-App Event Settings section.

  4. Map your in-app events to tvScientific standard events which are install, in_app_purchase and activated_app.
    ​Here is an example of what the event name mapping would look like in AppsFlyer:

Your Event Name in AppsFlyer

tvScientific Event Name

install

install

purchase

in_app_purchase

registration

activated_app

Why "All media sources"?
tvScientific requires this setting for CPA accounts for optimal attribution coverage.

Please Note :

  • Only events tracked via the AppsFlyer SDK are eligible.

  • Do not map the following events :

    • app_open events : we do not support this event on our end.

    • Ad revenue events : Ad Revenue events are attributed differently in AppsFlyer.​

  • Use activated_app event name for any registrations event that you would like to track.

  • Make sure IP address is sent to AppsFlyer for all events you want to track and attribute in tvScientific.

⚠️ Important: If you need to add other custom events, please contact the TechOps team or your account manager before proceeding.

Step 4: Create and Share the Impression Attribution Link

In order to create the impression attribution link , you would first have to create a OneLink. Please refer to this article here on how to create your AppsFlyer OneLink.

What is OneLink?
OneLink is AppsFlyer's cross-platform linking solution that's essential for capturing CTV view-through impressions and connecting them to app installs across devices.

1. Navigate to Attribution Links > OneLink.

2. Click the three-dot menu and select Create Template.

3. In the template settings, enable Cross-Platform Attribution.

4. Save the template and copy your Impression Attribution Link.

5. Share the copied link with your tvScientific account manager.

Sample Impression Link Format:

https://impressions.onelink.me/{template_id}?pid=tvscientific_int&af_xplatform=true&af_xplatform_vt_lookback=24h&af_siteid={site_id}&c={campaign_name}

Step 5: Grant Permissions

  1. Go to Permissions tab in your app settings.

  2. Enable Ad Network Permissions for tvScientific. Please read more about this here.

✅ How to Verify Your Setup Is Working

Within 24–48 hours of completing the integration:

  1. Confirm that tvScientific appears as "Active" in your AppsFlyer partner list.

  2. Verify that the tvScientific Tracking ID is entered correctly — with no extra spaces or special characters.

  3. Check with your tvScientific account manager or team to confirm that postback data is being received.

Support and Contact Information

If you need help during the integration process, reach out to your tvScientific account manager or contact our support team:

Our team is available to:

  • Validate your setup (e.g., postback scope, attribution link).

  • Troubleshoot missing events or attribution discrepancies.

  • Guide you through custom in-app event mapping.

Related Articles
Singular Integration Guide
Kochava Integration Guide
Branch Integration Guide
How to Create OneLink for tvScientific Campaigns
AppsFlyer Integration Guide for CPA accounts
Did this answer your question?