Skip to main content

Order & Event Tracking

Learn how Brevo PushOwl tracks order data and lifecycle events from Shopify, including purchase, fulfillment, shipping, and post-purchase events.

Written by Anand
Updated this week

Brevo PushOwl tracks every step of your customer's purchase journey, from checkout to delivery. This enables you to send timely, relevant communications at each stage.

Order Data Synced

When an order is placed in your Shopify store, Brevo PushOwl captures comprehensive order details and syncs them to Brevo.

Brevo E-commerce Dashboard showing synced order count and revenue from your Shopify store.

Shopify → Brevo Order Field Mapping

Brevo Field

Source (Shopify Field)

Description

id

Order ID

Unique order identifier from Shopify

createdAt

created_at

When the order was placed (ISO 8601)

updatedAt

updated_at

Last order update time (ISO 8601)

status

financial_status

Financial status (paid, pending, refunded, etc.)

amount

total_price_set

Total amount charged

email

customer email

Customer email address

storeId

shop domain

Your Shopify store identifier

coupons

discount_codes

Applied discount/coupon codes (array)

billing.address

billing_address

Street address

billing.city

city

Billing city

billing.countryCode

country_code_v2

ISO country code (US, GB, etc.)

billing.postCode

zip

ZIP or postal code

billing.region

province

State or province

billing.phone

phone

Billing phone number

billing.paymentMethod

payment_gateway_names

First payment gateway from the list

products[]

line_items

Array of products in the order (see below)

Line Items (Products in Order)

Each product in the order is synced with:

Brevo Field

Description

productId

Shopify product ID

variantId

Specific variant ID (size, color)

quantity

Number of items ordered

price

Unit price per item

Example Brevo Order Payload

{
"id": "5130945560673",
"createdAt": "2024-06-01T08:30:00Z",
"updatedAt": "2024-06-01T08:31:00Z",
"status": "paid",
"amount": 120,
"email": "john.doe@example.com",
"storeId": "my-shopify-store",
"coupons": [
"SUMMER20"
],
"billing": {
"address": "221B Baker Street",
"city": "London",
"countryCode": "GB",
"postCode": "NW1 6XE",
"paymentMethod": "shopify_payments",
"region": "England",
"phone": "+441234567890"
},
"products": [
{
"productId": "4596388036705",
"variantId": "32137918021729",
"quantity": 2,
"price": 50
}
],
"metaInfo": {
"gift_note": "Happy Birthday!",
"customer_locale": "fr-CA",
"presentment_currency": "CAD",
"presentment_amount": 150.75,
"market_id": "123456789",
"market_handle": "canada"
}
}

Multi-Market Orders (Shopify Markets)

For stores using Shopify Markets, orders include additional market-specific data in the metaInfo field:

metaInfo Field

Description

Example

customer_locale

Customer's locale (language-country)

"fr-CA"

presentment_currency

Currency shown to customer at checkout

"CAD"

presentment_amount

Amount in the customer's local currency

150.75

market_id

Shopify Market identifier

"123456789"

market_handle

Market handle/slug

"canada"

gift_note

Gift message (if applicable)

"Happy Birthday!"

This data enables you to personalize marketing communications based on the customer's market, language, and local currency.

Filtering orders by customer locale on the Brevo Dashboard to view market-specific order data.

Order Events

Brevo PushOwl tracks events throughout the order lifecycle, enabling automated communications at each stage. For checkout-level and browsing events captured on your storefront, see Onsite Behavioral Tracking.

Purchase Events

Event

Description

Use Case

Checkout Started

Customer began checkout

Abandoned checkout recovery

Order Completed

Order was fully processed

Thank you email

Order Paid

Payment was received

Payment confirmation

Fulfillment Events

Event

Description

Use Case

Order Confirmed

Seller confirmed the order

Processing notification

Order Label Printed

Shipping label was created

Shipping soon notification

Order Label Purchased

Shipping purchased

Preparation notification

Order In Transit

Order is being shipped

Shipping update

Order Out for Delivery

Package is out for delivery

Delivery day notification

Order Delivered

Package was delivered

Delivery confirmation

Order Ready for Pickup

Order ready for store pickup

Pickup notification

Order Picked Up

Customer picked up order

Pickup confirmation

Shipment Tracking Events

Event

Description

Carrier Picked Up

Carrier has the package

Attempted Delivery

Delivery was attempted but not completed

Order Delayed

Shipment is delayed

Order Failure

Delivery failed

Post-Purchase Events

Event

Description

Use Case

Order Cancelled

Order was cancelled

Cancellation confirmation

Order Refunded

Refund was processed

Refund confirmation

Event Data Properties

Each event includes rich data for personalization:

Contact Information

  • Customer email

  • Phone number

  • Customer ID (Shopify GID)

  • First and last name

Order Details

  • Order total

  • Products purchased (with images)

  • Discount codes used

  • Order status

Timestamps

  • Event date/time

  • Order creation date

  • Order update date

Sync Timing

Order Sync Speed

Event Type

Sync Speed

New orders

Near real-time

Order updates

Near real-time

Fulfillment updates

Near real-time

Refunds

Near real-time

Historical Orders

During initial setup, Brevo PushOwl syncs your historical order data:

Order History

Estimated Time

< 10,000 orders

30-60 minutes

10,000 - 100,000 orders

1-6 hours

100,000+ orders

6-24 hours

Automation Use Cases

Abandoned Checkout Recovery

Trigger: Checkout Started (no order within X hours)

Use synced checkout data to:

  • Show exact products left in cart

  • Include product images and prices

  • Offer discount codes to complete purchase

Order Confirmation Series

Trigger: Order Completed

  • Send immediate order confirmation

  • Include order details and line items

  • Provide estimated delivery information

Shipping Notifications

Trigger: Order In Transit, Out for Delivery, Delivered

  • Keep customers informed about shipping

  • Build anticipation for delivery

  • Reduce "Where's my order?" support requests

Post-Purchase Follow-up

Trigger: Order Delivered (+ delay)

  • Request product reviews

  • Cross-sell related products

  • Encourage repeat purchases

Win-Back Campaigns

Target: Customers with orders > 90 days ago

Use order history to:

  • Identify lapsed customers

  • Personalize based on past purchases

  • Offer incentives to return

Order Status Reference

Financial Status

Status

Meaning

pending

Payment not yet received

authorized

Payment authorized but not captured

partially_paid

Partial payment received

paid

Full payment received

partially_refunded

Partial refund issued

refunded

Full refund issued

voided

Payment voided

Fulfillment Status

Status

Meaning

unfulfilled

Order not yet shipped

partial

Some items shipped

fulfilled

All items shipped

restocked

Items returned to inventory

Important Notes

Order Data Retention

  • All historical orders are synced during initial setup

  • New orders sync in near real-time going forward

Refund Handling

  • Full refunds trigger the Order Refunded event

  • Partial refunds update the order status but may not trigger a separate event

Test Orders

  • Test orders (from Shopify's test payment gateway) are synced like regular orders

  • Consider filtering these in your segments

Order Metafields

Custom order metafields can also be synced. Contact our support team to enable order metafield syncing for your store.

Related Articles

Did this answer your question?