Skip to main content

AppsFlyer Integration Guide for CPA accounts

Integrate AppsFlyer with tvScientific to support accurate attribution for CPA-based 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

  1. TV Impression Tracking: tvScientific records when and where your ad was shown.

  2. Data Sharing : AppsFlyer will share the install and the in-app event data with TvScientific

  3. Attribution & Optimization: tvScientific uses the data from AppsFlyer along with the data captured internally to attribute installs to TV campaigns and optimize CPA 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

✅ Obtain your tvScientific Tracking ID : Contact your tvScientific representative to receive your unique tracking key. This ID is required to activate the integration in AppsFlyer.

✅ AppsFlyer Account Access : Ensure you have admin access to your app’s AppsFlyer dashboard.

✅ Confirm your App is Live in AppsFlyer: Your mobile app should already be registered and actively tracked in the AppsFlyer platform.

✅ 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.

✅ Identify Required In-App Events: Decide which events (e.g., installs, purchases, registrations) you want to share with tvScientific and how they should be mapped.

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.
    ​

  5. 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

  • Equal AttributionLookback Window: Time window for counting impressions toward attribution.

Step 3: Set Up 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: 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
AppsFlyer Integration for Clients
Kochava Integration Guide
Branch Integration Guide
How to Create OneLink for tvScientific Campaigns
Did this answer your question?