Docs
  • Purple Dot Overview
  • Getting Started
  • Shopify app integration
    • Installing our Shopify App
  • Platform Integration with Shopify
    • Connect to Shopify
    • Integrate Purple Dot with your Storefront
      • Integrate into Shopify Themes built with Liquid
        • Minimum Theme Requirements
      • Integrate into Shopify Headless Storefronts
        • Integrate into Shopify Hydrogen Storefronts
    • Configure Shipping Rates
    • Test the Platform Integration
    • Pre-order Tracking
    • Migrating from our Shopify App
  • Platform Integration with Salesforce
    • Integrate Purple Dot with Salesforce
      • Upgrading to 2024-08-29
  • Platform Integration With Other Platforms
    • Integrate into Another Platform
  • Platform Integration References
    • Public API
      • /waitlists
      • /availability
      • /products/preorder-state
      • /variants/preorder-state
      • /pre-orders
    • Private API
      • /waitlists
      • /pre-orders
      • /pre-orders/count
      • /pre-orders/count-units/sku/:sku
      • /inventory
      • /fulfillment-orders
      • /fulfillment
Powered by GitBook
On this page
  • Client side tracking
  • Google Analytics (via Google Tags)
  • Google Ads (via Google Tags)
  • Meta Pixel
  • TikTok Pixel
  • Yotpo
  • Custom integration
  • Server side tracking
  • Klaviyo
  • Converge Pixel
  1. Platform Integration with Shopify

Pre-order Tracking

PreviousTest the Platform IntegrationNextMigrating from our Shopify App

Last updated 10 months ago

If you are using our , please seeInstalling our Shopify App instead. See for the comparison of our Shopify App vs. Platform integrations.

Client side tracking

The Purple Dot SDK can automatically forwarding events to various product analytics, ad and order tracking platforms if your store uses the Purple Dot init script introduced .

You can activate these integrations from the Integration settings page in the .

Google Analytics (via Google Tags)

If your store has Google tags enabled in the theme and you enabled the Google Analytics integration in the Purple Dot portal, then the Purple Dot SDK will forward the purchase event to Google Analytics.

The purchase event that PurpleDot sends is identical to the data sent by Shopify's native Google Analytics integration.

send_to: <the provided Measurement ID>,
transaction_id: <Purple Dot pre-order reference>,
value: <total pre-order amount>,
currency: <currency shopper paid in>,
tax: <total tax>,
shipping: <total shipping cost>,
items: event.lineItems.map((lineItem) => ({
  id: <line item product ID>,
  name: <line item product name>,
  brand: <your brand>,
  category: undefined,
  coupon: <any discount code that was applied>,
  price: <line item price>,
  quantity: <how many units of this line item>,
  variant: <line item SKU>,
  purchase_type: 'pre-order' | 'in-stock'
})),
purchase_type: 'Pre-order',

purchase_type is a custom attribute. To see it, an event-scoped custom dimension has to be created in GA.

Google Ads (via Google Tags)

If your store has Google tags enabled in the theme and you enabled the Google Ads integration in the Purple Dot portal, then the Purple Dot SDK will forward the conversion event to Google Ads.

send_to: <the provided Measurement ID>,
value: <total pre-order amount>,
currency: <currency shopper paid in>,
transaction_id: <Purple Dot pre-order reference>,

Meta Pixel

If your store has the Meta Pixel enabled in the theme and you enabled the Meta Pixel integration in the Purple Dot portal, then the Purple Dot SDK will forward the Purchase

currency: <currency shopper paid in>,
value: <total pre-order amount>,
content_type: 'product',
content_ids: <list of SKU ids in this pre-order>

and Preorder

currency: <currency shopper paid in>,
value: <total pre-order amount>,
content_type: 'product',
content_ids: <list of SKU ids in this pre-order>

events.

TikTok Pixel

If your store has TikTok Pixel enabled in the theme and you enabled the TikTok Pixel integration in the Purple Dot portal, then the Purple Dot SDK will forward the PlaceAnOrder event.

content_type: 'product',
quantity: <how many line items in this pre-order>,
content_id: <Purple Dot pre-order reference>,
currency: <currency shopper paid in>,
value: <total pre-order amount>,

Yotpo

If your store has Yotpo tracking enabled in the theme and you enabled the Yotpo integration in the Purple Dot portal, then the Purple Dot SDK will forward order information to Yotpo.

source: 'pixel_v2',
platform: 'shopify',
orderId: <Purple Dot pre-order reference>,
orderNumber: <Purple Dot pre-order reference>,
orderName: <Purple Dot pre-order reference>,
orderAmount: <total pre-order amount>,
orderCurrency: <currency shopper paid in>,

Custom integration

You can listen to the PreorderCreated created event to forward data for other custom use cases such as transforming data into a specific format or forwarding events to an unsupported provider.

Server side tracking

Klaviyo

type: 'event',
attributes: {
  profile: {
    data: {
      type: 'profile',
      attributes: {
        email: <shopper's email address>,
        first_name: <shopper's first name>,
        last_name: <shopper's last name>,
        location: {
          address1: <first line of shipping address>,
          address2: <second line of shipping address>,
          city: <shipping address city>,
          region: <shipping address region>,
          country: <shipping address country>,
          zip: <shipping address zip>,
        },
        phone_number: <shopper's phone number>,
      },
    },
  },
  metric: {
    data: {
      type: 'metric',
      attributes: {
        name: <as configured in the Purple Dot dashboard>,
      },
    },
  },
  properties: {
    OrderId: <Purple Dot pre-order reference>,
    Items: [{
      Cancelled: <if this line item is now cancelled>,
      ProductName: <name of the product>,
      ProductID: <external ID of this product>,
      VariantID: <external ID of the specific variant purchased>,
      SKU: <sku code of the specific variant purchased>,
      Quantity: <how many units were purchased>,
      ItemPrice: <unit price>,
      RowTotal: <line item total>,
      ShippingGroupID: <Purple Dot ID of the shipping group for this line item>,
    }],
    ShippingGroups: [{
      ShippingGroupID: <Purple Dot ID of this shipping group>,
      Title: <shipping gropu name>,
      Code: <shipping group code>,
      ItemPrice: <shipping group price>,
      RowTotal: <shipping group total>,
    }],
    Discounts: [{
      Type: <type of discount used>,
      Code: <discount code>,
      Amount: <total amount off>,
    }],
  },
  value: <total pre-order amount>,
  value_currency: <currency shopper paid in>,
  time: <date and time this pre-order was placed>,
  unique_id: <Purple Dot pre-order reference>,
}

Converge Pixel

event_name:
  '<Your custom event>',
distinct_id: [`urn:email:<Shopper's email>`],
gateway: 'Purple Dot',
properties: {
  id: <Purple Dot pre-order reference>,
  total_price: <total pre-order amount>,
  total_tax: <total pre-order tax amount>,
  total_shipping: <total pre-order shipping amount>,
  total_discount: <total pre-order discount amount>,
  currency: <pre-order currency>,
  coupon: <pre-order discount coupon>,
  items: <Array{
    product_id: <line-item product ID>,
    variant_id: <line-item variant ID>,
    name: <line-item product name>,
    variant_name: <line-item variant name>,
    sku: <line-item variant SKU>,
    price: <line-item price>,
    currency: <pre-order currency>,
    quantity: <line-item quantity>,
    discount: <line-item discount amount>,
  }>,
  profile_properties: {
    $email: <Shopper's email>,
    $phone_number: <Shopper's phone number>,
    $city: <Shopper's city>,
    $state: <Shopper's state>,
    $zip_code: <Shopper's zip code>,
    $countryCode: <Shopper's country code>,
    $first_name: <Shopper's first name>,
    $last_name: <Shopper's last name>,
  }
}

If you have enabled Klaviyo tracking from the Integration settings page in the , then Purple Dot will send the Placed Pre-Order event to your Klaviyo project.

If you have enabled Converge tracking from the Integration settings page in the , then Purple Dot will send the following event (with your desired event name) to your converge account:

Shopify App
Purple Dot Overview
here
Merchant Portal
Merchant Portal
Merchant Portal