Urban Airship Integration

This article is intended for customers who want to send attribution data to Urban Airship.

Urban Airship provides the world’s leading mobile engagement platform, helping thousands of businesses of all sizes form a direct and lasting connection with their customers. With Urban Airship, companies gain total control of their mobile footprint — apps, wallets and user-level data — to deliver experiences that get noticed and drive action across mobile or any other customer touch-point.

Follow the instructions below to configure the integration with Urban Airship

1. Minimum requirements - AppsFlyer SDK:

  • Android – version 2.3.1.18 and above
  • iOS – version 3.3.3 and above 

2. Integrating with Urban Airship requires that the channelid (Urban Airship's unique user identifier) is populated in AppsFlyer's SDK. This parameter is sent with every postback and enables the identification of each user. To perform this you must insert the following strings to your app code: 

IMPORTANT NOTE:

Make sure the lines of code are inserted at the correct place – after Urban Airship SDK was launched and before the appsflyer.sendtracking (Android) / trackAppLaunch (iOS) methods are called.

For Android:

  • HashMap<String, Object> customData = new HashMap<String,Object>();
  • String channelId = UAirship.shared().getPushManager().getChannelId();
  • customData .put("android_channel", channelId);
  • AppsFlyerLib.setAdditionalData(customData);

For iOS:

  • NSString  *channelID = [UAPush shared].channelID;
  • [[AppsFlyerTracker sharedTracker] setAdditionalData:@{@"ios_channel" : channelID }]; 

3. Get the App Key and Master Secret parameters from Urban Airship:

  • Login to your Urban airship account at: go.urbanairship.com
  • Select Settings on the left menu
  • Select APIs & Integrations – on this page you can find the parameters:

Urban_Airship.png

4. Configure Urban Airship in AppsFlyer’s Dashboard.  

Click Integrated Partners in the left of the screen.

Search for Urban Airship:

  • Click on the Urban Airship logo to open the Urban AirShip configuration window.
  • Under Integration Parameters, select the Enable option
  • Insert the AppKey and the MasterSecret parameters taken from Urban Airship console (see Section 1).
  • Click Save & Close

2.png

Once you have saved the configuration, AppsFlyer sends the following data to Urban Airship for every organic and non-organic install:

  • Device ID (IDFA / Goggle Advertising ID)
  • Media Source
  • Campaign name

IMPORTANT NOTE:

According to Facebook and Twitter T&C, we are unable share user level data with any 3rd party. As a result, all Facebook and Twitter installs are sent to Urban Airship as organic. 

5. Configure Urban Airship to receive AppsFlyer data by setting up a new tag group:

  • Login to your Urban airship account at: go.urbanairship.com
  • Select Settings on the left menu
  • Select APIs & Integrations – on this page select tag Integration Options
  • Scroll down to Add new Tag Group

http://docs.urbanairship.com/topic-guides/tag-groups-walkthrough.html


The new group should be populated with the following details:

  • Name: AppsFlyer
  • Description: AppsFlyer integration
  • Group Key: appsflyer

 3.png

Viewing the Attribution Data in Urban Airship Console

The attribution can be seen under the AppsFlyer tag group either when constructing a new message to send to specifically tagged devices; or when populating a new segment:

http://docs.urbanairship.com/user-guide/audience.html

4.png

 

Was this article helpful?
1 out of 1 found this helpful
Have more questions? Submit a request
Powered by Zendesk