Getting started—agency onboarding

At a glance: Start measuring the campaigns of your clients by setting up an Agency account.

AppsFlyer attribution model

Before you proceed, it’s essential to understand how AppsFlyer’s attribution works. This section explains what happens along the way from the first click or impression to the attribution of an install or an event — and beyond.

ua-agency-flow.png

  1. A marketer or an agency on behalf of the marketer configures a campaign with a certain ad network, using AppsFlyer attribution links.
  2. A user clicks on one of their ads – for example, a banner or an offer link.
  3. AppsFlyer attribution link behind the ad is then populated with information collected during the click. We gather the information from the attribution link and store it in our database.
  4. The user is redirected to an app store.
  5. The user installs the app and opens it for the first time. The AppsFlyer SDK inside the app calls our servers with the information about the device that the app is installed on.
  6. We match this data to our click database using our Attribution methods.
  7. If we find a match, we attribute the install to the click. If not, we attribute the install to an organic download.
  8. Once the install is attributed, we show it on marketer and agency dashboards and reports (except Facebook and Twitter).
  9. Then, we send a postback with the conversion details to the ad network, who can use this information for further optimization.

Agency role in mobile attribution chain

A marketer, who owns the app, integrates AppsFlyer SDK inside it in order to quantify their marketing effort.

Some app owners choose to hire marketing agencies to run advertising campaigns on their behalf. To do so, the agency should have an AppsFlyer account, and marketers should give the agency access to their apps.

Agency, therefore, doesn’t technically own the apps but only promotes them on the marketing channels it works with, without the technical involvement, such an SDK integration. Depending on the set of permissions given by a marketer, an agency can have control over a range of functions.

When an install is attributed to an ad placed by an agency, it is displayed on agency's dashboard. The app owner will see it too, and will know that it's attributed to the agency.

Note: if your organization owns the app, or handles its development as well as marketing, you should open a marketer account.

Pricing

The scope of an agency account functionality depends on the permissions provided by the app owner for each app. Therefore, agency accounts are offered for free, and only app owners are charged for attribution. App owners and agencies can use AppsFlyer attribution data for compensation purposes.

Getting started

To set up a new agency account:

  1. Complete the registration form.
    • Use your company email domain for registration.
    • Use an email address that is not associated with an existing AppsFlyer account.
  2. A member of the AppsFlyer agency team may contact you with further information required to complete the registration.
  3. Once your account is activated, you get notified and can start using AppsFlyer.

Adding team members

When your account is up and running, the account admin (the person who opened the account) can add more team members, who can get access to some or all of the apps managed by the agency. For the details of how to add new team members, click here.

Adding apps to your account

When you first create your account, it has no apps associated with it:

agency-start.png

Any agency individual or team requires permission from the app owner to:

  • gain access to the app dashboard
  • make configuration changes
  • run campaigns

Marketers provide access to any agency directly through the platform. Once your account is set up and you've received access to the apps, you can start running campaigns using AppsFlyer features.

What does it mean to get permission from a marketer

When you get permission from a marketer:

  • The app appears in your account.
  • You can set up integrations with ad networks for the app (with the exception of some networks that require configuration by the app owner).
  • You can create attribution links to use in your campaigns.
  • You can set up cost integrations with partners (that allow it).
  • You can grant ad networks and their team members permission to view basic information about the app.
    • If you work with an ad network, and so does your client, both of you can edit the ad network team members' permission to view the app dashboard and see changes made by each other.
      For example, if you see new ad network team members or missing team members that you didn’t add or remove, it’s possible that your client added or removed them.
  • You can see the app data.

Additional permissions include access to Cohort report, Protect360 dashboard, and aggregate organic data.

App list

Once you got permission from the marketer, the app appears on the app's page.

The apps page in your account lists up to 1000 apps. If the list of apps you have permissions for exceeds 1000, some apps are not shown on the list. You can still find them using the search.

agency-apps.png

Searching for apps

  1. In your account, click My Apps in the top menu
  2. In the search field, enter the search term, for example:
    • App Name
    • App ID
    • App Owner Email

Transparency

Depending on your agreement with the app owner, you may prefer to disclose media sources of the conversions coming from your agency or conceal them.

While agencies can decide not to disclose their media sources, bear in mind that the industry keeps shifting towards a more transparent ecosystem. This is already applied to a high percentage of traffic - SKAN, Facebook Ads, and Twitter Ads data are always transparent by design, regardless of the state of the Allow transparency toggle. This significantly reduces the volume of non-transparent traffic, which makes it much less valuable for marketers. Keeping your data transparent also enables you to make the most out of AppsFlyer's products. 

Note: If the marketer disables agency permissions, the agency's historical data (such as installs and cost) becomes non-transparent.

Configuring transparency 

  • The transparency should be configured for each app separately.
  • By default, your traffic is set to be transparent.

To disable transparency:

  1. Go to Configuration > App Settings.
  2. Turn off Allow transparency.

 Note

  • Only the account admins of agencies are able to change the transparency setting.
  • Data from Facebook Ads, Twitter Ads, and SKAN remains transparent whether Allow transparency is turned on or off.

Agency Dashboard

Click any app in the list of apps to access its dashboard. When you start running campaigns, the aggregate data attributed to you is displayed here.

agency-dashboard.png

The Agency account dashboard includes default access to:

  • Lifetime value overview dashboard
  • In-app events dashboard
  • Retargeting dashboard

Running campaigns

Self-reporting networks (SRNs)

SRNs, also knows as Self-attributing networks (SANs), are networks that don’t require AppsFlyer’s attribution link in order to report clicks and other data, and use direct integration with AppsFlyer instead. Among these networks are Facebook, Twitter, Google Ads, Snapchat, DoubleClick, Apple Ads Search, Yahoo, and Yahoo! JAPAN.

A majority of these networks require special setup for agencies. For example, since Facebook and Twitter integration can only be configured by an app owner, the agency campaign names MUST begin with the agency's name to make sure that the installs are eventually correctly attributed to the agency.

Click the links above to read network guides and specific instructions for agency settings.

Non-SRNs

Most ad networks need attribution links that are placed behind an ad. Read more about running campaigns with them here.

Owned media: Custom links and OneLink™

If you run campaigns on media other than ad networks (social media, emails, blogs, SMS), you can use custom links for them.

OneLink™ is a type of a custom link, that allows you to use the same link for multiple platforms or send the users to specific content inside the app.

Note: agencies cannot create OneLink or single-platform link templates, but they can use templates created by marketers.

SKAdNetwork agency campaigns

SKAdNetwork infrastructure, part of iOS by Apple, lets marketers measure campaign success without IDFA or advertising ID. Although Apple doesn't include agencies as part of the SKAdNetwork attribution process, and AppsFlyer can't attribute agencies directly, AppsFlyer still has the ability to provide attribution data for agency campaigns running on SKAdNetworks.

Campaign naming

To view your campaigns in the AppsFlyer SKAdNetwork dashboard, the names of campaigns that you configure with the SKAdNetwork, should include your partner identifier and be structured as follows: 

For example, if your af_prt is AgencyX, your campaign name may look like this:

AgencyX_SummerSale

 Note

  • Agency campaigns in SKAdNetwork are always transparent and the identity of the ad network running the campaign is not masked from the marketer. Consider that starting iOS 15, the marketer (app owner) can opt-in to directly receive a copy of the postback. 
  • You must ask the marketer to turn on the ad network Partner activation setting in the integration tab. If you don't do so, the ad network won't get postbacks related to SKAN campaigns. Note! This is in addition to the Partner activation setting that you can access in the user interface. 

Access to SKAN Conversion Studio

Agencies can view and download a marketer's SKAN CV mapping configuration in Conversion Studio, but they can't configure or edit the settings.

SKAdNetwork Dashboard

Further reading:

Single Source of Truth (SSOT) for agencies

SSOT unifies all attribution methods by combining attribution data from different models and removing duplicate installs and the associated cost and revenue-related metrics. This way, eCPI, ROI, and ROAS, for example, are calculated correctly.

Agencies can access SSOT data in the Overview dashboard, but not via API.

To include the SSOT flag in your overview dashboard, the marketer must turn on SSOT in the Conversion Studio. 

Further reading:

What else you can do

You can find more information about advanced Agency account use here.

Stumbled upon an unfamiliar term? Find it in our Glossary.

Got an urgent technical question? Search our Help Center: we probably have an answer. If we don't, contact our support team via the bottom right corner of your dashboard.