(转换 API）谷歌广告离线转换 API

关注
Avatar
Jonathan Chen
Updated
文档
网页、电脑和控制台事件的转换回传仅适用于使用Singular网页、电脑和控制台游戏归因的Singular客户。

Singular与谷歌广告离线转换API（也称为uploadClickConversions）的集成允许广告商向谷歌发送Singular归因的谷歌广告点击转换。 Singular网络、PC和控制台测量均支持该集成。 关于Singular与Google Ads的移动测量集成，请参阅我们帮助中心的相关文章。

如何配置谷歌广告离线转化 API 集成

  1. 确保您的网络、电脑或控制台应用程序与 Singular 集成
  2. 转到 Singular > 归因 > 合作伙伴配置
  3. 单击"添加合作伙伴"，然后键入并选择"Google Ads Offline Conversions API (S2S)
  4. 添加或选择现有用户授权 Singular
  5. 在对话框中，选择要配置的应用程序和应用程序站点（平台）。请注意，此集成仅支持网页、PC 和控制台应用程序
  6. 在"客户 ID"下输入您的 Google Ads 客户 ID。您可以在 Google Ads 面板的右上角找到您的客户 ID。不需要连字符。

    如果您有多个 Google Ads 帐户为您的应用程序运行广告系列，则需要使用经理 (MCC) 帐户的"客户 ID"，通过使用经理 (MCC) 帐户进行跨帐户转换跟踪。有关配置 MCC 帐户的指南，请参阅 Google帮助中心的文章。
  7. 仅适用于 PC 和控制台应用程序：在您的 Google Ads 账户中，为"安装"创建一个转换操作。复制并粘贴创建的"安装转换操作 ID"。
  8. 在您的 Google Ads 账户中，为您要发送的任何其他事件创建一个转换行为，并将每个事件映射到相应的"转换行为 ID"。
  9. 单击"保存"完成。

常见问题

如何为 Google Ads 转换 API 创建转换操作？
  1. 点击"新建转换操作


  2. 选择"导入


  3. 选择"使用 API 或上传手动导入"->"跟踪来自点击的转换"

    注意：在 MCC 账户中可能看不到"使用 API 或上传手动导入"选项。在这种情况下，请选择"其他数据源或 CRM"、"跟踪来自点击的转化 "和"跳过此步骤并稍后设置数据源"，继续创建转化操作。

  4. 继续按照 Google 的提示配置转换详细信息。完成后点击"创建并继续

  5. 回到"转换目标"页面，找到您刚刚创建的转换操作，点击它查看详细信息


  6. 在转换操作"详细信息"页面，从 URL 参数 "ctId="中复制 "转换操作 ID



  7. 在提示输入 "转换动作ID"时，将此"转换动作ID"粘贴到Singular合作伙伴配置中。
如何为 Google Ads 转换 API 创建转换操作（更新用户界面）？
  1. 单击"创建">"新转换操作


  2. 如果尚未选择，请选择 "离线转换">"继续
  3. 如果您尚未设置任何离线转换，则可能会看到此页面。选择"跳过此步骤，稍后设置数据源"。
  4. 选择要测量的标准转换操作。
  5. 单击"为此类别添加事件">"离线数据源"
重要事项在此集成中不应使用 "应用程序安装 "转换操作。您应该使用 "转换 "中的 "离线转换操作 "之一，为 "Web 到应用程序安装 "创建一个新的转换操作。
  1. 在刚刚添加的转换操作旁边，单击设置
  2. 将转换操作名称更改为您所需的转换操作名称，并更新转换操作设置，使其与您所需的测量和优化目标相一致。然后单击保存。
  3. 单击保存并继续
  4. 单击完成
  5. 现在，您应该可以在 "摘要 "屏幕中看到您的转换操作。转换源应该是"网站（从点击导入）"。在完成全部设置，Singular 开始向 Google 发送属性事件之前，状态为 "非活动 "是正常的。。
  6. 点击转换操作，然后从 url 浏览器地址栏复制 ctld 值
  7. 将ctld值添加到您的Singular谷歌广告网络事件合作伙伴配置中
Singular通过离线转换API发送哪些数据？
参数 详细信息
gclid, gbraid (coming soon), wbraid (coming soon)
  • 自动传递
hashed email
  • 可选
  • 散列电子邮件可作为奇异工具事件属性"ehash"传递
  • 哈希电子邮件值必须经过规范化和 SHA 256 哈希处理
hashed phone number
  • 可选项
  • 散列电话号码可作为奇异事件属性"phashE164"传递
  • 哈希电话号码必须经过E164标准化和 SHA 256 哈希处理
回传失败的原因是"USER_PERMISSION_DENIED"。

如果授权用户没有配置 MCC 账户的权限，则会出现此错误。

要解决这个问题，请进入您的 Google Ads 账户，并确保您在 Singular 中的授权用户拥有配置的 MCC 账户的全部权限。

回传失败的原因是"CUSTOMER_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS"。

如果您未同意 Google 的增强型转换处理条款，则会出现此错误。

要解决这个问题，请进入 Google Ads 账户，在侧边菜单中进入"设置"，选择 "目标"下的"转化"页面，然后打开 "增强转化"（Enhanced Conversions for leads），如下图所示：

有关详细信息，请参阅此处的 Google Ads 文档。

Google Ads Offline Conversions API 有哪些限制？
  • 仅支持点击转化
  • 不支持建模
Google Ads Offline Conversions API 支持移动事件吗？
  • 只有在使用 Singular 的移动网站到应用程序归因流程（即谷歌广告点击→使用 SingularWebSDK 的广告主自有登陆页面→Singular 移动网站到应用程序点击→安装）时，才能为移动应用程序网站配置谷歌 OCI 回传以发送应用程序事件。
  • 如果在谷歌网络营销活动中使用了直接从广告点击到商店的流程（即谷歌广告点击→应用商店），请使用谷歌广告网络集成来代替。
  • 此集成不适用于标准移动应用程序安装和重定向营销活动。请使用Google Ads 移动应用程序营销活动集成来开展移动营销活动。