在 Singular 中添加 ChatGPT Ads 合作伙伴配置

1. 前往 Singular > Attribution > Partner Configuration
2. 点击“ Add a Partner ”，然后输入并选择“ OpenAI Ads (ChatGPT) ”
3. 在弹出窗口中，选择要配置的应用及应用/网站（平台）。该集成支持移动端、网页、PC 和主机应用
4. 从以下位置复制并粘贴“ Pixel ID ”和“ Conversions API Key ”： OpenAI Ads Manager 。 请为您配置的所有平台使用相同的 Pixel ID 和 Conversions API Key，而不要为每个平台分别创建。请参阅下文的网页和移动应用需要单独的 Pixel ID 吗？。
   
   
5. 如有需要，可配置要发送给 OpenAI 的其他事件，并将它们映射到“OpenAI Event Name”
   
   
6. 点击“ Save ”完成设置。

“OpenAI Ads (ChatGPT)”集成所需的事件属性

如需启用 OpenAI Ads（ChatGPT）集成，请实现并发送以下事件属性。这些属性区分大小写。

移动端

请发送以下事件属性：

• ehash ：用户邮箱地址在去除首尾空格并转换为小写后的 SHA-256 哈希值。
• external_id_hash （可选）：您系统中稳定的匿名客户标识符的 SHA-256 哈希值。
  • 如有可能，请同时发送 ehash 和 external_id_hash 以提升匹配率。如果无法获取 ehash ，请至少发送 external_id_hash 。

网页

请发送以下事件属性：

• page_url （必填）：事件发生页面的完整 URL（例如 https://shop.example.com/checkout/confirmation ）。
• ehash ：用户邮箱地址在去除首尾空格并转换为小写后的 SHA-256 哈希值。
• external_id_hash （可选）：您系统中稳定的匿名客户标识符的 SHA-256 哈希值。
  • page_url 为必填项。对于用户相关字段，如有可能请同时发送 ehash 和 external_id_hash 以提升匹配率。如果无法获取 ehash ，请至少发送 external_id_hash 。

为“ChatGPT Ads”创建 Singular 链接

1. 前往 Singular > Attribution > Manage Links
2. 在左侧应用列表中选择您的移动应用
3. 选择 "Create Link" -> Link Type "Partner" -> Source Name "OpenAI Ads (ChatGPT)"
4. 按照分步流程完成链接创建。
5. 设置重定向目标。这是用户在未安装应用时的跳转位置。默认值为您应用的商店 URL。若要将这些用户引导至您的网站，请选择 Web URL 选项并填入目标地址。在网站上完成转化的网页广告系列应使用此选项。
6. （可选）如需额外的参数或宏，请在Additional Parameters部分添加。请在此处添加，而不要事后直接修改已生成的链接。
7. 点击 "Generate"
8. 复制 "Click-through Tracking Link" 以用于下一步

生成的链接已包含广告系列参数和 OpenAI Ads 动态宏。所有参数都会转发至重定向目标，Singular Web SDK 在该处读取这些参数以归因网页转化。生成的链接形如：

https://yourapp.sng.link/XXXXX/YYYY?_dl=yourapp%3A%2F%2Fmy_default_deeplink&_smtype=3&wpcl={oppref}&wpscid={ad_group_id}&pcid={campaign_id}&_forward_params=1&pscid={ad_group_id}&pcrid={ad_id}&wpcrid={ad_id}&cl={oppref}&wpsrc=ChatGPT%20Web%20CAPI&wpcid={campaign_id}

设置您的 OpenAI Ads（ChatGPT Ads）广告系列

1. 在 OpenAI Ads Manager 中创建广告系列，并继续进入 Ad Group 步骤。
2. 将上文创建的 Singular 链接填入“Default Ad Destination URL”：
   
3. 请保留链接中的宏，不要修改。OpenAI Ads 会在点击时替换 {campaign_id}、{ad_group_id}、{ad_id}、{oppref}，因此广告系列的细分数据无需任何手动替换即可传送至 Singular。

归因被追踪后，ChatGPT 归因将按以下方式报告：

• Source = "ChatGPT"
• Tracker Source Name = "ChatGPT"

1. 前往 OpenAI Conversions 页面。
2. 选择“ Create ”，然后选择“Data Source”：
3. 完成后，复制新的 Pixel ID：
   

不需要。OpenAI Pixel ID 应按广告主、品牌或集成合作伙伴目标各使用一个，而不是按平台划分。在 Singular 中，网页、iOS 和 Android 的测量均使用相同的 Pixel ID 和 Conversions API Key。

Singular 会自动为每个事件设置平台：网页事件为 action_source: "web"，iOS 和 Android 事件为 action_source: "mobile_app"。这一项无需任何配置。

OpenAI 目前不支持原生移动数据源，因此没有应用类型的数据源可供创建。请创建一个网页数据源，并将其 Pixel ID 用于您所测量的所有平台。

1. 前往 OpenAI Conversions 页面。
2. 选择“ Conversion keys ”，然后选择“Create new key”：
   
   
3. 将新密钥复制到 Singular 的 Partner Configuration 中：
   
   

每个广告系列维度都会出现两次。应用侧参数用于归因应用安装，网页侧参数则由 Singular Web SDK 读取，用于归因在您网站上发生的转化。一条链接同时服务于这两种结果。

该链接还包含以下控制参数：

• wpsrc=ChatGPT%20Web%20CAPI 用于设置 Singular 网页归因的 Source，是 OpenAI Ads 回传得以触发的必要条件。请勿修改。
• _forward_params=1 将链接参数转发至商店和网页重定向目标。
• _dl 保存应用已安装时链接所打开的深度链接目标。
• _smtype=3 会在追踪链接启用概率归因时添加。如果该链接关闭了概率归因，则不会添加此参数。

追踪链接采集的是广告系列、广告组和广告的 ID，而非名称。Singular 从 OpenAI Ads Data Connector 获取名称，并与链接中采集到的 ID 进行匹配，因此报告中会针对点击和安装显示可读的名称。

这也是名称不放在链接上的原因。ID 是稳定的关联键，因此广告系列即使被重命名，历史点击的报告仍然准确。