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

# OpenAI Ads

> Connect your OpenAI Ads account to Eyk with an API key, so your daily ad spend lands in BigQuery next to your sales.

> [!NOTE]
>
> The OpenAI Ads source is currently in beta.

Connect OpenAI Ads to Eyk to collect the daily results of your campaigns.

To send conversion events from Eyk to OpenAI Ads instead, see the [OpenAI Ads destination](https://docs.eykdata.com/destinations/openai.md).

## What Eyk builds from this data

Eyk copies the daily results of your campaigns into your own BigQuery project. BigQuery is the data warehouse Eyk sets up for you. All ad platforms land in the same tables, so you can compare them side by side.

| Table in BigQuery | What it holds |
| - | - |
| `fact_daily_ads` | Spend, impressions and clicks per ad per day, plus the orders and revenue the platform reports |
| `fact_attributions` | Your revenue per marketing channel, campaign and ad, for each attribution model, next to your ad spend |

In Canvas and Alvin AI, your ad spend shows up in **Attributions**, next to your sales. Connect a store platform too, so Eyk can calculate your return on ad spend, cost per acquisition and profit after ad spend.

The orders and revenue an ad platform reports can differ from your real sales. Eyk's attribution uses your own orders and tracking data instead. To open your BigQuery project, click **Google BigQuery** at the bottom of the Eyk sidebar.

## Before you start

You need:

* Access to [OpenAI Ads Manager](https://ads.openai.com/) for the ad account you want to connect.
* Access to the **Sources** page in Eyk.

Setup has two parts. First you create an API key in OpenAI Ads Manager. Then you enter it in Eyk.

## Part 1: Create an API key in OpenAI Ads Manager

**1. Open Settings**

In [OpenAI Ads Manager](https://ads.openai.com/settings), open the ad account you want to connect and go to **Settings**.

**2. Create an API key**

Create an API key and copy it. You need it in Part 2. Each key belongs to 1 ad account.

## Part 2: Add the source in Eyk

**1. Open the source library**

In Eyk, go to **Sources** and click **Add new source**.

**2. Select OpenAI**

In the **Data source library**, click **Add** next to **OpenAI**.

**3. Enter your API key**

Paste the key from Part 1 under **API key**.

![OpenAI source form in Eyk with the API key field](https://mintcdn.com/eyk-data/bLMX2sfOr9PtO8G_/images/sources/openai-eyk-form.png?fit=max\&auto=format\&n=bLMX2sfOr9PtO8G_\&q=85\&s=5a294067fa9f9ed6ccb1d4b0e13a2d21)

**4. Add the source**

Click **Add source**.

## Check it worked

In Eyk, go to **Sources**. OpenAI is in the list with the text **Your data source is connected.** Eyk updates your BigQuery tables every night.

## Troubleshooting

> [accordion] OpenAI shows Attention needed
>
> Open the OpenAI source in Eyk and check the API key. If it no longer works, create a new key in OpenAI Ads Manager and enter it there.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.