Integration with Appsflyer&Adjust

1、Appsflyer Integration

This article is intended for networks who want to:

  • Work with AppsFlyer for the first time

  • Migrate an advertiser to AppsFlyer

AppsFlyer sends attribution data to Hugoffers for installs and in-app events such as purchase first_guid open order.

To initiate the integration with AppsFlyer:

  1. Complete the AppsFlyer Partner Registration Information Form

  2. Once you have submitted the registration form, to AppsFlyer, you will receive an email from the AppsFlyer Partner Development Manager.

  3. Respond to this email with the name of the AppsFlyer client that you are onboarding. The AppsFlyer Partner Manager will then send you a follow-up email in a new thread where you will be asked to supply the following information:

    • Your company name

    • Transparent logo in PNG format. (Ideal size is 200x50)

    • The recommended Hugoffers attribution URL template, with any additional values you wish to add. The pid value will be automatically assigned and built into the URL once the integration has been completed

    • Any additional values you want in the URL

    • Your Network ID (nid) and postback domain for install and in-app event postbacks configurations

  4. If you have not heard from an AppsFlyer team member within 48 hours of filling out the registration form, please check your spam folder, and email "partners@appsflyer.com" to check the status. 

https://app.appsflyer.com/com.appsflyer?pid=mediaName_int&clickid={transaction_id}&af_siteid={affiliate_id}&af_sub_siteid={affiliate_source_id}&idfa={idfa}&sha1_idfa={idfa_sha1}&advertising_id={google_aid}&af_cost_value={amount}&af_cost_currency={offer_currency}&af_cost_model=CPI&af_sub_siteid={affiliate_source_id}&idfa={idfa}&sha1_idfa={idfa_sha1}&advertising_id={google_aid}&af_cost_value={amount}&af_cost_currency={offer_currency}&af_cost_model=CPI

To update an existing integration: If you need to make an update to an existing integration, then send an email request to "integrations@appsflyer.com". Most requests are completed within 2 business days.

Creating an Attribution Link in AppsFlyer

The attribution link consists of the AppsFlyer base attribution link and additional macros added by the ad-network as detailed here.

AppsFlyer Base URL

Description

https://app.appsflyer.com/{app_id}

AppsFlyer end point

app_id

Application unique ID: represents the ID of the app being promoted

pid

Media source name concatenated with _int to identify integrated networks. Example: meidaName_int

c

Campaign name

Set out below is a complete AppsFlyer attribution link with a detailed explanation per macro: 

https://app.appsflyer.com/{app_id}?pid=mediaName_int&clickid={click_id}&af_siteid={aff_id} &af_sub_siteid={aff_pub}&idfa={idfa}&sha1_idfa={idfa_sha1}&advertising_id={advertising_id} &af_cost_value={data2}&af_cost_currency={currency}&af_cost_model=CPI

  • For campaign cost models other than CPI, please update the &af_cost_model= parameter to the appropriate model. Example: CPA, CPC

  • If you are an existing AppsFlyer partner and currently migrating toHugoffers from a different platform, make sure to add &af_additional_postback=1 to your attribution links.

Global Install Postback

http://test.hopb0.com/notify/global/?click_id={clickid}

Global In-App Event Postback

http://test.hopb0.com/event/global/?click_id={clickid}&event=event_name&data={data2}

Useful things to add to Appsflyer attribution links

&af_additionalpostback=1

This allows you the ability to place more than one postback url in Appsflyer and fire them at the same time for every click ID

&af_installpostback=false

This allows you to only postback conversions for the event and not postback conversions for the install to Hugoffers at all

2、Adjust Integration

With Adjust you need to setup the postback url as an encoded url in the tracking link.

Here is a doc to help you understand how this works: https://docs.adjust.com/en/network-integration/

Here is postback setup tool: https://partners.adjust.com/

The following is a step-by-step walkthrough how of how to set up an Adjust integration:

Step 1

For MMP integrations, the first step is to have the advertiser relationship in place.

Step 2

For Adjust, you don’t need to do any pre-integration conversions before launch, as you will be building your tracking link & postback link from what the advertisers sends you.

Step 3

Request all offer details, events and the Adjust tracking link from the advertiser.

Step 4

Create the offer in Hugoffers - you won’t have the final destination URL yet, but each of the events in hugoffers must be created in advance.

Example Link: https://app.adjust.com/ENCRYPTID?adgroup={sub3}_{affiliate_id}&creative={sub2}&idfa={idfa}&gps_adid={google_aid}&ip_address={user_ip}

Event token abcdef = Registration

For completing your destination URL + postback setup, you will need to go to https://partners.adjust.com/

Step 1

Under 'Enter Links' paste in the link your advertiser sent you

Step 2

Under 'Call Backs' place in your global postback link

Step 3

For &transaction= make sure you put in the Hugoffers format of {click_id}

Step 4

For normal setups, skip most of these sections, until you reach Events

Step 5

Under events, there are two steps:

  • 1) Pop in the Event token the Advertiser sent you

  • 2) Under call back, you will need to put in your Hugoffers Event Postback URL

    • Go to the Advertiser

    • Under conversion postback > select under the Conversion drop down > Select the Event you want to set up

    • Copy that postback link, go to Adjust, and paste that under the Call Back

    • Make sure to update the transaction ID to {click_id} so that it matches the Hugoffers format

Step 6

Copy the Generated URL - That is going to be the Destination URL in Hugoffers, and includes all of the necessary details to postback to Hugoffers

Step 7

Update the Destination URL, pull a tracking link, and test to confirm everything is working correctly.

Step 8

Once everything is good go, you may consider requesting access to the Advertiser's Adjust reporting dashboard so that you can access fraud/quality data. Example Screenshots:

That generated link is inserted as your Destination URL, and includes all of the necessary data for send the Base + Event postbacks.

PreviousBasic Setup

Last updated