Shopify Integration

Shopify Integration overview

The AnyTrack Shopify integration simplifies conversion tracking and attribution for your eCommerce store. With quick setup, it automatically tracks purchases and key events, sending data to platforms like Google Ads, Facebook Conversion API, and TikTok Ads. By leveraging first-party data, AnyTrack enhances Event Match Quality and ensures accurate attribution while maintaining privacy. This integration empowers businesses to build better audiences and improve marketing performance across multiple channels.

How does the Shopify AnyTrack integration work:

1. Traffic: When visitors land on your website, AnyTrack collects traffic source data and First Party data.
2. Customer Journey Tracking: During the customer journey, AnyTrack automatically tracks events such as ViewContent, AddToCart, and InitiateCheckout through the AnyTrack Tracking Tag.
   1. Collects and sends product data such as sku, price, quantity and name.
   2. Sends hidden tracking parameter to the cart object.
   3. Triggers the corresponding events such as AddToCart to the AnyTrack API which is instantly forwarded to your Ad Platform's Conversion API.
3. Shopify Webhooks: AnyTrack also receives via Shopify Webhook notifications customer journey events and sends them to the Ad Platforms' conversion API.
4. Conversions: When customer complete their purchase anytrack the conversion data (including customer data and product data)
5. Attribution: AnyTrack processes the conversion data and reports it across various reporting sections of the Anytrack Dashboard.
6. Conversion API: AnyTrack then sends your conversions to your Ad Platforms' Conversion API so you can feed your ad platform's Machine Learning, AI and automatic optimization according to 100% of your conversion data.

Technical details

Standard Conversions

This table shows the event mapping between shopify, AnyTrack, Facebook and Google Analytics GA4.

👍

Good to know:

Each ad platforms integration has its own Event Mapping which AnyTrack handles automatically for you.

The Shopify Webhook

The Webhook is pre-defined and ready to be implemented with your Shopify account.

https://t1.anytrack.io/hBtoE3hN/collect/shopify

❗️

Before you begin

The Shopify integration requires that the AnyTrack Tracking Tag in the head section of your website or landing pages. Learn now to Install the AnyTrack Tag on your shop.

Setup Guide

Step #1: Add the AnyTrack Tag to your Shop

1. Create a New Property in AnyTrack.

2. Set the Shop Name and URL (the root domain) and click Next.

3. Copy the Anytrack Tracking Tag.

4. Open the Shopify Admin and Edit the Theme Code.

5. Select the Theme Liquid File and Paste the Tracking Tag in the head section.

6. Save the Theme Liquid file.

   

7. Use the AnyTrack Pixel Helper Chrome extension to verify the AnyTrack Tag is correctly installed and detected on your shop.

8. Return to AnyTrack and adjust the property settings

   1. Time Zone: Make sure it matches your shop time zone in order to avoid unnecessary discrepancies.
   2. The Base Currency: Set the currency you want the dashboard to reflect. AnyTrack will convert any revenues into your base currency.
   3. Client Side Tracking Settings: We recommend leaving the default settings which have proven to be very efficient.

Step #2: Add Shopify to your AnyTrack Account

1. Go to the Integration Catalog and search for Shopify.

2. Now click on the Shopify card and then Click on Install Integration.

Step #3: Connect your Shopify Customer Events

1. Copy the Webhook URL

2. Go to your Shopify Admin Panel

3. Navigate to Settings >> Notification

4. Scroll down to the Webhooks section and click on "Create webhook"

   1. Select the events according to the list of required events:
   2. Leave the format as JSON
   3. Paste the Webhook
   4. Update the Webhook version to Latest
   5. Click on "Save webhook"
   
   

   👍

   Repeat these steps for all events listed on the Integration page.

   Watch this Video to Learn How to Add the Webhook Notifications On Shopify

   
   

Step #4: Adjust the Conversion Event Mapping

The Event Mapping allows you to define which events to track and map to Conversion Events you will Send to your Ads Integrations (ex: Facebook Conversion API)

Step #5: Connect AnyTrack with Facebook Ads

Now that your shop is connected with AnyTrack, your customer journeys are tracked but they are not yet sent by AnyTrack to your Ad Platform's Conversion API such as Facebook, TikTok or Google Ads.

👍

Good to know:

The integration is done via the AnyTrack Dashboard and does not require any setup on the Shopify Admin.

1. Navigate to the Tracking Pixels
2. Click on the Facebook Pixel Card
3. Click on the button Browse to connect to your Facebook Business Manager.
4. Select the Facebook Pixel and Facebook Manager
5. Click Next
6. Now click on Connect to open a connection with your Ad Account
7. Enable the Facebook Conversion API
8. Scroll down and Save.
9. Now Open the Ads Integration Tab (scroll up to the top of the screen)
10. Click on the UTM Tracking Template
11. Add the Template to your Facebook Ads

👍

Connect other ad accounts

Repeat this process to connect other ad accounts.

❗️

Reminder

You must disconnect any other direct integrations that currently send conversions to your ad platforms or you will inevitably generate duplicate data in your ad accounts.

Validate your integration

This section will enable you to validate the main aspects of your setup.

Conversion Tracking

To validate your setup, you should either wait for a conversion or trigger a test conversion yourself and inspect the conversion logs.

Shopify conversion payload example

{
  "note": null,
  "created_at": "2024-08-25T21:11:38+00:00",
  "taxes_included": false,
  "line_items": [
    {
      "variant_title": "11oz / Black",
      "gift_card": false,
      "requires_shipping": true,
      "title": "Cow Mug Custom Message",
      "presentment_variant_title": "11oz / Black",
      "origin_location_id": null,
      "variant_id": 41668371808317,
      "tax_lines": [
        {
          "channel_liable": false,
          "identifier": null,
          "rate": 0.16,
          "compare_at": null,
          "zone": "country",
          "price": "1.91",
          "position": 1,
          "source": "Shopify",
          "title": "VAT"
        }
      ],
      "vendor": "Printify",
      "price": "11.95",
      "product_id": 7473336549437,
      "rank": null,
      "presentment_title": "Cow Mug Custom Message",
      "grams": 100,
      "sku": "24675843150437141759",
      "key": "41668371808317",
      "unit_price_measurement": {
        "quantity_unit": null,
        "reference_value": null,
        "reference_unit": null,
        "quantity_value": null,
        "measured_type": null
      },
      "line_price": "11.95",
      "quantity": 1,
      "compare_at_price": null,
      "fulfillment_service": "printify",
      "taxable": true,
      "variant_price": "11.95",
      "user_id": null,
      "destination_location_id": null,
      "applied_discounts": [],
      "properties": {
        "_atclid": "mYC8t8gvBdZ2ZmWOf5Jm2hP9gptNB4UEgx"
      }
    },
    {
      "variant_title": "11oz / Yellow",
      "gift_card": false,
      "requires_shipping": true,
      "title": "Copy of Colorful Mugs, 11oz",
      "presentment_variant_title": "11oz / Yellow",
      "origin_location_id": null,
      "variant_id": 41668371415101,
      "tax_lines": [
        {
          "channel_liable": false,
          "identifier": null,
          "rate": 0.16,
          "compare_at": null,
          "zone": "country",
          "price": "1.91",
          "position": 1,
          "source": "Shopify",
          "title": "VAT"
        }
      ],
      "vendor": "Printify",
      "price": "11.95",
      "product_id": 7473336156221,
      "rank": null,
      "presentment_title": "Copy of Colorful Mugs, 11oz",
      "grams": 100,
      "sku": "14097861709805790604",
      "key": "41668371415101",
      "unit_price_measurement": {
        "quantity_unit": null,
        "reference_value": null,
        "reference_unit": null,
        "quantity_value": null,
        "measured_type": null
      },
      "line_price": "11.95",
      "quantity": 1,
      "compare_at_price": null,
      "fulfillment_service": "printify",
      "taxable": true,
      "variant_price": "11.95",
      "user_id": null,
      "destination_location_id": null,
      "applied_discounts": [],
      "properties": {
        "_atclid": "mYC8t8gvBdZ2ZmWOf5Jm2hP9gptNBCIGGr"
      }
    }
  ],
  "source": null,
  "buyer_accepts_marketing": false,
  "presentment_currency": "USD",
  "total_weight": 200,
  "location_id": null,
  "source_url": null,
  "landing_site": "/",
  "source_identifier": null,
  "total_discounts": "0.00",
  "updated_at": "2024-09-02T10:08:28-07:00",
  "referring_site": null,
  "tax_lines": [
    {
      "title": "VAT",
      "rate": 0.16,
      "price": "3.82"
    }
  ],
  "customer_locale": "en-MX",
  "total_duties": "0.00",
  "currency": "USD",
  "id": 40881068146749,
  "shipping_address": [],
  "abandoned_checkout_url": "https://reallycoolmugs.com/60566175805/checkouts/ac/Z2NwLXVzLWNlbnRyYWwxOjAxSjY1UDJOUkRTSEFKODg1R0JWUDFHRkNW/recover?key=f8ca9fced0c636e847a6587e2bd56883",
  "email": null,
  "source_name": "web",
  "subtotal_price": "23.90",
  "closed_at": null,
  "total_price": "27.72",
  "device_id": null,
  "total_line_items_price": "23.90",
  "total_tax": "3.82",
  "token": "c6776b241387613dcea880161508f9c3",
  "completed_at": null,
  "shipping_lines": [],
  "phone": null,
  "user_id": null,
  "note_attributes": [
    {
      "name": "__atclid",
      "value": "mYC8t8gvBdZ2ZmWOf5Jm2hP9gptNBCIGGr"
    }
  ],
  "name": "#40881068146749",
  "cart_token": "Z2NwLXVzLWNlbnRyYWwxOjAxSjY1UDJOUkRTSEFKODg1R0JWUDFHRkNW",
  "sms_marketing_phone": null,
  "buyer_accepts_sms_marketing": false,
  "discount_codes": [],
  "gateway": null,
  "x-shopify-shop-domain": "0ae3b8-c6.myshopify.com",
  "x-shopify-webhook-id": "aa6ec748-99ef-4c09-bbe6-76ab3826619d",
  "x-shopify-hmac-sha256": "iOURkLD5PwvvyObxG41Yr0hF4MGCpPdDvg/wfNFUpQk=",
  "x-shopify-topic": "checkouts/create",
  "x-shopify-event-id": "ec7a55d5-6602-4615-ba5f-6b2448ee30fa",
  "x-shopify-triggered-at": "2024-09-02T17:08:28.689567681Z",
  "x-shopify-api-version": "2024-07"
}

FAQ & Troubleshooting

• Can I import past conversions into Anytrack?

  No. Anytrack can only ingest conversions that have been triggered following a visitor session on your website.

• How do I prevent the AnyTrack Click id from displaying in the Cart line items?

  Per Shopify's documentation, any line item property value beginning with an underscore (e.g., _hiddenPropertyName) should be hidden from customers at checkout. If your theme does not follow this best practice, it will result in the _atclid being shown during the checkout. Follow these instructions to adjust your code .

  "properties": [
        {
          "name": "_atclid",
          "value": "Q6Pr5uPG5w3uHpsft9m2iHwAjMkfi3pm6l"

• The Conversion Name is not what I am expecting, how do I change it?

  🚧

  Warning:

  Update the mapping ONLY if you know what you're doing and what you're expecting on your ad platform's event manager.
  You can update the Event Mapping in the Integration page, but it's not recommended as the standard events configured in the integration are mapped to standard events in your Ad Platforms.

Take these steps to troubleshoot errors you encounter in AnyTrack

👍

Default settings = Success

Based on thousands of integrations with Shopify, if you've followed the instructions and applied the default integration settings, you should not experience any issues.

• General troubleshooting

  • Check that the AnyTrack tag is in the head section of your shop.
  • If you're on the free plan, check the monthly traffic limit in the billing section.
  • The free plan does not include Conversion API for any Ad platforms.
  • You've followed the default settings.

• What are the Errors displayed in the Integration logs?

  Tracking errors can happen if the visitor blocks javascripts on his browser, or is preventing tracking pixels to load.

• Direct links to Shopify Cart/Checkout

  tracking errors will happen if you have an atypical setup in which you have website with direct links to the Shopify cart or checkout. [Learn more](Permalinks to Shopify Cart or Checkout: Best Practices) on how to address this challenge.

• Why are there discrepancies between Shopify and AnyTrack?

  You will have different metrics between Shopify Analytics and AnyTrack. It's an inherent part of the analytics industry. While it seems simple, all analytics are affected by many factors such as browsers, regulations, ad blockers, counting methods, aggregation methods and reporting interfaces.
  Yet, since AnyTrack's approach leverages both Client Side and Server Side tracking, it constantly enriches and collects data, regardless the tracking limitations of browsers.
  There are many possible reasons for differences in tracking results:
  • Differences in how sessions are defined. For example, some analytics software counts search bots as visitors, while other software don't.
  • Google can only count visitors with JavaScript and cookies enabled. Some visitors might not allow cookies or JavaScript.
  • Customers can use browser extensions to block Google Analytics from tracking their sessions and purchases.
  • Discrepancies might be introduced because of different reporting time zones.
    It’s unlikely that identical tracking mechanisms are being used by each of the services, so your visitors aren't recorded equally.
    
    
    
    

    🚧

    Good to know:

    Details of tracking and recording methods and mechanisms are proprietary information and are not publicly shared.