OpenAI Ads URL parameters tracking setup | Guides | Metrikia
Beginner2 min

OpenAI Ads URL parameters tracking setup

Enable precise OpenAI Ads (ChatGPT) click tracking by setting the URL parameters template on your campaigns in OpenAI Ads Manager.

Why configure?

Without this setup, Metrikia recognizes the ChatGPT click (oppref) but attributes the visit to the ChatGPT channel only, without knowing which ad drove it. With this setup, every click forwards the exact campaign and ad ID.

Prerequisites

  • OpenAI Ads account connected to Metrikia (Settings > Integrations > OpenAI Ads)
  • Access that can edit campaigns in OpenAI Ads Manager

Steps

1. Grab the template in Metrikia

  1. Go to /app/settings?s=integrations
  2. On your OpenAI Ads source, open "Configure URL" ("URLs" tab)
  3. Click Copy to grab the recommended template: utm_source=openai&utm_medium=paid_ai&utm_campaign={campaign_id}&utm_content={ad_id}

2. Set the template on the campaign in OpenAI Ads Manager

  1. Sign in to OpenAI Ads Manager and open your ad account
  2. Open the campaign settings
  3. Paste the template into the landing page query string template
  4. Save, then repeat for every campaign you want to track
Important: set the template at campaign level so that every ad inherits it. If a template already exists at ad level, it takes precedence: keep utm_content={ad_id} in it.

3. Verify propagation

On each click, OpenAI replaces {campaign_id} and {ad_id} with the real IDs and adds its own oppref click identifier. New ChatGPT clicks appear in /app/attribution with the exact campaign and ad in the customer journey.

What does the template do?

It automatically appends to every click:

  • utm_source=openai: traffic source
  • utm_medium=paid_ai: paid AI channel
  • utm_campaign={campaign_id}: campaign ID
  • utm_content={ad_id}: exact OpenAI ad ID

Without the template, visits stay attributed to the ChatGPT channel only, with no campaign or ad detail.

Common issues

  • "Only one ad gets attributed": the template was set on a single ad. Set it at campaign level.
  • "The exact ad does not show": an existing template at ad or ad group level overrides utm_content. Add utm_content={ad_id} to that template.
  • "No parameter reaches my site": your landing page (redirect, CMS, plugin) strips query parameters. Check that a URL with parameters keeps them after loading.
  • "Tracking does not work": the change only applies to new clicks.

To go further, check out our blog, the documentation or contact support.

Ready to take action?

Create your Metrikia account and apply this guide in minutes.