IBM UBX integration guide with AppsFlyer

At a glance: IBM UBX (Universal Behavior Exchange), an AppsFlyer integrated partner, is a feature of the IBM Marketing Cloud and other IBM Commerce offerings which 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.


Some media sources restrict sharing data with third parties. Therefore, postbacks for restricted events won't be sent to this partner, regardless of the configured selection for sending postbacks.

Setting up IBM

Prerequisite: Before setting up the integration, make sure you contact the partner and open an account with them.

To activate or edit the integration:

  1. To activate: In AppsFlyer, from the side menu, select Collaborate Partner Marketplace.
    To edit: In AppsFlyer, from the side menu, select Collaborate Active Integrations.
  2. Search for the partner and select it.
  3. Click Set up integration. You’re directed to the integration setup page.
  4. In the Integration tab, select the app for the integration and turn Activate partner on.
    Note: The toggle must be on (activated) for as long as you work with the partner.
  5. Complete the configuration using the relevant tabs, as described below.

The IBM configuration window only makes use of the Integration tab.

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.

Activate partner

On the first visit here, you will need to toggle below. ON the Activate Partner button to enable setup of the integration tab's parameters. The toggle MUST be ON for as long as you work with the partner.
For more details about partner activation please click here.

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.


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, log into your UBX account and navigate to the Endpoints tab

Next, click Register new endpoint

Next, select AppsFlyer and click Next.


Click Next


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


Copy the Authentication key:


Default postbacks

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


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

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 with 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 it 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).

Attribution link tab

Attribution Links are not available for IBM.

Cost tab

Cost data is not supported in the integration with this partner.

Ad revenue tab

Ad Revenue is not supported in the integration with this partner.

Permissions tab

Permissions are not available for IBM.