About agency accounts

At a glance: Make the most of your AppsFlyer Agency account with advanced configuration.

Additional reading: Agency accounts: getting started

About agency accounts

Agency accounts are used by agency teams to measure app marketing campaigns run by the agency on behalf of advertiser clients (app owners).

  • Key pre-install and post-install metrics are available to ensure that agencies are delivering optimal performance across their client portfolio.
  • Agency account dashboards provide similar capabilities and content to that of advertiser dashboards. This includes the following dashboards:
    • Lifetime value overview
    • In-app events
    • Retargeting
  • KPIs available include impressions, clicks, installs, user loyalty, cost, and ROI. About the dashboard.
  • Agency transparency: To protect agency proprietary information, agencies control if the traffic media source is disclosed or masked from advertisers:
      • [Default] Disabled: Advertisers view agency-generated traffic as coming from a single media source—the agency.
      • Enabled: Advertisers see the identity of the original media source. Setting transparency

    NOTE: Disabling transparency at any point makes historical agency-generated data non-transparent to the advertiser.

  • Agency access to advertiser data: Agencies always have access to data of traffic attributed to the agency. Advertisers can grant agencies access to additional data, for example, organic aggregate data. See access to data by different types of users.

Comparing different types of accounts

Agency versus advertiser accounts

  • Advertiser accounts are geared towards serving the app and data-owner. Advertisers add apps to their accounts and determine the data-access permissions.
  • Agency accounts are purpose-built for agency teams. They include tools for efficient measurement and analysis of marketing campaigns across their client portfolio.

Account structures permit knowledge-sharing between global agency teams and enable group-level ROI measurement, calculations, reporting, and optimization.




Code-level implementation


No; only promotion of the app

Account-level settings

Team members, team member permissions, settings, payment preferences

Agency team members and their permissions.

App-level settings

Reattribution window, OneLink configuration, time zone, currency

  • Agency transparency towards the advertiser
  • All other settings are according to those set by the advertiser

Integrated-partner-level configuration

  • Agency permissions
  • Ad network configurations
  • SRN configurations
  • Link management
  • Ad network configurations
  • Some SRN configurations that require minimum intervention from the advertiser's side:
        • Google Doubleclick
        • Snapchat
        • Tencent

    Other SRNs must be configured by the advertiser in order for the agency to use them.

  • Link management (using templates defined by Advertisers)

Additional features

Yes (some, if part of the subscription plan)

As per advertiser subscription and permissions given to the agency (see the table below)

Differences between Advertiser and Agency accounts

Features available to agencies

Available by default

Not available

Requires advertiser permission 

  • Lifetime value overview dashboard
  • In-app events dashboard
  • Retargeting dashboard
  • Integrated partners
  • OneLink*
  • Pull API

*OneLink templates can be created only by the advertiser

  • Activity dashboard
  • Custom dashboard
  • People-based analytics
  • Audiences
  • Pivot report
  • Push API
  • Data locker
  • Retention report
  • Cohort report
  • Protect360
  • Raw-data export
  • Aggregate organic data

Agency vs. ad network account


Ad network

Attribution link parameter for identification: af_prt

Attribution link parameter for identification: pid

Promotes the app via multiple media sources

Places app ads on its own platform

Sees only traffic from media sources it advertises on

Sees only traffic from ads placed on its platform

Cannot receive real-time information about installs and in-app events via postbacks

Can receive real-time information about installs and in-app events via postbacks

Can configure in-app event postbacks to some of the partners it brings traffic from*

Can configure in-app event postbacks for any traffic from itself*

* Requires advertiser permission

Differences between agency and ad network accounts

Agency accounts—campaigns and reporting

Agency: setting up campaigns

Agencies can measure the following main traffic types:

Self-reporting ad networks

Self-reporting networks, such as Facebook, Google Ads, or Twitter do not use external attribution links. Instead, each network has its own methods and APIs that AppsFlyer uses to communicate new installs, in-app events, etc.


Advertiser to perform initial SRN setup


Facebook and Twitter Yes


Note, this section refers to Facebook Ads. For attribution of Facebook Social (posts), read about Owned Media.

Important: All Facebook and Twitter campaigns must start with the Agency account name followed by "_". The name is defined in the AppsFlyer platform.
Campaigns, which are not named correctly, are visible to the advertiser but remain invisible to the agency account. The agency name is CASE SENSITIVE.


agencyx runs a Facebook campaign called agencyx_brilliantcampaign, which is visible to it.

agencyz runs a Twitter campaign called AgencyZ_whathaveidonewrong, but doesn't see any results. This happens because the agency name part of the campaign is different to the defined agency name (capital A and Z).

Contact agency@appsflyer.com if you have any questions about this.

More details on Facebook and Twitter setup for agencies.

Google Ads Yes For details of agency configuration for Google Ads campaigns, click here.
Apple Search Ads Yes For details of agency configuration for Apple Search Ads campaigns, click here.
DoubleClick No For details of agency configuration for DoubleClick campaigns, click here.
Snapchat No For details of agency configuration for Snapchat campaigns, click here.
Verizon Media (Oath: Ad Platforms / Yahoo Gemini) Yes For details of agency configuration for Verizon Media campaigns, click here.
SRN configurations


Unlike SRNs, the vast majority of ad networks use attribution links for attribution purposes. These attribution links are already provided in each network's settings on AppsFlyer and can be simply copied from there directly.

For agencies, the process is almost identical to that of the advertisers. Upon going to the setup window of any regular ad networks the attribution link is already there. The only difference is the automatic addition of the af_prt parameter to the attribution link.

Ad network configuration visibility

Ad network setup is visible to ad networks themselves only when the advertiser (app owner) configures it. When an agency activates and configures ad network integration, the network sees this section as inactive.

af_prt parameter

The value of af_prt is the agency name. The Agency name that is passed in the af_prt parameter is always converted to lowercase.

Having af_prt with your agency name on an attribution link that results in new installs enables attributing new installs to your agency account.


Without af_prt a new install can't be attributed to any agency account, and therefore it gets attributed directly to the ad network.

Do not use links received from the advertiser: make sure to use the links from your own account to prevent wrong attribution.

Special case: All-installs and all-launches networks

Some non-SRNs require (or allow) advertisers to send them postbacks for devices that aren't attributed to them.

All-installs network
The network accepts a postback for every new app install, from any source
All-launches network
The network accepts a postback for every new app launch, from any source

Some examples for all-installs networks are Vungle, Wechat, Startapp, Unity Ads, and more.

The following table shows the full list of the all-launches networks:

Network Name Network PID (on AF attribution links)
Supersonicads (a legacy network of ironSource) supersonicads_int
Adelphic Remarketing adelphicremarketing_int
Grow Mobile growmobile_int
ONE by AOL advertising.com_int
Lemmonet Mobile lemmonetmobile_int
Clickky clickky_int
Remerge remerge_int
MyThings mythings_int
TikTok for Business bytedanceglobal_int

How to setup agency attribution with all installs/launches networks?

Working with these networks entails sending information from installs that are not brought by the agency. Therefore, these networks require the advertiser to configure them BEFORE the agency.

Let's use agency attribution setup with Tapjoy as an example:

  1. Advertiser goes to Tapjoy setup window on the advertiser's dashboard
  2. Advertiser enters the Tapjoy App ID, given to the advertiser by Tapjoy, in the app_id text field
  3. Under the Integration tab, the Advertiser goes to Default Postbacks and selects "Launches attributed to any partner or organic"
  4. Agency goes to Tapjoy setup window on the agency's dashboard
  5. Agency enters the Tapjoy App ID, given to the agency by Tapjoy, in the app_id text field

Owned media—OneLink and custom links

Your agency can attribute all installs that originate from media sources that are not ad networks, such as:

    • Email addresses
    • Phone users database
    • Web site banners
    • Social media content (NOT social media ads)

To attribute installs from owned media you must create a custom attribution link, which automatically contains af_prt with your agency's name for correctly attributing to your agency.

Custom links for multiple platforms (Android and iOS) can be created using OneLink, which allows using one link only for all kinds of end users, no matter the device type. OneLink can also be used for deep linking (see the next section).

Setting up OneLink requires creating a OneLink template first. The template includes a subdomain, which can also be a Branded Link. OneLink templates and Branded Links cannot be created by agencies; only by app owners. If you'd like to start using OneLink, either: 

    • Use an existing template: When creating a new custom link, the available subdomains and Branded Links display in a dropdown.
    • Contact the app owner so they can create a template for you. The app owner can create a special Branded Link for you.

Make sure you are a partner for all the apps selected in the OneLink template.

Note: For agencies to use a OneLink template, they must be partners for all the apps in the template. 

Deep linking

Deep linking is the launch of a mobile app when opening personalized content and/or sending the users to specific activities within the app. This can provide your users with superior user experience and enhance their engagement.

For deep linking to work, the mobile app MUST be developed with deep linking capabilities and infrastructure. Contact the app owner to find out whether the app is suitable for deep linking, before setting up the campaigns.


    • Retargeting attribution allows you to target existing or past users in your campaigns. Retargeting campaigns often require deep linking capabilities to work correctly.

In-app events

App owners can have various events in their apps (e.g. purchase, watching a tutorial, passing a level, etc), that they can record and analyze in AppsFlyer. Agencies can see data of events attributed to them on the Events page in their account.

In-app event postbacks

Agencies can be given permission to configure in-app event postbacks (including the af_app_opened event) to ad networks, upon receipt of permission from the Advertiser.

Agencies can give the ad networks permission to configure in-app postbacks to themselves. Permission is granted by advertisers in the agency permission tab. 

Reporting for agencies

  • Traffic statistics are viewed and downloaded directly from the AppsFlyer dashboard.
  • Reports are accessed via the Export Data page in the AppsFlyer dashboard.
  • The following reports types are available:
    • Aggregate
    • Raw data
  • Advertisers and agencies mostly cannot access the same data in the dashboard, reports, and so on.
  • Agencies are usually responsible for only a part of the advertiser's traffic, so the agencies' access to the data is limited in comparison to that of advertisers.
  • This article breaks down these differences. The following sections highlight them


Due to Facebook and Twitter's terms of service, agencies, who are considered 3rd parties, do not have access to raw data reports traffic, originating from either Facebook or Twitter.

Access to performance reports

Access to raw data

Raw data reports (user-level data reports) contain attribution information and are divided into topics. 

Agencies can receive access to Retention and Cohort reports, and Protect360 dashboard. This requires that the advertiser enable Allow access to your retention and cohort reports or Allow access to your Protect360 dashboard, respectively, in the integrated partners' permissions tab.

Time zone and currency

Agencies see apps in the app-defined time zone and currency, but these settings can be changed only by advertisers.

Cost reporting

Agencies can enable Get cost data when configuring an integrated partner that supports cost data.

To enable Get cost data:

  1. In AppsFlyer, select the app for which you manage campaigns.
  2. In the app dashboard, click on Integrated partners.
  3. Search for an integrated partner that supports cost data.
  4. Click on the integrated partner's name to access the configuration page.
  5. Switch to the Cost tab.
  6. Enable Get cost data.
  7. Enter the API key for this partner.
  8. Click Save.

Accessing and viewing cost data

Cost data is available to the agency in the following data sources:

  • Overview page: cost data is visible in the Aggregated performance report in the Overview page.
  • Reports: cost data is available in exported reports such as Installations under Raw data reports and Partners (Media sources) under Performance reports

Hybrid account data access

Hybrid accounts are agency accounts that manage some of the apps as an Agency (app partner), and some as an Advertiser (app owner).

The following account-level features have limited availability:

  • Custom dashboard: not available for agencies and hybrid accounts.
  • Cohort report: available upon advertiser's permission.
  • Protect360: available upon advertiser's permission.

If you have a hybrid account, they may appear on your dashboard, but you will get a 404 error when trying to open them.

If you would like to use these features, it's recommended to open a new Advertiser account and separate your Advertiser and Agency apps. The features mentioned above will be available in your Advertiser account if you have them enabled.

Was this article helpful?