IBM UBX Integration Guide
(Difference between revisions)
Ramon.maciel (Talk | contribs) (→How To Integrate with IBM Marketing Cloud) |
Ramon.maciel (Talk | contribs) |
||
Line 2: | Line 2: | ||
The IBM Universal Behavior Exchange is an open exchange that makes it easy to share customer data between certified solutions. The Social-ID integration with IBM UBX allows you to leverage social login events and social profiles to be easily used across different marketing applications. | The IBM Universal Behavior Exchange is an open exchange that makes it easy to share customer data between certified solutions. The Social-ID integration with IBM UBX allows you to leverage social login events and social profiles to be easily used across different marketing applications. | ||
+ | |||
+ | == Available Events == | ||
+ | |||
+ | * Connected to social channel (Social Events) | ||
+ | ** Event Code: connectedSocial | ||
+ | ** Identifiers: social_id, email | ||
+ | ** Attributes: brandTag, userType, socialPlatform, deviceType, campaignName | ||
+ | * Contact Update (Engage Contact Update Event) | ||
+ | ** Event Code: contactUpdate | ||
+ | ** Namespace: com.ibmmarketingcloud.engage | ||
+ | ** Identifiers: social_id, email | ||
+ | ** Attributes: Email, FirstName, LastName, WorkPosition, Company, PictureURL, Gender, RelationshipStatus, Birthday, CurrentLocation, Religion, Locale, Industry, SocialIDProfileURL | ||
== How To Integrate with IBM UBX == | == How To Integrate with IBM UBX == |
Revision as of 18:22, 30 November 2016
Contents |
Introduction
The IBM Universal Behavior Exchange is an open exchange that makes it easy to share customer data between certified solutions. The Social-ID integration with IBM UBX allows you to leverage social login events and social profiles to be easily used across different marketing applications.
Available Events
- Connected to social channel (Social Events)
- Event Code: connectedSocial
- Identifiers: social_id, email
- Attributes: brandTag, userType, socialPlatform, deviceType, campaignName
- Contact Update (Engage Contact Update Event)
- Event Code: contactUpdate
- Namespace: com.ibmmarketingcloud.engage
- Identifiers: social_id, email
- Attributes: Email, FirstName, LastName, WorkPosition, Company, PictureURL, Gender, RelationshipStatus, Birthday, CurrentLocation, Religion, Locale, Industry, SocialIDProfileURL
How To Integrate with IBM UBX
- On Social-ID Marketing Platform
- On Account Settings
- Take note of API id and API secret from API page
- On Campaign Engine > Campaigns
- Create a new campaign with Social Login - Login trigger, full contact list and UBX integration channel
- On Account Settings
- On UBX
- On Endpoints tab
- Register a new Social-ID endpoint
- Use API id and API secret as keys
- Register a new Social-ID endpoint
- On Endpoints tab
How To Integrate with IBM Marketing Cloud
- Follow all the steps to integrate Social-ID with IBM UBX, choosing Contact Update as event type on the Campaign Engine
- On Silverpop
- On Data tab
- Optional: create a database if needed
- Databases > Create
- Click on a Database, then on Show Additional Details to take note of the Database ID
- Optional: add any of the following fields to the database -> FirstName, LastName, WorkPosition, Company, PictureURL, Gender, RelationshipStatus, Birthday, CurrentLocation, Religion, Locale, Industry, SocialIDProfileURL
- On Settings > Organization Settings > Application Account Access > Add Account Access
- Set application to IBM Universal Behavior Exchange
- Add and check e-mail for User Account Refresh Token and take note
- Optional: create a database if needed
- On Data tab
- On UBX
- On Endpoints tab
- Register a new IBM Engage endpoint
- Use Account Refresh Token and Database ID as keys
- Register a new IBM Engage endpoint
- On Events tab
- Subscribe to Events
- Select Social-ID > Contact Update event as source and IBM Engage as destination and subscribe
- Subscribe to Events
- On Endpoints tab
- Anytime a login happens, it will now create/update a contact in the selected Silverpop database