Shopify Integration Guide

This guide will help you set up a custom pixel in Shopify using our analytics script. This approach allows you to track various events without the need for a dedicated Shopify app. It publishes all Shopify Standard Events to Ours.

Setup Instructions

Access Your Shopify Admin:
- Log in to your Shopify admin panel.
Install the Ours Pixel:
- Navigate to Settings > Customer events.
- Click on Add custom pixel and give it a name
- Copy/paste in the Ours code from app.oursprivacy.com and remove the <script> tags
Subscribe to all Shopify events:
- Add the following lines immediately below your ours pixel:

GTM Pixel Setup

// Step 1. Install GTM
// paste your GTM code here

// Step 2. Insert this snippet
analytics.subscribe("all_standard_events", function(event) {
  var name = event.name;
  var data = event.data;
  var checkout = data && data.checkout;
  var shippingAddress = checkout && checkout.shippingAddress;
  var billingAddress = checkout && checkout.billingAddress;
  var address = shippingAddress || billingAddress; // Fallback to billing if shipping is unavailable

  if (!window.dataLayer) {
    window.dataLayer = [];
  }

  window.dataLayer.push({
    event: name,
    rawData: data,
    email: checkout ? checkout.email : "",
    first_name: address ? address.firstName : "",
    last_name: address ? address.lastName : "",
    phone_number: address ? address.phone : "",
    city: address ? address.city : "",
    state: address ? address.provinceCode : "",
    zip: address ? address.zip : "",
    country: address ? address.countryCode : "",
    currency: checkout ? checkout.currencyCode : "",
    value: checkout ? checkout.totalPrice : ""
  });
});

Javascript SDK Pixel Setup

// Step 1. Install Ours Privacy
// paste your Ours install code here

// Step 2. Insert this snippet
analytics.subscribe("all_standard_events", (event) => {
  ours("track", event.name, event.data);
});

Congrats, Ours is now capturing all of your standard Shopify events.

Events Captured

Event Name	Description
`checkout_completed`	Triggered when a checkout is completed.
`payment_info_submitted`	Triggered when payment information is submitted.
`checkout_shipping_info_submitted`	Triggered when shipping information is submitted during checkout.
`checkout_address_info_submitted`	Triggered when address information is submitted during checkout.
`checkout_contact_info_submitted`	Triggered when contact information is submitted during checkout.
`checkout_started`	Triggered when a checkout process is started.
`product_added_to_cart`	Triggered when a product is added to the cart.
`cart_viewed`	Triggered when the cart is viewed.
`page_viewed`	Triggered when a page is viewed.
`product_viewed`	Triggered when a product is viewed.
`search_submitted`	Triggered when a search is submitted.
`collection_viewed`	Triggered when a collection is viewed.

Additional Resources

For more detailed instructions on setting up custom pixels in Shopify, refer to the Shopify Custom Pixel Guide.

There are similar instructions here: Shopify Custom Pixel Setup