API Connectors

users-love-us medal soc2
Send your OpenAI Ads / ChatGPT Ads data to
Data StudioGoogle SheetsChatGPTClaudePower BIExcelTableauGoogle BigQueryAmazon S3Azure Blob StorageSnowflakeMySQLPostgreSQLPythonAzure SQLAmazon RedshiftDatabricksWindsor MCPMicrosoft FabricCopilot AgentPerplexityLovableAntigravitySupabase

OpenAI Ads / ChatGPT Ads Connector Reference

6 metrics31 dimensions
Fields

The OpenAI Ads / ChatGPT Ads connector exposes 37 fields (6 metrics, 31 dimensions). Every field ID below can be passed to the Windsor.ai API in the fields parameter.


OpenAI Ads / ChatGPT Ads Fields

OpenAI Ads / ChatGPT Ads Insights fields

The Insights report of the OpenAI Ads / ChatGPT Ads connector includes 17 fields.

ID Type Name Description
TEXT Ad The name of the ad.
ad_account_id TEXT Ad Account ID The OpenAI ad account identifier.
ad_group TEXT Ad Group The name of the ad group.
ad_group_id TEXT Ad Group ID The unique identifier of the ad group.
ad_group_status TEXT Ad Group Status The delivery status of the ad group.
ad_id TEXT Ad ID The unique identifier of the ad.
ad_status TEXT Ad Status The delivery status of the ad.
campaign TEXT Campaign The name of the campaign.
campaign_id TEXT Campaign ID The unique identifier of the campaign.
campaign_status TEXT Campaign Status The delivery status of the campaign.
clicks NUMERIC Clicks The number of times the ad was clicked.
cpc NUMERIC CPC Average cost per click (spend divided by clicks).
cpm NUMERIC CPM Cost per thousand impressions.
ctr PERCENT CTR Click-through rate (clicks divided by impressions).
date DATE Date The date of the report metrics.
impressions NUMERIC Impressions The number of times the ad was shown.
spend NUMERIC Spend The amount of money spent on the ad.

OpenAI Ads / ChatGPT Ads other fields

The OpenAI Ads / ChatGPT Ads connector has 20 fields that do not belong to a named report, or belong to a report with only one or two fields.

ID Type Name Description Report
account_id TEXT Account ID Account ID in Windsor.ai. Accounts
account_name TEXT Account Name Account name in Windsor.ai. Accounts
data_fetched_at TIMESTAMP Data fetched at UTC timestamp (second precision) of when the connector request that pulled the row started. Freshly pulled rows show this request's start time; cache hits keep the start time of the request that filled the cache. Selecting this field disables aggregation, so rows are returned individually (each keeping its own fetch time) instead of being summed.
datasource TEXT Data Source The name of the Windsor connector returning the row
day_of_month TEXT Day of month Day of the month
month TEXT Month Number of the month
now TIMESTAMP Now Current timestamp
source TEXT Source The name of the Windsor connector returning the row
today DATE Today Today's date
week TEXT Week Week (Sun-Sat).
week_day TEXT Day of week and day number Weekday number and name combined (Sun-Sat).Numbered from 0 Sunday to 6 Saturday.
week_day_iso TEXT Day of week and day number, ISO Weekday number and name combined, ISO format (Mon-Sun).Numbered from 1 Monday to 7
week_iso TEXT Week ISO Week, ISO format (Mon-Sun).
year TEXT Year Year
year_month TEXT Yearmonth Year and month, e.g. 2024|3
year_month_name TEXT Year month name Year and month with the month name written out, e.g. "Jan 2025".
year_of_week TEXT Year of week The year that contains first day of the week (Sun-Sat).
year_of_week_iso TEXT Year of week, ISO The year that contains first day of the ISO week (Mon-Sun).
year_week TEXT Year week Year and week for US weeks (Sun-Sat), e.g. 2024|15
year_week_iso TEXT Year week ISO Year and week for ISO weeks (Mon-Sun), e.g. 2024|20