UBX social events

IBM has identified and defined recognized events that typically happen as customers
interact with businesses over social media.

As an endpoint publisher, call https://api-01.ubx.ibmmarketingcloud.com/v1/event to publish the event. The
following example illustrates a typical JSON payload. This example is based on the Facebook Post event.

POST v1/event
{  
  “channel” : “Social”,
  “identifiers” : [            
    {
    “name” : “email”,
    “value” : “jdoe@example.com”
    }
    ],
  “events” : [
    { 
    “code” : “x1fbPost”, 
    “timestamp” : “2015-11-03T21:14:12Z”, 
    “attributes” : [
      {
      “name” : “eventName”,            
      “value” : “Facebook Post”,  
      “type” : “string” 
      } 
      {
      “name” : “body”,            
      “value” : “”,  
      “type” : “string” 
      }      
      {
      “name” : “sentimentScore”,            
      “value” : “3”,  
      “type” : “integer” 
      }   
      {
      “name” : “sentiment”,            
      “value” : “negative”,  
      “type” : “string” 
      }  
      ]
    }   
  ]
}

Facebook post

Information that describes a post to Facebook.

Event code: x1fbPost

Event attributes

Facebook comment

Information that describes a comment on Facebook.

Event code: x1fbComment

Event attributes

Facebook like post

Information that describes a Facebook like posting.

Event code: x1fbPost

Event attributes

Facebook like page

Information that describes a Facebook like page.

Event code: x1fbLikePage

Event attributes

Twitter shared

Information to describe what happens when an individual shares a tweet that is related to
a tracked product or brand.

Event code: x1twitterShared

Event attributes

Twitter tweeted

Information to describe a tweet that is related to a tracked brand or
product.

Event code: x1twitterTweeted

Event attributes

Twitter retweeted

Information to describe a re-tweet.

Event code: x1twitterRetweeted

Event attributes

Twitter mentioned

Information to describe mention of a brand or product in a tweet or retweet.

Event code: x1twitterMentioned

Event attributes

Twitter replied

Information that describes a Twitter reply that is related to a product or
brand.

Event code: x1twitterReplied

Event attributes

Twitter followed

Information that relates to a twitter user who starts to follow the Twitter feed for a
product or brand.

Event code: x1twitterFollowed

Event attributes

Twitter favorited

Event Code: x1twitterFavorited

Event attributes

Instagram like post

Information to describe a like posting on Instagram that relates to a product or
brand.

Event code: x1instagramLikePost

Event attributes

Instagram comment

Information to describe a comment on Instagram that relates to a brand or
product.

Event code: x1instagramComment

Event attributes

Instagram followed

Information to describe the event of an Instagram account that relates to a brand or
product being followed by a customer.

Event code: x1instagramFollowed

Event attributes

Instagram hastag

Information that describes a customer using a special Instagram hashtag that relates to a
product or brand.

Event code: x1instagramHashtag

Event attributes

Viewed coupon

Information that relates to an individual viewing a coupon offered by a product or
brand.

Event code: couponViewed

Event attributes

Claimed coupon

Information that relates to an individual claiming a coupon offered by a product or
brand.

Event code: couponClaimed

Event attributes

Redeemed coupon

Information that relates to an individual redeeming a coupon offered by a product or
brand.

Event code: couponRedeemed

Event attributes

Connected with social

Information that describes a customer connecting with a social networking site related to
a product or brand.

Event code: connectedSocial

Event attributes

Disconnected from social

Information that describes a customer disconnecting with a social networking site related
to a product or brand.

Event code: disconnectedSocial

Event attributes

Question answered

Information that describes a customer answering a question in a survey or quiz
format.

Event code: x1questionAnswered

Event attributes

Referred or shared link

Information that describes one customer referring or sharing a link, related to a product
or brand, that other individuals have followed.

Event code: x1link Referrel

Event attributes