Urban Airship Integration

Introduction

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

Urban Airship, one of AppsFlyer's integrated partners, 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.

To configure Urban Airship, follow the steps below.

Configuring Urban Airship 

Go to the dashboard of your app and click on Integrated Partners on the left bar.

Integrated_Partners_link.png

Enter "Urban Airship" in the search field and click on its logo to open Urban Airship's configuration window.

Urban Airship's configuration window includes 4 tabs: Integration, Tracking link, Data enrichment and Permissions. Click on the items below to read about the tabs setup. 

For a detailed description of the Partner Configuration Window Header, click here.

Integration Tab 

The Integration Tab is divided into different sections as described below. 

General Settings 

Master Secret

Urban Airship connects with AppsFlyer via a unique Master Secret and App Key. If you don't already have them, you can obtain it from Urban Airship to continue with the integration, or see below for instructions how to obtain it.

Follow the instructions below to configure the integration with Urban Airship

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 in the correct place – after Urban Airship SDK is launched and before the appsflyer.sendtracking (Android) / trackAppLaunch (iOS) methods are called.

Android iOS
HashMap<String, Object> customData = new HashMap<String,Object>();

String channelId = UAirship.shared().getPushManager().getChannelId();

customData.put("android_channel", channelId);

AppsFlyerLib.getInstance().setAdditionalData(customData);
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:

 

Default Postbacks

AppsFlyer can send automatic postbacks to Urban Airship following user installs and re-engagements. Use this section to define the source of the users that allow sending these postbacks. 

urban_airship_msc_new_3.png

Select Events attributed to any partner or organic to send postbacks for any user that downloads the app to Urban Airship.

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 

Tracking Link Tab 

Tracking Links are not available for Urban Airship.

Data Enrichment Tab

Data Enrichment is not available for Urban Airship.

Permissions Tab

Permissions are not available for Urban Airship.

 Note

For details on sharing data with 3rd parties, click here.

Configuring Urban Airship

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 is populated with the following details:

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

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

Was this article helpful?
1 out of 1 found this helpful