Blueshift Source

Blueshift is an AI powered customer engagement platform for growth marketers. With Blueshift, you can setup programmatic cross-channel marketing campaigns across Email, Mobile, Website and other channels.

Take your company’s email analysis to the next level by adding Blueshift as a Source to Segment. We’ll automatically collect email events like Email Delivered and Email Opened, forward them to your destinations, and load them into your data warehouse.

In your favorite BI or analytics tool, you’ll be able to analyze your email campaigns in SQL or through drag-and-drop reports. And, you’ll be able to join your Blueshift data with the event data you’re already sending through Segment to analyze the down-funnel effects of your emails.

Getting Started

  1. From your workspace’s segment.com//sources page, click Add source.
  2. Choose Blueshift.
  3. Give the Source a nickname and a schema name. The nickname will be used to designate the Source in the Segment interface, and the schema name is the namespace you’ll be querying against in your warehouse. You can name them however you’d like, but we recommend sticking to something that reflects the Source itself, like Blueshift for nickname and Blueshift for the schema name.
  4. The next page (“Overview”) will surface your Segment write key for Blueshift. Copy this write key.
  5. To finish the setup, you’ll have to go into your Blueshift account and enter this Segment write key in their destinations settings. Find the right place in Blueshift by clicking Account > Webhooks:

  1. Click Save.
  2. Now when you go back to Segment, click into your Blueshift Source and you’ll be able to add other downstream Destinations where you want to see email events.

That’s it! As you send emails, events will now be sent to your destinations and automatically loaded into any warehouses you have enabled.

Blueshift Events

Below is a table of events that Blueshift sends to Segment. These are the events that will appear in your warehouse or your destinations, depending on what connections you enable in Segment:

Event NameDescription
Email DeliveredMessage has been successfully delivered to the receiving server
Email OpenedRecipient has opened the HTML message. You need to enable Open Tracking for getting this type of event
Email Link ClickedRecipient clicked on a link within the message. You need to enable Click Tracking for getting this type of event
Email BouncedReceiving server could not or would not accept message
Email Marked as SpamRecipient marked message as spam
UnsubscribeRecipient clicked on message’s subscription management link

Blueshift Event Properties

Below is a table of properties that are sent for the events above:

Propert NameDescription
account_uuidUUID of the account
campaign_uuidUUID of the campaign
bucket_uuidUUID of the bucket
trigger_uuidUUID of the trigger
experiment_uuidUUID of the experiment
creative_uuidUUID of the creative (template)
message_uuidBlueshift internal unique uuid associated with the corresponding message send event
trgger_timestampThe timestamp at which this event was generated
trgger_typeThe type of the trigger. Values can be one of “PushTrigger”, “EmailTrigger”, “SmsTrigger”, “DisplayAdTrigger”, “OnsiteTrigger” depending on the channel of the message
actionBlueshift identifiers for the event - “open”, “click”, “delivered”, “bounce”, “spam_report” or “unsubscribed”
campaign_nameName of the campaign
campaign_exec_termNature of the campaign
creative_nameName of the creative
utm_*All of the utm_campaign, utm_content, utm_medium, utm_source, utm_term on the campaign are sent back on the event
sg_message_idMessage id on Sendgrid if the event was triggered by a Sendgrid event
OtherAll trigger level custom URL tracking parameters added on the campaign are sent back on the event

UserId

Blueshift sends their customer_id associated with the message recipient as the top level userId field. Additionally, we will also send “email” and “blueshift_user_uuid” under context.traits.

Send Data to Blueshift

The Blueshift Source works better when you also connect Blueshift as a downstream destination within Segment. With the Blueshift Destination, you can send Blueshift user and event data, which you can use to trigger email campaigns. Want to start sending website or mobile to Blueshift? Head on over to our Blueshift destination docs.


If you have any questions or see anywhere we can improve our documentation, please let us know or kick off a conversation in the Segment Community!