Integrated partners: getting started

The attribution link (the link behind the banner/offer) can look like this:

https://app.appsflyer.com/com.yourapp?pid=mediaName_int
&clickid={clickid}&advertising_id={gaid}&af_siteid={affiliate_id}
&af_cost_model=CPI&af_cost_value={cost_value}&af_cost_currency={currency}
&c={Campaign}&af_ad_type={AdType}&af_adset={Adset}&af_ad={Ad}
&is_incentivized={true\false}

https://app.appsflyer.com/ is the AppsFlyer endpoint, com.yourapp is App ID, and pid=mediaName_int is a unique media source name that we assign to your Ad Network.

This part of the link is static and doesn’t require anything from you.

The values after ‘=’ inside {} are macros that should be populated by you when the click takes place and gets sent to AppsFlyer.

The macros can be called anything, as long as they get replaced by your system with actual and correct values. The parameters before the ‘=’ sign are placeholders used by AppsFlyer so we know which values you are sending us.

In order to create the integration, we need the following information:

Although the listed parameters are highly recommended, but we support a much larger set of parameters. We suggest that you share with us as much information on the click as you collect.

You can find the full list of parameters here.

If attribution link allows you to send information to AppsFlyer, Postbacks are how we send information back to you (along with additional data), upon a successful conversion. This conversion can be either an install or a post install event (the attribution flow is largely the same for the post-install event).

The Postbacks can provide you with a wide range of device-level information, including IP address, carrier info, country, click time, and install time. For post-install events, revenue can be shared as well.

Install postback template

An install postback template can look like this:

http://your_domain.com/postback?clickid={clickid}&af_siteid={affiliate_id}
&advertising_id={gaid}&country={county-code}&device={device-brand}

http://your_domain.com/postback? is your endpoint URL to which we will send the postbacks.

A postback template is the opposite of the attribution link template. The macros after the ‘=’ are AppsFlyer's parameters needed in order for us to populate a value. The placeholder before the ‘=’ is the parameter your server needs to identify. These parameters can be called anything you want, as long as they are matched to the macros.

There are many more macros of information we can send you about the conversion. You can find the full list of postback macros here.

In-app event postback template

An in-app event postback template can look like this:

http://your_domain.com/postback?clickid={clickid}&af_siteid={affiliate_id}
&advertising_id={gaid}&event={mapped-iae}

This template uses an additional parameter:

Once your link and postback templates are ready, respond with their details to the email you received from us.

We will create an integration for you and provide you with login credentials so you can start using our Partner Dashboard.

Similarly to postbacks, the partner dashboard provides you with real-time updates to the performance of your campaigns. In addition, it includes advertiser permission-based access like Retention reports and Protect360 reports (our fraud detection suite).

App owners need to grant you permissions to view their app's dashboard and to manage their apps. Once they grant you permissions, the following takes place:

• The app appears on your dashboard
• Only the admin of your account can see basic data about the app

For your team members to get access to the app's dashboard, the app owner must give them permissions to.

If the app owner doesn't have the option to grant you permissions, please contact your Partner Development Manager or email us to integrations@appsflyer.com.

Adding team members

Advertisers grant your organization permission to manage their marketing through your ad network. However, your team members might each manage different apps. By adding team members, you have control over who manages which apps. You add team members and in turn, the advertisers grant those team members permission to manage their apps.

Once you create your account, you can start adding team members.

1. In your account, click on your email in the top right-hand corner
2. Click on Team Members
3. In the next screen, click on Add Team Members
   
   
4. Fill in the name, email and select the team member's department
5. Optional - Grant Admin Capabilities
   

    Note

   When you grant admin capabilities to a team member, you only give them the ability to add or edit team members.

   Team members with admin capabilities cannot grant admin capabilities to team members that they add.

6. Click Save

If, when trying to add a team member you receive an error message Can't create this user, consider the following:

• The name can include only letters, digits, spaces, periods (.), hyphens (-), underscores (_), quotation marks (‘ or “)
• The email address may be incorrect - make sure to enter a valid address
• The email address may already exist in the system - check the list of users to make sure it has already been added

The newly added team member receives a welcome email to activate their account. If they don't receive this email, you can resend it. See Team Member Actions below.

Team member actions

You can edit or delete team members. You can also resend the email invite in case they don't get it when you first add them.

1. Click the three dots in the right-hand corner of the team member entry

   

2. Select the desired option from the drop-down menu

Adding apps

When you first create your account, it has no apps associated with it. To add apps to your account, contact the app owner you work with and ask them to grant you permission to view their app.

Granting app permissions to team members

Only app owners can grant permissions to team members to manage their app. To give your team members permissions to apps:

1. Contact the app owner and give them a list of team member emails
2. Ask the app owner to give your team members permissions to view the app.

App list

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

Searching for apps

To search for apps:

1. In your account, click on My Apps in the top menu
2. From the drop-down menu, choose the search method:
   • App Name
   • App ID
   • App Owner Email
3. Enter the search term