> ## 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 Destination

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 IconText = ({name, text, iconSource = "mintlify", iconLocation = "before", iconType = "solid"}) => {
  const sourceUrl = iconSource === 'local' ? `url('/images/icons/${name}.svg')` : `url('https://mintlify.b-cdn.net/v6.5.1/${iconType}/${name}.svg')`;
  return <>
            <div className="inline-block pl-2">
                {iconLocation === 'before' && <div className="h-3.5 w-3.5 fill-gray-800 dark:fill-gray-100 text-gray-800 dark:text-gray-100 inline-block align-middle mr-2">
                        <svg className="w-4 h-4 bg-gray-800 dark:bg-gray-100 " style={{
    maskImage: sourceUrl,
    maskRepeat: "no-repeat",
    maskPosition: "center center"
  }} />
                    </div>}
                <span className="inline-block align-middle font-semibold fill-gray-800 dark:fill-gray-100 text-gray-800 dark:text-gray-100 pl-1 pr-2">{text}</span>
                {iconLocation === 'after' && <div className="h-3.5 w-3.5 fill-gray-800 dark:fill-gray-100 text-gray-800 dark:text-gray-100 inline-block align-middle mr-2">
                        <svg className="w-4 h-4 bg-gray-800 dark:bg-gray-100 pr-3" style={{
    maskImage: sourceUrl,
    maskRepeat: "no-repeat",
    maskPosition: "center center"
  }} />
                    </div>}
            </div>
        </>;
};

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>;
};

## Overview

Destination Type: <IconText text="Client-side" name="browser" iconType="duotone" iconLocation="after" />  and <IconText text="Server-side" name="server" iconType="duotone" iconLocation="after" />

***

## Installation instructions

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

2. Click **Create > Data source**.

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

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

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

4. In the **Copy data source** screen, copy the **ID** and keep it handy. Click **Confirm** when you're done.

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

5. In the same **Tools > Conversions** page, click **Manage conversion keys > Create new key**.

<Frame>
  <img src="https://mintcdn.com/converge/XRhbMpvKqBHy5A8D/images/destinations/openai/04.png?fit=max&auto=format&n=XRhbMpvKqBHy5A8D&q=85&s=9e9f30a3434258c96f34f5223f0719ab" alt="OpenAI Ads - Step 5" width="2680" height="1536" data-path="images/destinations/openai/04.png" />
</Frame>

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

<Frame>
  <img src="https://mintcdn.com/converge/XRhbMpvKqBHy5A8D/images/destinations/openai/05.png?fit=max&auto=format&n=XRhbMpvKqBHy5A8D&q=85&s=bb6522db6e8a3b3d41768c0fa43361f5" alt="OpenAI Ads - Step 6" width="2680" height="1536" data-path="images/destinations/openai/05.png" />
</Frame>

7. 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/XRhbMpvKqBHy5A8D/images/destinations/openai/06.png?fit=max&auto=format&n=XRhbMpvKqBHy5A8D&q=85&s=22cd6e9f4dbe1b48e7c095e9a493ffe6" alt="OpenAI Ads - Step 7" width="2680" height="1536" data-path="images/destinations/openai/06.png" />
</Frame>

8. In the Converge sidebar, click on <IconText name="arrow-right-from-line" text="Event streams" /> and then click **Create new Destination**.

9. Select the **OpenAI Ads** destination and click **Next**.

10. Give your destination a **name** (e.g. OpenAI Ads Destination) and click **Next**.

11. In the **Authentication** screen, fill in the **Pixel Id** you copied on *step 4*, fill in **Conversions API Key** with the key you copied on *step 7*, and click **Next**.

12. In the **Configuration** screen, fill in the **Domain name** with your domain name (e.g. example.com), and click **Next**.

13. Select **Use default mapping** and click **Next**.

<Note>You can find the Default mapping for the OpenAI Ads destination [here](#event-mapping). For more information on setting up Custom mappings, look [here](/destinations/event-mapping).</Note>

14. Select the sources you want to forward events from, then click **Next**.

15. Review any issues and click **Submit**.

<Warning>Once you have installed your Converge Destination, you should **pause or remove all existing OpenAI Ads tracking**. Leaving these on will lead to duplicate tracking.</Warning>

***

## Modify your Item ID

The Converge OpenAI Ads destination, by default, will use the **Product ID** as the item identifier for the events being tracked.
However, you can configure the destination to use explicitly the **Product ID**, the **Variant ID** or **SKU** if you so choose, or use a custom item ID.

1. Navigate to your OpenAI Ads destination, click on **Configuration**.
2. Click on the **Configuration**-subtab
3. Open the **Advanced configuration (optional)** section
4. Pick your desired Item ID, and click on **Save**

**List of Item ID Modes**

| Content ID Mode | Behavior                                            |
| --------------- | --------------------------------------------------- |
| Product ID      | The ID of the product (`product_id`)                |
| Variant ID      | The ID of the variant of the product (`variant_id`) |
| SKU             | The SKU of the product (`sku`)                      |
| Custom          | An arbitrary item ID derived from the event data    |

***

## Converge functionality

This integration supports the following Converge destination functionality.

| Converge Feature                                     |       Supported       |
| :--------------------------------------------------- | :-------------------: |
| Custom Events                                        | <Icon name="check" /> |
| Filters                                              | <Icon name="check" /> |
| Server-side Conversions                              | <Icon name="check" /> |
| [Conversion amount](/destinations/conversion-amount) | <Icon name="check" /> |

***

## Event mapping

Converge automatically maps the following events from the [Converge event spec](/sources/converge-spec) to the OpenAI Ads events spec:

| Converge Event Name                                                         | Meta Event Name          |
| --------------------------------------------------------------------------- | ------------------------ |
| [\$page\_load](/sources/converge-spec#page-load)                            | `page_viewed`            |
| [Viewed Product](/sources/converge-spec#viewed-product)                     | `contents_viewed`        |
| [Viewed Collection](/sources/converge-spec#viewed-collection)               | `contents_viewed`        |
| [Added To Cart](/sources/converge-spec#added-to-cart)                       | `items_added`            |
| [Added To Wishlist](/sources/converge-spec#added-to-wishlist)               | `items_added`            |
| [Started Checkout](/sources/converge-spec#started-checkout)                 | `checkout_started`       |
| [Added Payment Info](/sources/converge-spec#added-payment-info)             | `checkout_started`       |
| [Placed Order](/sources/converge-spec#placed-order)                         | `order_created`          |
| [Started Subscription](/sources/converge-spec#started-subscription)         | `subscription_created`   |
| [Activated Subscription](/sources/converge-spec#activated-subscription)     | `subscription_created`   |
| [Subscribed To Newsletter](/sources/converge-spec#subscribed-to-newsletter) | `lead_created`           |
| [Signed Up](/sources/converge-spec#signed-up)                               | `registration_completed` |