Klaviyo integration

This guide applies only when selling pre-orders through Purple Dot's own checkout. Pre-orders sold through the Shopify checkout benefit from the same tracking as your regular sales.

If you have enabled Klaviyo tracking on the Integration settings page in the Merchant Portal, then Purple Dot checkout can do 3 different things with Klaviyo:

• track checkout conversion, by automatically sending an event (default name is Placed Pre-Order but you may change it) to your Klaviyo project whenever a pre-order purchase completes. See event payload example below

• subscribe shoppers to email marketing

• subscribe shoppers to sms marketing

This is all done server side to ensure that every checkout is tracked.

See this FAQ to learn more.

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>,
    ItemNames: [ProductName],
    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>,
}