OpenAI Ads（ChatGPT）归因与 CAPI

关注
Avatar
Samar Perka
Updated
设置 ChatGPT Ads
归因与 Conversions API
设置追踪链接与回传配置

本文介绍如何使用 Singular 的归因与 Conversions API，为移动应用广告系列、PC/主机安装以及网页广告系列设置 OpenAI Ads（ChatGPT）广告系列。

概述

Singular 的 web-to-app 归因方案让营销人员能够投放网页广告系列，在移动端、PC 和主机平台上带来应用安装。Singular 的 OpenAI Ads web-to-app 集成支持以下指南中所述的 Direct to Store 流程： 查看 Web to App 指南 。

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

在 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 。
    Singular 的 OpenAI Ads（ChatGPT）合作伙伴配置，已填写 Pixel ID 和 Conversions API Key 字段
  5. 如有需要，可配置要发送给 OpenAI 的其他事件，并将它们映射到“OpenAI Event Name”
    Singular 回传配置，将收入事件和应用内事件映射到 OpenAI 事件名称，并启用 Send All 和 Include Revenue
  6. 点击“ Save ”完成设置。
“OpenAI Ads (ChatGPT)”所需的事件属性

“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 链接

为“ChatGPT Ads”创建 Singular 链接

  1. 前往 Singular > Attribution > Manage Links
  2. 在左侧应用列表中选择您的移动应用
  3. 选择 "Create Link" -> Link Type "Partner" -> Source Name "OpenAI Ads (ChatGPT)"
  4. 按照分步流程完成链接创建。
  5. 点击 "Generate"
  6. 复制 "Click-through Tracking Link" 以用于下一步
设置您的 OpenAI Ads（ChatGPT Ads）广告系列

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

  1. 在 OpenAI Ads Manager 中创建广告系列，并继续进入 Ad Group 步骤。
  2. 将上文创建的 Singular 链接填入“Default Ad Destination URL”：
    OpenAI Ads 新建广告系列的广告组设置，Default Ad Destination URL 中填入了 Singular 的 sng.link 追踪链接

常见问题

Singular 如何报告 ChatGPT 归因？

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

  • Source = "ChatGPT"
  • Tracker Source Name = "ChatGPT"
在哪里可以找到 Pixel ID？
  1. 前往 OpenAI Conversions 页面。
  2. 选择“ Create ”，然后选择“Data Source”： OpenAI Ads Manager 的 Conversions 页面，Create new data source 对话框中将 Web 数据源命名为 Singular Pixel
  3. 完成后，复制新的 Pixel ID：
    OpenAI Ads Manager 的数据源列表，显示 Singular Pixel 条目及其名称下方的 Pixel ID
在哪里可以找到 Conversions API Key？
  1. 前往 OpenAI Conversions 页面。
  2. 选择“ Conversion keys ”，然后选择“Create new key”：
    OpenAI Ads Manager 的 Create New Conversion Key 对话框，名称为 Singular Conversions API Key
  3. 将新密钥复制到 Singular 的 Partner Configuration 中：
    OpenAI Ads Manager 的 Save your key 对话框，显示生成的密钥以及 Copy 和 Download 按钮
Singular 通过 API 发送哪些数据？
参数 详情
event_name
  • 标准事件或自定义事件的名称。该字段会自动映射到 Singular Event Name。此值用于帮助 OpenAI 对事件去重。event_id 参数同样用于去重。
哈希邮箱
  • 可选
  • 哈希邮箱可通过 Singular 埋点的事件属性“ehash”传递
  • 哈希邮箱的值必须先规范化，再进行 SHA-256 哈希处理
哈希外部用户 ID
  • 可选
  • 哈希外部 ID 可通过 Singular 埋点的事件属性“external_id_hash”传递
IP 地址
  • 客户端 IP 地址
用户代理
  • 客户端 User-Agent
用于事件去重（可选）
event_id
  • 去重所需的参数
  • 请使用以下属性名，在 Event Arguments 中将 event_id 值传递给 Singular：“ eventId ”。
  • event_id 参数必须 同时从 Conversions API 和 OpenAI Pixel 两端 添加到您的事件中。
  • event_id 参数是能够唯一区分相似事件的标识符。