> 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/chatgpt-ads/installation.md).

# Shopify to OpenAI Ads installation guide

See the steps to connect your Shopify store to OpenAI Ads with Littledata.

In this guide, we'll explain how to connect your Shopify store to the OpenAI Ads destination.

{% hint style="info" %}
The OpenAI Ads connection is in beta and open to invited stores only.

Before you start, make sure you can sign in to Ads Manager and that your account has passed business verification. Verification can take a few days.
{% endhint %}

## Quick install guide

{% stepper %}
{% step %}
**Add the destination**

From the Littledata dashboard, click **Add destination**.

![The Destinations section of the Littledata dashboard with the Add destination button](https://3956158252-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1QhTbrMraNWciQeDvu1b%2Fuploads%2Fgit-blob-cb24e3ebcbd0e6bcf522f31e6938420a87edfb9c%2Fchatgpt-ads-install-add-destination.png?alt=media)
{% endstep %}

{% step %}
**Connect OpenAI Ads**

Find the OpenAI Ads destination and click **Connect**.

![The OpenAI Ads card in the Destinations list with its Beta badge and Connect button](https://3956158252-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1QhTbrMraNWciQeDvu1b%2Fuploads%2Fgit-blob-e9e2e861545b63c6aed4eb805cd12e6d2bd9dbab%2Fchatgpt-ads-install-directory-card.png?alt=media)

On the next screen, click **Continue**.

![The OpenAI Ads overview screen with the Continue button](https://3956158252-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1QhTbrMraNWciQeDvu1b%2Fuploads%2Fgit-blob-e61b13faeb279395256c08299f7fa09d93ea4d83%2Fchatgpt-ads-install-overview.png?alt=media)
{% endstep %}

{% step %}
**Choose your tracking preferences**

Select your tracking preferences, then click **Continue**. The recommended option, **Use best practices**, is already selected.

![The Set up your tracking step with Use best practices selected](https://3956158252-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1QhTbrMraNWciQeDvu1b%2Fuploads%2Fgit-blob-b50a260a473cf00df47e445e1890120dd704c7d8%2Fchatgpt-ads-install-tracking-preferences.png?alt=media)
{% endstep %}

{% step %}
**Add your Pixel ID and Conversions API key**

Enter the **Pixel ID** of a new data source and a **Conversions API key**. The next step shows where to find them.

![The Connect your OpenAI Ads data source step with the Pixel ID and Conversions API key fields](https://3956158252-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1QhTbrMraNWciQeDvu1b%2Fuploads%2Fgit-blob-0a0e4daa1e14319e7b3e159eceaf71c75e912850%2Fchatgpt-ads-install-data-source.png?alt=media)
{% endstep %}

{% step %}
**Find your Pixel ID and Conversions API key**

In Ads Manager:

1. Expand **Tools** in the left sidebar and click **Conversions**.
2. Create a new web data source for Littledata (for example, name it "Littledata") and copy its **Pixel ID**. Use a new data source even if you already have one (see step 6).

<figure><img src="https://3956158252-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1QhTbrMraNWciQeDvu1b%2Fuploads%2FVCmcadKSXBFmUa2u4K2B%2Fimage.png?alt=media&amp;token=9bcf415b-4a6c-48a5-b288-0e31c77c1669" alt=""><figcaption></figcaption></figure>

3. On the same page, click the key icon at the top right (**Manage conversion keys**), then click **Create new key**.\
   \
   ![](https://3956158252-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1QhTbrMraNWciQeDvu1b%2Fuploads%2F4Y48cKYlkw0osxeYG9gC%2Fimage.png?alt=media\&token=09071341-1467-4c3f-b159-e03941a674b1)<br>
4. Name the key, click **Create**, and copy it right away. You may not be able to see it again.

Paste both values into Littledata and click **Continue**.

{% hint style="warning" %}
Don't use an API key from **Settings**. That key manages campaigns and spend. Littledata only needs a Conversions API key.
{% endhint %}
{% endstep %}

{% step %}
**Avoid duplicate tracking**

If you use OpenAI's ChatGPT Ads app for Shopify, keep it installed for your product feed. Give Littledata the new Pixel ID from step 5, not the one the app uses. If another app sends purchases to OpenAI Ads, keep it on its own Pixel ID or turn off its purchase tracking.

{% hint style="info" %}
If two apps send purchases to the same Pixel ID, each purchase can be counted twice.
{% endhint %}

{% hint style="warning" %}
Don't uninstall OpenAI's ChatGPT Ads app for Shopify to fix this. It syncs your product feed, and campaigns that use that feed may pause or stop updating.
{% endhint %}

After you finish, tick **No other app sends purchases to this Pixel ID** and click **Continue**.

![The Avoid duplicate tracking step with the No other app sends purchases to this Pixel ID checkbox](https://3956158252-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1QhTbrMraNWciQeDvu1b%2Fuploads%2Fgit-blob-d0b5bfb23840b775b4b1bc9251d02fb267a566b8%2Fchatgpt-ads-install-avoid-duplicate-tracking.png?alt=media)
{% endstep %}

{% step %}
**Finish the connection**

The OpenAI Ads connection is now live on your store. Click **Continue to dashboard**.

![The All set screen for the OpenAI Ads connection](https://3956158252-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1QhTbrMraNWciQeDvu1b%2Fuploads%2Fgit-blob-5d9989530b5788193e4ac04280cf339a144b024b%2Fchatgpt-ads-install-all-set.png?alt=media)

{% hint style="info" %}
Results show in Ads Manager only after you attach a conversion event. See the next section.
{% endhint %}
{% endstep %}
{% endstepper %}

## Attach a conversion event in Ads Manager

In Ads Manager, create a conversion event for **Order Created** that uses your Littledata data source, then attach it to your campaigns. To report on other events too, create one conversion event for each. See [How to create conversion events in OpenAI Ads](/integrations/chatgpt-ads/create-conversion-events.md). Results only count from the moment you attach it. Conversions can take 24 to 48 hours to show in Ads Manager.

{% hint style="info" %}
Your Littledata data source appears in the list after it receives its first event, for example your next order or add to cart.
{% endhint %}

<figure><img src="https://3956158252-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1QhTbrMraNWciQeDvu1b%2Fuploads%2FxaagQqOUt4kaUGDacHxU%2Fimage.png?alt=media&amp;token=4da4cdd5-5d58-4671-9284-dc9a75522add" alt=""><figcaption></figcaption></figure>
