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 3rd parties. AppsFlyer cannot share user-level data of users acquired through these media sources with 3rd party platforms or services. All installs from such media sources are therefore sent as organic.
For more details and a list of media sources that restrict sharing data with 3rd parties, click here.
Setting up IBM
The setup is done from the Integrated Partners page, but to find the partner you must first go to the marketplace.
Before setting up an integration, make sure you contact the partner and open an account with them.
To activate the integration:
- From the top menu of any AppsFlyer page, click Marketplace.
- Search for the partner and select it.
- Click Set up integration. You’re directed to the integration setup page.
- 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.
- 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.
The Integration Tab is divided into different sections as described below.
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.
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 on the 3 dots on the right side in the newly generated AppsFlyer endpoint and click endpoint details.
Copy the Authentication key:
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.
In-app event settings
In this section you can map your AppsFlyer events with IBM via postbacks.
- Enter the Authorization Key again.
- Toggle In-App Event Postbacks to ON
- 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
- Click Add Event to add an SDK Event to the list
- Complete the following parameters:
|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.
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 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 are not available for IBM.