Documentation

Description

OpenAI Ads is a paid advertising platform that places product, brand, and category ads inside ChatGPT and other OpenAI surfaces. The API exposes ad accounts, campaigns, ad groups, ads, and daily delivery insights so you can pull spend and performance into your analytics stack.

Follow this guide to connect OpenAI Ads to Improvado.

Step 1. Click the Make a new Connection on the Connections page. Categories on the Data sources page group all available platforms. Use a search to find the required one.

Step 2. Click on the OpenAI Ads tile.

Step 3. Authorize your OpenAI Ads account by providing the API key.

Note: You can get your API key in OpenAI Ads Manager under Settings → API keys. Sign in to ads.openai.com, open Settings → API keys, click Create new key, copy the value (it is shown only once at creation), and paste it into the Improvado authorization form. Each key is scoped to a single ad account.

Step 4. After the connection process is completed successfully, the OpenAI Ads connection will appear in your Connected sources list.

Step 5. When the connection status is Active and the account status column shows a number of accounts, you can move on to data extraction.

Step 6. To extract data from the connected source, check the instruction on how to set up data extraction.

The schema information shows all report types you can use to extract data from OpenAI Ads.