OpenAI Ads (ChatGPT) 数据连接器

关注
Avatar
Fernando Cabral
Updated
设置 ChatGPT Ads 
数据连接器（成本聚合）
设置数据连接器 

 

添加数据连接器

  1. 在 Data Integrations > Data Connectors，点击 Add Data Connector，然后搜索连接器“ChatGPT (OpenAI Ads)”。
    Singular Data Connectors page with ChatGPT typed in the connector search and the Add Data Connector button highlighted
     
  2. 粘贴您的 OpenAI Ads API key。要生成密钥，请前往您的 OpenAI Ads Manager 账户，打开 Settings 标签页并生成 API 密钥。
    OpenAI Ads Manager Settings page with the Create New API Key dialog, naming the key Singular API Key
    Singular ChatGPT Configuration panel with the OpenAI Ads API key entered and Automatically pull historical data checked
  3. 点击 Submit。
     

快速详情

API Version API (OpenAI Ads API v1, https://api.ads.openai.com/v1)
身份验证 在 OpenAI Ads Manager 中于以下位置生成的 Bearer API 密钥： Settings。每个广告账户一个密钥。
数据分类（细分）

OpenAI Ads 按以下所有维度提供您的数据（术语请参见下方的数据映射）：

  • 账户
  • 广告系列
  • 子广告系列（OpenAI 的 "Ad Group"）
  • 创意（OpenAI 的 "Ad"）

国家并非作为报表分类维度返回，而是从每个广告系列的定向设置中推导得出。请参阅已知限制。
我们从多长时间前提取数据 Singular 每天提取过去 7 天的数据。
时区 在 OpenAI 账户中配置的时区。
创意（广告）层面的数据可用吗？ 是。
Singular 是否会显示您的创意资产？ 是。Singular 会提取每个广告的创意类型、标题、正文、目标 URL 和图片 URL。
已知限制/问题 请参阅下方的已知限制。

数据映射

术语说明：

  • "Campaign" 在 Singular 中对应 "Campaign" （OpenAI Ads）。
  • "Sub-Campaign" 对应 OpenAI 的 "Ad Group"
  • "Creative" 对应 OpenAI 的 "Ad"

有关所有字段的说明，请参阅 Singular 指标与维度术语表。

Field in Singular UI Field in Singular API Field in OpenAI Ads
Dimensions
Account ID adn_account_id id from /v1/ad_account
Account Name adn_account_name name from /v1/ad_account
Network Campaign ID adn_campaign_id campaign_id
Network Campaign Name adn_campaign_name campaign_name
Network Sub Campaign ID adn_sub_campaign_id ad_group_id
Network Sub Campaign Name adn_sub_campaign_name ad_group_name
Network Creative ID adn_creative_id ad_id
Network Creative Name adn_creative_name ad_name
Country country_field Derived from the campaign's targeting.locations.countries
Date date_field Given as a parameter when querying OpenAI Ads (time_ranges[], daily granularity)
Metrics
Cost adn_cost spend
Impressions adn_impressions impressions
Clicks adn_clicks clicks

成本以广告账户的货币报告，取自 OpenAI 广告账户的 currency_code。

创意资产

Singular 会使用从 OpenAI 的以下端点提取的创意元数据来丰富每个广告： /v1/ads 包括创意类型、标题、正文、目标 URL 和图片 URL，以及广告的状态和审核状态。这些数据支撑创意预览和 Creative IQ 报表。

 

常见问题与故障排查

Singular 从 OpenAI Ads 提取哪些指标？

在 OpenAI Ads 提供的指标中，Singular 集成会收集与效果营销相关的指标：

  • Impressions
  • Clicks
  • Cost

OpenAI Ads 目前不会通过报表 API 返回安装量或转化量，因此您 Singular 报表中的 Installs 指标仅来自 Singular 自身的归因。

为什么我的成本报表中看不到来自 OpenAI 的转化或安装数据？

OpenAI 的报表 API 会返回花费、展示次数和点击次数。归因的安装和应用内事件来自 Singular 自身的归因流程，并通过共享的 Campaign、Sub-Campaign 和 Creative ID 与 OpenAI 的成本数据关联。正是这一点让 Singular 能够展示 OpenAI Ads 花费的 ROI 和 eROAS。

要使这种关联生效，您的广告系列必须使用 Singular 追踪链接。请参阅 OpenAI Ads 归因指南。
 

我可以将多个 OpenAI 广告账户接入 Singular 吗？

 

可以，但每个 API 密钥只对应一个广告账户，因此每个广告账户需要一个数据连接器。或者，您可以向 OpenAI 广告主支持团队申请多账户 API 访问权限。

我可以将 OpenAI Ads 的原始数据导入自己的数据仓库吗？

可以。Singular 的 Extract 产品可将 OpenAI Ads 数据直接送入您的 BI 技术栈，包括 campaign、ad group、ad 和 insights 数据流。请参阅 将 OpenAI Ads 作为 Extract 数据源。

 

已知限制
  • 每个广告账户一个 API 密钥。 除非 OpenAI 授予多账户 API 访问权限，否则多个广告账户需要多个数据连接器。
  • 国家由广告系列定向推导得出，且仅反映定向列表中的第一个国家。 OpenAI 的 insights 端点不返回地理分类，因此 Singular 依据广告系列的定向设置。对于定向多个国家的广告系列，默认仅将定向列表中的第一个国家作为 'Country' 维度报告。