Blueshift
This integration is currently in beta. Contact your MetaRouter support team to get started.
What Is Blueshift?
Blueshift is a cross-channel marketing platform that consolidates customer data into unified profiles, enabling marketers to deliver personalized campaigns across multiple channels, including email, SMS, and push notifications. It leverages AI-driven automation to facilitate timely and relevant customer interactions, enhancing engagement and conversion rates. The platform also provides robust analytics and performance insights, enabling data-driven optimization of marketing strategies. By integrating customer data management with cross-channel execution, Blueshift supports seamless, scalable marketing operations.
What are the benefits of integrating MetaRouter with Blueshift?
- Enhanced Data Accuracy: MetaRouter’s server-side connection ensures precise, real-time delivery of all events and parameters to Blueshift, minimizing data loss and discrepancies.
- Improved Site Performance: By eliminating the need for a Blueshift tag, MetaRouter reduces browser-side load, leading to faster site performance and a smoother user experience.
- Consistent Data Delivery: MetaRouter ensures that all data reaches Blueshift reliably, even if users have ad blockers or tracking restrictions, maintaining comprehensive data capture.
Capabilities and Considerations
- Bulk Data Delivery: Events are sent in bulk to the endpoint
https://api.getblueshift.com/api/v1/bulkevents
, ensuring reliable and timely delivery of events and parameters needed for campaign execution. - Event-Specific Handling: The integration supports various event types like page views, identification events, checkout starts, and completed orders. Each event is enriched with specific attributes, such as
event
,category
, ortotal
, ensuring complete and context-rich data delivery. - Creating Audience Segments: The integration allows Blueshift to build audience segments using the events and parameters sent by MetaRouter, such as user attributes, behavioral events, and engagement signals, enabling precise segmentation.
- Customer Profile Creation and Updates: The integration maps MetaRouter’s anonymous ID to Blueshift’s cookie field and captures emails through the
identify
event. This ensures that Blueshift can create and continuously update customer profiles with accurate, unified data. - Triggering Journeys: Data sent from MetaRouter powers journey automation in Blueshift, using enriched events and attributes to trigger personalized marketing journeys based on user behavior and segmentation criteria.
- Web Events: This integration supports web events. If you require iOS/Android events in this Blueshift integration, please reach out to your MetaRouter support team.
Limitations
- Real-time Triggering: Since events are sent in bulk to the
/bulkevents
endpoint, there might be a delay in triggering real-time workflows or journeys in Blueshift, potentially affecting time-sensitive journeys dependent on event triggers.
Getting Started - From Your Blueshift Account
- Please use the following instructions to grab an Event API Key from Blueshift: API Keys.
- Please note the Users API is not needed for this integration.
Getting Started - From Your MetaRouter Account
Adding a Blueshift integration
From the integration library, add a Blueshift integration. Then, fill out the Connection Parameters:
Connection Parameter | Description |
---|---|
EVENT_API_KEY | Helpful description of what the parameter is, why it’s necessary, etc. Limit to 150 characters. |
API_BASE_URL | Default value is set for non EU regions: https://api.getblueshift.com . If you are in the EU region, please see here for the correct base URL. |
Event Mappings
MetaRouter provides all of the event mappings that Blueshift integrations typically require. You may add custom events, parameters or mappings in accordance with Blueshift’s API documentation.
Global
Global mappings will be applied to all events. If your parameter names do not match the Expected Inputs provided, you will need to overwrite the Inputs provided with your own.
PLEASE NOTE: You will need any one of the following four identifiers: email
, customer_id
, cookie
, or device_id
.
Output Key | Description | Expected Input |
---|---|---|
timestamp Required | ISO 8601 date string: The time the event occurred. | timestamp |
ip Highly Recommended | String: The IP address of the event origin. | context.ip |
email Highly Recommended | String: The email address associated with the user profile. | traits.email |
customer_id | String: Uses userId or anonymousId for customer ID. | N/A - Expression |
cookie Required | String: The cookie ID associated with the user. | anonymousId |
user_agent Highly Recommended | String: The user agent string from the device. | context.userAgent |
device_id | String: Uses advertisingId or anonymousId for device ID. | N/A - Expression |
Event Specific
Page
Output Key | Description | Expected Input |
---|---|---|
event Required | String: Identifies the event as pageload. | Enrichment - pageload |
url | String: URL of the page viewed. | context.page.url |
referrer | String: Referrer URL of the page viewed. | context.page.referrer |
category | String: Category of the page viewed. | properties.category |
name | String: Name of the page viewed. | properties.name |
Identify
Output Key | Description | Expected Input |
---|---|---|
event Required | String: Identifies the event as identify. | Enrichment - identify |
firstname | String: User's first name. | traits.firstName |
lastname | String: User's last name. | traits.lastName |
gender | String: User's gender. | traits.gender |
joined_at | ISO 8601 date string: User's joined date. | traits.createdAt |
phone_number | String: User's phone number. | traits.phone |
birth_year | Integer: Extracted from user's birthday. | N/A - Expression |
birth_month | Integer: Extracted from user's birthday. | N/A - Expression |
birth_dayofmonth | Integer: Extracted from user's birthday. | N/A - Expression |
address | String: User's address. | traits.address |
age | Integer: User's age. | traits.age |
avatar | String: User's avatar URL. | traits.avatar |
company | String: User's company name. | traits.company |
description | String: User's description. | traits.description |
id | String: User's ID. | traits.id |
name | String: User's name. | traits.name |
title | String: User's title. | traits.title |
username | String: User's username. | traits.username |
website | String: User's website URL. | traits.website |
Product Viewed
Output Key | Description | Expected Input |
---|---|---|
event Required | String: Identifies the event as product view. | Enrichment - view |
product_id Required | String: Product ID or SKU of the viewed product. | N/A - Expression |
title | String: Name of the viewed product. | properties.name |
web_link | String: URL of the viewed product. | properties.url |
image | String: Image URL of the viewed product. | properties.image_url |
price | Float: Price of the viewed product. | properties.price |
category | Array of strings: Category of the viewed product. | N/A - Expression |
brand | String: Brand of the viewed product. | properties.brand |
parent_sku | String: Parent SKU of the viewed product. | properties.sku |
variant | String: Variant of the viewed product. | properties.variant |
quantity | Integer: Quantity of the viewed product. | properties.quantity |
coupon | String: Coupon applied to the viewed product. | properties.coupon |
currency | String: Currency of the viewed product price. | properties.currency |
position | Integer: Position of the viewed product. | properties.position |
value | Float: Total value of the viewed product interaction. | properties.value |
Product Added
Output Key | Description | Expected Input |
---|---|---|
event Required | String: Identifies the event as add to cart. | Enrichment - add_to_cart |
cart_id | String: Cart ID where the product was added. | properties.cart_id |
product_id Required | String: Product ID or SKU of the added product. | N/A - Expression |
title | String: Name of the added product. | properties.name |
web_link | String: URL of the added product. | properties.url |
image | String: Image URL of the added product. | properties.image_url |
price | Float: Price of the added product. | properties.price |
category | Array of strings: Category of the added product. | N/A - Expression |
brand | String: Brand of the added product. | properties.brand |
parent_sku | String: Parent SKU of the added product. | properties.sku |
variant | String: Variant of the added product. | properties.variant |
quantity | Integer: Quantity of the added product. | properties.quantity |
coupon | String: Coupon applied to the added product. | properties.coupon |
position | Integer: Position of the added product. | properties.position |
Product Removed
Output Key | Description | Expected Input |
---|---|---|
event Required | String: Identifies the event as remove from cart. | Enrichment - remove_from_cart |
cart_id | String: Cart ID where the product was removed. | properties.cart_id |
product_id Required | String: Product ID or SKU of the removed product. | N/A - Expression |
title | String: Name of the removed product. | properties.name |
web_link | String: URL of the removed product. | properties.url |
image | String: Image URL of the removed product. | properties.image_url |
price | Float: Price of the removed product. | properties.price |
category | Array of strings: Category of the removed product. | N/A - Expression |
brand | String: Brand of the removed product. | properties.brand |
parent_sku | String: Parent SKU of the removed product. | properties.sku |
variant | String: Variant of the removed product. | properties.variant |
quantity | Integer: Quantity of the removed product. | properties.quantity |
coupon | String: Coupon applied to the removed product. | properties.coupon |
position | Integer: Position of the removed product. | properties.position |
Default Parameters
Output Key | Description | Expected Input |
---|---|---|
event | String: Maps event name or type. | input |
Required & Recommended Identifiers
These identifiers must be mapped to Blueshift in order for successful user matching to occur. Without these IDs, any events sent to Blueshift may not be accurately reflected in reporting. For your convenience, required and recommended IDs are mapped as Global parameters to ensure they are added to every event.
Attribute | Example | Sync Injector Required? |
---|---|---|
customer_id | 123456789 | No |
cookie Required | 4b0d3f5a-879c-4c8d-a2fa-0a12a1e5e3b4 | No |
email Highly Recommended | [email protected] | No |
user_agent Highly Recommended | Mozilla/5.0 (Windows NT 10.0; Win64; x64) | No |
ip Highly Recommended | 192.168.1.1 | No |
device_id | a23b4c5d6e7f89g0h1i2j3k4l5m6n7o8 | No |
firstname | John | No |
lastname | Doe | No |
gender | Male | No |
joined_at | 2022-06-15T12:34:56Z | No |
phone_number | +15551234567 | No |
birth_year | 1992 | No |
birth_month | 5 | No |
birth_dayofmonth | 23 | No |
address | 123 Main St, Springfield, USA | No |
age | 34 | No |
avatar | https://example.com/avatar.jpg | No |
company | Example Inc. | No |
description | Enthusiastic software engineer | No |
id | 987654321 | No |
name | John Doe | No |
title | Senior Developer | No |
username | johndoe2 | No |
website | https://johndoe.dev | No |
Additional Identifiers
Blueshift will seamlessly ingest any additional identifiers provided, ensuring they are properly integrated into the system. Please ensure that each identifier is correctly mapped to the starter kit to maintain data integrity and accuracy.
Additional Blueshift Documentation
Updated 6 days ago