IBM UBX - Integration Guide

Introduction

IBM UBX (Universal Behavior Exchange), one of AppsFlyer's integrated partners, is a feature of the IBM Marketing Cloud and other IBM Commerce offerings, allows marketers to take control of all their customer data integration with an easy-to-use console. This open data exchange capability provides a contextual view of customer buying behaviors across all channels, devices and interactions, so marketers can quickly design and deploy effective campaigns, delivering meaningful experiences in an instant, while driving ROI.

Setting Up IBM

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

Integrated_Partners_link.png

Enter "IBM" in the search field and click on its logo to open the IBM configuration window.

The IBM 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 

Authorization Key

IBM connects with AppsFlyer via a unique Authorization Key. If you don't already have it, you must obtain it from IBM to continue with the integration or follow the steps below.

IBM_msc_new_2.png

Obtaining the Authorization Key

The first step in setting up a generic AppsFlyer event publisher endpoint is to create a blank endpoint in the UBX interface.

To do this, first log into your UBX account and navigate to the Endpoints tab

Next, click Register new endpoint

Next, select AppsFlyer and click Next.

IBM_1.png

Click Next

Pasted_image_at_2017_02_23_02_48_PM.png

Click on the 3 dots on the right side in the newly generated AppsFlyer endpoint and click endpoint details.

IBM_3.png

Copy the Authentication key:

IBM_Endpoint_details.png

Default Postbacks

AppsFlyer can send automatic postbacks to IBM user installs. Use this section to define sending these postbacks. 

Swrve_msc_new_4.png

Select Events attributed to any partner or organic to send postbacks for any user that downloads the app to IBM or select Off

 Note

According to both Facebook and Twitter Terms and Conditions, we cannot share user level data with any 3rd party.  Therefore, all Facebook and Twitter installs are sent to IBM UBX as organic.

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

Click Save. 

In-App Event Settings

In this section you can map your AppsFlyer events with IBM via postbacks.

  1. Enter the Authorization Key again.
  2. Toggle In-App Event Postbacks to ON
  3. Select the Sending Option for all SDK defined events.
    - Only events attributed to this partner for events coming only from users attributed to this partner
    - Events attributed to any partner or organic to have your entire user base available to be reported to the partner
  4. Click Add Event to add an SDK Event to the list
  5. Complete the following parameters:
Parameter Name Description
SDK Event Name The name of the event, as received by AppsFlyer either from the SDK integrated in your app, or from server to server events.
Tip - If you don't see the event you want in the list, make sure to activate the event on a device with a non-organic installation and recheck.
Partner Event Identifier The unique name or ID of each event as defined on IBM's side. 
Obtain the corresponding Event ID from IBM and set in the text field.
Send Revenue When unchecked - AppsFlyer sends all the parameters of the rich in-app event to the partner, except for the revenue parameter, which is contained in the af_revenue parameter.
When checked - AppsFlyer sends all the parameters including the revenue value (if it exists in the event). 

Tracking Link Tab 

Tracking Links are not available for IBM.
 

Data Enrichment Tab

Data Enrichment is not available for IBM.

Permissions Tab

Permissions are not available for IBM.

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