Social events

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

As an endpoint publisher, call https://api-exchange-us-1.goacoustic.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” : “[email protected]”
    }
    ],
  “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