Overview
This article will help educate the store owners who have integrated Rush and Klaviyo, about the data shared between the two platforms. The purpose of this information is to help brands understand the extent of data that Rush will be sharing with Klaviyo as this same data is later used in building automation flows in Klaviyo.
Information sharing with Klaviyo
After connecting both the apps, it is important to understand the extent and content of information that Rush will share with Klaviyo.
For each event, Rush will be sending the following information:
- Customer information provided by Shopify
- Tracking Information related to the custom tracking page
- Last checkpoint of shipment delivery status
- Delivery address
- Order information provided by Shopify
- Carrier information and its tracking details
Events sent from Rush to Klaviyo
Events are sent from Rush to Klaviyo. These events are used for flows as trigger filters.
For more information about these events, refer to the Notification Triggers article.
Klaviyo Data
The shipping carriers share the shipment statuses with Rush which is further shared with Klaviyo. You can trigger workflows in Klaviyo based upon this information also referred to as properties/shortcodes.
Note
Some of the properties may not be sent, and thus marked as optional.
Let’s say we’re looking at shipment statuses and want more information regarding a specific shipment.
We will find this information in the event shared by Rush under RUSH_SHIPMENT_NEW_STATUS. We can find information about different things here. The most common information to look up can be:
Customer information
This involves information like the customer's name, email and the city or the state the order is being shipped to. You can also look up the total value of the order. The table below shows the appropriate property with description and example.
|
Property |
Description |
Example |
|
customer_city |
The city your customer’s from. (Optional) |
New York |
|
customer_consent |
Consent means that the customer has agreed to receive marketing communications from your business. (Optional) |
true |
|
customer_country |
The country your customer’s from. |
United States |
|
customer_email |
The customer’s email address. |
johndoe @gmail.com |
|
customer_phone_number |
The customer's phone. (Optional) |
+1 888 888 8888 |
|
customer_first_name |
The first name of the customer. |
John |
|
customer_last_name |
The last name of the customer. |
Doe |
|
customer_orders_count |
The number of times the customer has ordered from your store. |
2 |
|
customer_orders_total_value |
The total value/price of the order. |
59.12 |
|
customer_shopify_customer_id |
The customer’s external e-commerce platform id. |
5548039995471 |
|
customer_zip |
The zip code of the city the customer lives in. |
11354 |
Order information
This includes order details like order items, order id, the search link for the order and many other things. The table below shows the order’s properties with descriptions and examples.
|
Property |
Description |
Example |
|
order_admin_link |
External system order link. Used usually when you want to trigger in house emails. |
|
|
order_currency |
The currency of the amount to be paid for the order. |
USD |
|
order_id |
Deprecated |
422251 |
|
order_items |
List with the order items. See below the properties. |
('title': 'Primal Collagen', 'image': 'https://cdn.shopify.com/s/files/1/0094/2925/4223/products/Primal_Collagen_mockup_1_250x.jpg?v=1635877915', 'quantity": 1, 'price': 29.56,"product_review_link': 'https://primalharvest.com/ /write?produ... |
|
order_items_count |
The total number of items shipped in the order. |
1 |
|
order_label |
The label number assigned to the order. |
#422251 |
|
order_number |
Deprecated. |
422251 |
|
order_search_link |
Link to the tracking page related to the order. |
|
|
order_tags |
List of other tags. |
"Email Set", Fulfilled, P6_Recharge |
|
order_note |
Note related to the order inside the commerce platform. |
Please leave at gate. |
|
order_unique_items_count |
How many unique items are in the order? |
1 |
|
price |
Total order price |
29.56 |
|
shopify_order_id |
The id assigned to the order by Shopify system. |
4539337605199 |
Order items list
This includes details about the items in an order:
| Property |
Description |
Example |
|
image |
The link to the image of the order item. |
https://cdn.shopify.com/s/files/1/0564/2462/8424/product-corset-midi-dress |
|
link |
Optional. |
|
|
price |
The price of the item. |
59,99 |
|
product_handle |
Deprecated |
corset-midi-dress |
|
product_review_link |
Optional. |
|
|
quantity |
The number of items in an order. |
1 |
|
title |
The name of the order item. |
Corset Midi Dress |
Carrier information
You can look up the carrier name and find relevant information about it like a tracking link or go to their website. The following table shows the carrier property with its description and an example.
|
Property |
Description |
Example |
|
carrier_logo_link |
A link to the carrier’s logo in raster format (png/jpeg). Optional. |
|
|
carrier_logo_svg_link |
The link to the carrier logo in SVG format. (Optional) |
|
|
carrier_name |
Name of the carrier. (Optional) |
USPS |
|
carrier_phone |
Contact number provided by the carrier. (Optional) |
+1 800 275 8777 |
|
carrier_tracking_link |
The link to track the carrier responsible for delivering your parcel. (Optional) |
|
|
carrier_tracking_number |
Firstmile tracking number. |
420113549374810912400301727518 |
|
carrier_website |
The link to go to the carrier’s website. (Optional) |
|
|
last_mile_carrier_tracking_number |
Last-mile tracking number. |
YT2216921236027989 |
|
last_mile_carrier_tracking_link |
Tracking link to the last-mile carrier. |
https://www.yuntrack.com/Track/Detail/YT2207821236016781 |
|
last_mile_carrier_name |
Name of the last-mile carrier. |
YunExpress |
|
last_mile_carrier_logo_link |
A link to the last-mile carrier’s logo in raster format (png/jpeg). |
https://assets.rush.app/png/couriers/yunexpress.png |
|
last_mile_carrier_logo_svg_link |
The link to the last-mile carrier logo in SVG format. |
https://assets.rush.app/svg/couriers/yunexpress.svg |
|
last_mile_carrier_website |
The link to go to the carrier’s website. |
http://www.yunexpress.com |
|
last_mile_carrier_phone |
Contact number provided by the carrier. |
+86 400-0262-126 |
Shipment information
This is where you can look up shipment information like status or shipment link etc. See the table below for a more detailed view:
|
Property |
Description |
Example |
|
shipment_hours_in_last_status |
How many hours has the shipment been in last status until Klaviyo received the message. |
5 |
|
shipment_image_link |
Deprecated. A random product link related to the shipment. |
|
|
shipment_link |
Tracking page link related to the shipment. Note that order_search_link return tracking page with shipment statuses. |
|
|
shipment_number |
The first mile carrier number assigned to the shipment |
VUORROQYRUSHILAALNWG |
|
shipment_status |
The status id of shipment. |
out_for_delivery |
|
shipment_status_label |
The status label translated into the predefined language. |
Out for delivery |
|
shipment_substatus |
Optional. |
out_for_delivery |
|
shipment_substatus_label |
Optional. |
Out for Delivery |
|
shipment_timestamp_in_last_status |
The date and time when the shipment entered the last known status. |
2022-05-20 18:15:12 Optional. |
|
shipment_title |
The title assigned to the shipment. |
Primal Collagen - Subscription |
Checkpoints
This includes information like different checkpoints, ETA etc. See the table below for these properties and their descriptions. This information is sent only in shipping events, when carriers have at least one check point.
|
Property |
Description |
Example |
|
eta |
The estimated time it will take for the carrier to deliver the order. Format Y-m-d. (Optional) |
2022-05-20 |
|
last_checkpoint_description |
The last carrier description about the shipping status assigned to the order. (Optional) |
Out for Delivery |
|
last_checkpoint_event_at |
When was the last carrier event? When was the last status assigned to the order? (Optional) Note that date is in local carrier time. |
2022-05-20 at 18:15:12 |
|
last_checkpoint_country |
The last carrier country assigned to the order. (Optional) |
United States |
|
last_checkpoint_state |
The last carrier state assigned to the order. (Optional) |
South Dakota |
|
last_checkpoint_city |
The last carrier city assigned to the order. (Optional) |
Rapid City |
|
last_checkpoint_zip |
The last carrier ZIP assigned to the order. (Optional) |
57701 |
|
last_checkpoint_latitude |
The last carrier latitude assigned to the order. (Optional) |
44.0805° N |
|
last_checkpoint_longitude |
The last carrier longitude assigned to the order. (Optional) |
103.2310° W |
Shipping address information
This includes information related to the shipping address.
Visualization
The above-mentioned properties represent the data that helps Rush build customized flows in your Klaviyo account according to your needs. See the image below for visual representation of the data inside Klaviyo:
Note
To learn more about these statuses, refer to the Shipping Statuses & Shipping Sub Statuses article.
Contact us
Feel free to reach out to us for further information and/or to provide feedback.