> ## Documentation Index
> Fetch the complete documentation index at: https://docs.runconverge.com/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenAI Ads

> An introduction to the OpenAI Ads marketing source

export const OutboundLink = ({linkText, linkTarget}) => {
  return <a target="_blank" href={linkTarget}> {linkText} 
    <div className="inline h-3 w-3 fill-gray-500 dark:fill-gray-100 text-gray-500 dark:text-gray-300 ml-1 mr-1">
      <svg className="inline w-2.5 h-2.5 bg-gray-500 dark:bg-gray-300" style={{
    maskImage: `url('https://mintlify.b-cdn.net/v6.5.1/solid/up-right-from-square.svg')`,
    maskRepeat: "no-repeat",
    maskPosition: "center center"
  }}></svg> 
    </div>
    </a>;
};

export const Icon = ({name}) => {
  return <div className="h-4 w-4 fill-gray-800 dark:fill-gray-100 text-gray-800 dark:text-gray-100 inline-block align-middle">
            <svg className="w-4 h-4 bg-gray-800 dark:bg-gray-100" style={{
    maskImage: `url('https://mintlify.b-cdn.net/v6.5.1/solid/${name}.svg')`,
    maskRepeat: "no-repeat",
    maskPosition: "center center"
  }} />
        </div>;
};

<Warning>OpenAI Ads doesn't support URL macros yet, so you can't set per-ad tracking parameters (like `cvg_adid={AD_ID}`) on your ad URLs. You'll still see OpenAI's metrics broken down by ad in Converge, but Converge can't link those ads to the first-party events it tracks, as it does for other ad platforms.</Warning>

<Note> The OpenAI marketing source allows you to see platform-specific metrics (e.g. Ad Spend) in Converge.
To send data from Converge to OpenAI, check out the [OpenAI Ads Destination](/destinations/integrations/openai) instead.</Note>

## Set up the Marketing source

1. Navigate to your <OutboundLink linkText="OpenAI Ads Manager" linkTarget="https://ads.openai.com/" /> and choose **Settings > General**.

2. Under **API Keys**, click **Create New Key**.

<Frame>
  <img src="https://mintcdn.com/converge/kieF10eM-vqLzMcj/images/ad-platforms/openai/01.png?fit=max&auto=format&n=kieF10eM-vqLzMcj&q=85&s=a398b13ce83c0d7594a6d4593a8c50f6" alt="OpenAI Ads - Step 2" width="2680" height="1536" data-path="images/ad-platforms/openai/01.png" />
</Frame>

3. Give it a name (e.g., `Converge`) and click **Create**.

<Frame>
  <img src="https://mintcdn.com/converge/kieF10eM-vqLzMcj/images/ad-platforms/openai/02.png?fit=max&auto=format&n=kieF10eM-vqLzMcj&q=85&s=81cde51c8f22b99bdc6e72cf59c67de7" alt="OpenAI Ads - Step 3" width="2680" height="1536" data-path="images/ad-platforms/openai/02.png" />
</Frame>

4. In the **Save Your Key** screen, click **Copy** to copy the key to your clipboard and keep it safe.

<Frame>
  <img src="https://mintcdn.com/converge/kieF10eM-vqLzMcj/images/ad-platforms/openai/03.png?fit=max&auto=format&n=kieF10eM-vqLzMcj&q=85&s=67db5e330f15fc8f7f090b7f2570e45e" alt="OpenAI Ads - Step 4" width="2680" height="1536" data-path="images/ad-platforms/openai/03.png" />
</Frame>

5. Navigate to the [Marketing Sources](https://app.runconverge.com/-/ad-platforms) in your Converge dashboard.

6. Click on **Connect a new marketing source**  and select **OpenAI Ads** from the list.

7. Give it a name (e.g., `OpenAI Ads`) and click **Next**.

8. In the **Configuration** step, fill in the **Reporting API key** field with the key you copied in *step 4*, and click **Next**.

9. Review your changes and click **Connect marketing source**. Your OpenAI Ads metrics should begin streaming into Converge.
