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.
Important!
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:
-
To activate: In AppsFlyer, from the side menu, select Collaborate > Partner Marketplace.
To edit: In AppsFlyer, from the side menu, select Collaborate > Active Integrations. - 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.
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.
- 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:
| 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.