> For the complete documentation index, see [llms.txt](https://help.littledata.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.littledata.io/integrations/facebook-capi/how-to-install-shopify-to-conversions-api.md).

# Shopify to Meta Conversions API installation guide

This guide shows you how to connect your Shopify store to Meta in the Littledata app. You copy two values from Meta Events Manager (your Pixel ID and a Conversions API access token) and paste them into the Littledata app.

### Before you start

* The Littledata app is installed on your Shopify store.
* You have access to the Meta pixel (also called a dataset) you want to send events to, in Meta Events Manager. You need permission to manage the pixel's settings to generate an access token.
* You can open the Littledata app and your Meta Events Manager in two browser tabs, so you can copy values between them.

### Start the setup in the Littledata app

{% stepper %}
{% step %}

### Open the Littledata app

In your Shopify admin, go to **Apps** and open **Littledata**.
{% endstep %}

{% step %}

### Add the destination

In the **Destinations** section, click **Add destination**. A list of destinations opens.
{% endstep %}

{% step %}

### Choose Meta

Find **Meta** in the list and click **Connect** next to it. The setup opens on the **Connect your store to Meta Ads** screen. Click **Continue**.
{% endstep %}

{% step %}

### Choose your tracking preferences

On the **Set up your tracking** screen, pick one option and click **Continue**:

* **Use best practices** (recommended): tracks all supported events and uses the **Shopify Product ID** as the product identifier. You can change this later.
* **Customize your tracking**: on the next two screens, choose your product identifier, then choose which events to send to Meta. Click **Continue** on each screen.

You'll then see **Connect your Meta pixel**, with empty **Pixel ID** and **Access token** fields. Leave this tab open.
{% endstep %}
{% endstepper %}

### Get your Pixel ID and access token from Meta

{% stepper %}
{% step %}

### Open Meta Events Manager

In a new browser tab, open Meta Business Suite. Click **All tools**, then **Events Manager**. If you have more than one business portfolio, choose the one that owns your pixel.
{% endstep %}

{% step %}

### Select your pixel

In the left menu, click **Data sources** (called **Datasets** in some accounts). Then click the pixel you use for your Shopify store.
{% endstep %}

{% step %}

### Copy your Pixel ID

Click the **Settings** tab at the top of the page. Under **Details**, copy the **Pixel ID** (some accounts call it **Dataset ID**, and it's the same number). It's a long number with only digits, usually 15 or 16 digits, like `556318326161417`.
{% endstep %}

{% step %}

### Paste the Pixel ID into the Littledata app

Go back to the Littledata app tab and paste the number into the **Pixel ID** field.
{% endstep %}

{% step %}

### Find the Conversions API section

Back in Meta Events Manager, stay on the **Settings** tab and scroll down to the **Conversions API** section.
{% endstep %}

{% step %}

### Generate an access token

Under **Set up direct integration**, select **Set up with Dataset Quality API** (Meta's recommended option). Then click **Generate access token**. Meta shows a long token made of letters and numbers. It usually starts with `EAA`.
{% endstep %}

{% step %}

### Copy the token

Copy the whole token and paste it into the Littledata app right away. If you lose it, you can generate a new one.
{% endstep %}

{% step %}

### Paste the token into the Littledata app

Go back to the Littledata app tab and paste the token into the **Access token** field. Make sure there are no spaces before or after it. Click **Continue**.

If you see **Please enter a valid pixel ID** or **Please enter a valid access token**, check that you copied the full value with no extra characters.
{% endstep %}
{% endstepper %}

### Turn off other Meta tracking and connect

Turn off any other app that sends events to the same Meta pixel. This includes Shopify's Facebook & Instagram sales channel, other tracking apps, and Meta tags in server-side Google Tag Manager (sGTM).

Meta can't deduplicate their events against Littledata's, because each tool uses its own event IDs. A purchase tracked by both would be counted twice. See [Does Meta deduplicate Littledata's events against other apps?](https://help.littledata.io/integrations/facebook-capi/meta-capi-faq#does-meta-deduplicate-littledatas-events-against-other-apps)

{% stepper %}
{% step %}

### Open the Facebook & Instagram sales channel

Skip to the next part if you don't use this sales channel. In your Shopify admin, under **Sales channels**, click **Facebook & Instagram**, then open its **Settings**.
{% endstep %}

{% step %}

### Turn off data sharing

Find the **Share data** section. If it says **Maximum**, click **Change**, turn off data sharing and save.
{% endstep %}

{% step %}

### Turn off other tracking apps

For any other app that sends events to this Meta pixel, uninstall the app or turn off its Meta tracking. Check that app's documentation for how. If you use sGTM, remove or pause its Meta tags for this pixel.
{% endstep %}

{% step %}

### Confirm and connect

Back in the Littledata app, you're on the **Disable other tracking apps** screen. Tick **I've disabled other tracking apps** and click **Connect**.
{% endstep %}

{% step %}

### Wait while tracking is added

You'll see **Adding tracking** while Littledata applies its tracking to your Meta pixel. When it's done, you'll see **You're connected! Here's where to go next.** The Meta connection is now live.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
New and Returning Customer Purchase events are not added automatically. You can add them from the **Event editor**. See [New and Returning Customer Purchase in Meta Ads](https://help.littledata.io/integrations/facebook-capi/meta-ads-custom-events-verifying-new-and-returning-customer-purchase).
{% endhint %}

### Check that it works

{% stepper %}
{% step %}

### Check the destination card

In the Littledata app, find the Meta card in **Destinations**. It shows a green **Connected** badge.
{% endstep %}

{% step %}

### Check events in Meta

In Meta Events Manager, open your pixel and click the **Overview** tab. As shoppers browse and buy, Littledata's events (for example **Purchase**) start to show in the events list. Events sent by Littledata's server-side connection show **Conversions API** as a connection method. New events can take a little while to appear.
{% endstep %}
{% endstepper %}

### Related articles

* [How it works: Shopify to Meta Conversions API](https://help.littledata.io/integrations/facebook-capi/how-it-works-shopify-to-meta-conversions-api)
* [FAQ: Meta Conversions API](https://help.littledata.io/integrations/facebook-capi/meta-capi-faq)
* [Troubleshooting common Meta errors](https://help.littledata.io/integrations/facebook-capi/common-meta-errors)
* [Turning off Shopify's CAPI integration](https://help.littledata.io/integrations/facebook-capi/disable-capi-shopify)