New: Test GTM Assistant free on your development store.

Get a free tracking audit Menu

Connect OpenAI (ChatGPT) Ads to Webgarh GTM Assistant

Updated · 4 min read

You need access to the OpenAI Ads Manager account you want to connect. This guide creates an Ads Manager API key, which is different from OpenAI's separate Conversions API key.

Setup steps

Check which API key you need

  1. This guide uses the Ads Account API key. You create it yourself in OpenAI Ads Manager, under Settings → General → API Keys.
  2. OpenAI Ads also has a separate Conversions API key. You don't need it for this setup.

Create your API key in OpenAI Ads Manager

  1. Sign in to OpenAI Ads Manager.
  2. Open Settings, then General, and scroll down to API Keys.
  3. Click + Create New Key.
  4. Give the key a name you'll recognize, such as Webgarh GTM Assistant.
  5. Click Create.
  6. Copy the full key before you close the window. OpenAI shows it only once.

Connect it in Webgarh GTM Assistant

  1. In Webgarh GTM Assistant, open the OpenAI Ads integration.
  2. Paste the full key into the OpenAI Ads account API key field.
  3. Click Save & Continue.

Choose your events

  1. Select the store events to send to OpenAI Ads: Page Viewed, Product Viewed, Product Added To Cart, Checkout Started and Checkout Completed.
  2. In OpenAI Ads, Product Viewed shows as Content Viewed and Checkout Completed shows as Order Created.
  3. Click Save & Continue.
  4. If you change your events later, publish your tags again in the last step.

Identifier and filtering (optional)

  1. Choose any sales channel you don't want to track. By default, every channel is tracked.
  2. Choose the product identifier. Product ID is recommended.
  3. Choose whether to exclude taxes and shipping from the order value. By default, they're included.
  4. Click Save & Continue, or click Skip to keep the defaults.

Publish

  1. Click Publish & Finish Setup.
  2. You can come back and edit your events later.

If the connection doesn't work

  1. You can only see a masked key: OpenAI shows the full key only when you create it. Create a new key and copy it before you close the window.
  2. You created a conversion key instead: go back to Settings → General → API Keys in Ads Manager and click + Create New Key.
  3. The connection fails: check that you pasted the complete key, that it's from the right OpenAI Ads account, and that it hasn't been deleted in Ads Manager.

Treat the API key like a password. Don't share it publicly, put it in screenshots or paste it into support messages. If you lose the full key, create a new one.

Visual walkthrough

Use the screenshots below alongside the steps above to match each instruction with the correct screen in the platform.

Select a screenshot to open it full size.

OpenAI Ads Manager on Settings, General, with an arrow pointing to the Create New Key button in the API Keys section. The existing key is hidden.
Open Settings, then General, and find API Keys in OpenAI Ads Manager.
OpenAI Ads Manager's Create New API Key window, with an arrow pointing to the Key Name field and the Cancel and Create buttons below it.
Name the key so you'll recognize it, then click Create.
OpenAI Ads Manager's Save Your Key window with the new key hidden behind black bars, and the Copy and Download buttons below it.
Copy the full key before you close this window. It isn't shown again.
The OpenAI Ads account API key field in GTM Assistant with the pasted key hidden, and arrows pointing to the field and the Save & Continue button.
Paste the key into Webgarh GTM Assistant and click Save & Continue.
The Select Store Events to Track step for OpenAI Ads, matching store events such as Product Viewed and Checkout Completed to OpenAI Ads events, with an arrow pointing to Save & Continue.
Select the store events to send to OpenAI Ads.
The Identifier & Filtering Settings step for OpenAI Ads, with the sales channel, product identifier and taxes and shipping options, and the Save & Continue and Skip buttons.
Optionally exclude a sales channel, choose the product identifier and set the order value.
The Publish Tags step for OpenAI Ads in GTM Assistant, with an arrow pointing to the Publish & Finish Setup button.
Click Publish & Finish Setup to finish connecting OpenAI Ads.