Singular 通过与 Google Ads 的 App Conversion API 的自归因服务器到服务器集成来追踪 Google Ads 广告系列，其中包括：

• 追踪由您任何 Google Ads 广告系列带来的所有安装和再互动
• 点击归因和浏览归因

该集成使用一个 Link ID ，它在 Google Ads 中生成，且对每个应用唯一。一旦您的 Link ID 在 Singular 中配置完成，Singular 就会开始向 Google 发送所有安装、会话以及已配置的应用内转化事件。

利用 Google 返回的已归因点击信息，Singular 可以执行最后触点归因（请参阅 Singular 的归因流程 ），并使用您在 Google Ads 信息中心收到的相同细粒度广告系列信息，为您提供广告系列表现报告。

要开始追踪与 Google Ads 广告系列相关的转化和事件，您首先需要前往您的 Google Ads 帐号 设置您的转化操作 ——也称为 导入事件 。

请参阅 Google Ads 归因集成：如何导入事件 了解详细说明。

接下来，您可以配置并启动您的 Google Ads 广告系列。请按照 Google 的说明 了解更多关于您的选项以及如何配置它们的信息。

一旦追踪到归因，您的 Google Ads 广告系列就会出现在您的 Singular 报告界面中。

Singular 支持报告归因到的 Google Ads 应用广告系列数据，包括点击型和浏览型的安装与再互动。目前可用的数据包括 Google 广告系列 ID 、 广告系列名称 和 广告组 ID， 以及 Google 渠道（YouTube、展示广告、搜索）。这些数据在 Singular 中分别映射为"Campaign ID"、"Campaign Name"、"Sub Campaign ID"和"Sub Ad Network"。

请注意，Google Ads 中的 "conversions" 在 Singular 中既指 安装 ，也指 再互动 。

此外，正如 Google Ads 文档 中所述，Google Ads 与所有第三方之间存在固有的差异。

从 2020 年 1 月起，以安装为目标的搜索 App Campaigns 不再被 Google Ads 归因，因此不会显示在用户级报告中。如需了解更多信息，请参阅 Google 的 公告 。

请验证您的 Singular SDK 实现包含 深度链接和延迟深度链接支持 。

实现后，您与 Google 的 Singular 集成会自动为 使用 feed 的 Google 广告系列 启用延迟深度链接。

Google Ads 报告的应用转化可能包含确定性来源和建模来源的混合。请参阅 Google 的文档 ，了解建模转化可能如何影响您的广告系列。

由于建模转化无法追溯到某次特定的广告互动，因此 Google 无法向 Singular 或任何 Google 的 App Attribution Partners 提供相应的确定性响应。这可能会导致 Google 与第三方之间报告的转化出现差异。

选择退出用户的应用活动会在广告 ID 被清零的情况下报告给 Google，因此 Google 不会收到任何可个人识别的信息。

当 Google 投放广告时，如果启用了自动标记，他们还会附加"ID"：

• Gbraid (iOS)：附加到 iOS 14.5+ 点击上的标识符
• Gclid (Android、iOS)：Google 点击 ID

在这些广告启用了深度链接的情况下，当用户通过深度链接进入应用时，Singular SDK/S2S 集成会捕获这些 ID。Singular 会将任何可用的 ID 转发给 Google，这些 ID 在 Singular 中以自归因方式报告为再互动。对于"gbraid"，这些再互动归因的粒度会降低。基于"Gbraid"的再互动归因包含：

• 广告系列 ID
• 广告系列名称

互动浏览是指用户对视频广告的展示持续超过 10 秒。在 Google 和 Singular 的报告中，互动浏览被计为 点击归因 。

在 Singular 的用户级日志中，互动浏览转化会在归因到 Google 的转化/事件数据的"passthrough"字段中以 "interaction_type" = "engagement" 的形式报告。

在汇总报告中，互动浏览转化会以 "conversion type" = "click-through" 的形式报告。

Google 的集成转化衡量在您的第三方 App Attribution Partner 界面中，为您的 Google App 广告系列提供更实时、更全面、更准确的归因。它采用创新技术，例如使用事件数据的设备端转化衡量，在不损害用户隐私的前提下提高衡量准确性。其结果是即使缺少用户级标识符，也能获得事件级的洞察。

它涵盖：

• 拒绝 App Tracking Transparency (ATT) 的 iOS 14.5+ 用户
• 欧洲经济区 (EEA) 的 Android 用户，以及在 Android 上选择退出广告个性化设置的用户。
• ICM 支持儿童应用。

它不涵盖的内容

• ICM 不支持位于 EEA/英国地区的 iOS 设备。

Google Ads 的集成转化衡量仅支持点击型安装衡量。

集成转化衡量的归因在 Singular 中报告为

• 点击型
• 安装
• 以概率方式归因（明细仅在 Singular 用户级报告中提供）
• 不提供 Sub Network Type

iOS 集成转化衡量使用事件数据进行设备端衡量 ，它需要集成 Google 的 ODM SDK 以及更新 Singular SDK（或 S2S API）。

1. 使用以下三种方式之一，集成 Google 使用事件数据进行设备端衡量 (ODM SDK)：

   Google Analytics for Firebase Swift Package Manager Cocoapods

   请参阅 Google 的指南

   1. 在 Xcode 中，导航至 File > Add Packages 。
   2. 在出现的提示中，输入 GoogleAdsOnDeviceConversion GitHub 仓库： https://github.com/googleads/google-ads-on-device-conversion-ios-sdk
   3. 完成后，Xcode 将开始解析您的软件包依赖项并在后台下载它们。

   1. 将 GoogleAdsOnDeviceConversion pod 添加到您的 Podfile。

      pod 'GoogleAdsOnDeviceConversion'

   2. 运行

      pod install --repo-update

2. 更新 Singular SDK 或 S2S API 实现

   iOS SDK Unity SDK Flutter, React-Native, Cordova REST S2S API

   • 原生 SDK 最低版本 12.8.1
   • 确保在应用目标的" Other Linker Flags "中添加" -ObjC "

   • 在初始化 Singular SDK 时，通过向 SingularConfig 添加 enableOdmWithTimeoutInterval 配置选项，让 Singular 收集 ODM 信息。
     
     enableOdmWithTimeoutInterval 设置一个以秒为单位的超时值。建议使用 5 秒的超时值。该超时值设置了 Singular SDK 在安装后首次启动时，延迟初始化以等待来自 ODM SDK 的 ODM 信息的最长时间。

     重要： 等待来自 ODM SDK 的 ODM 信息的过程会延迟 Singular SDK 回调，例如 Singular 深度链接回调处理程序。因此，深度链接可能会被延迟

     
     Swift:

     config.enableOdmWithTimeoutInterval = 5

     Objective C:

     config.enableOdmWithTimeoutInterval = 5;

   • Unity SDK 最低版本 v5.5.0

   • 在您的 SingularSDKObject 中添加 Enable ODM With Timeout Interval 配置选项，让 Singular 收集 ODM 信息。
     
     Enable ODM With Timeout Interval 设置一个以秒为单位的超时值。建议使用 5 秒的超时值。该超时值设置了 Singular SDK 在安装后首次启动时，延迟初始化以等待来自 ODM SDK 的 ODM 信息的最长时间。

     重要： 等待来自 ODM SDK 的 ODM 信息的过程会延迟 Singular SDK 回调，例如 Singular 深度链接回调处理程序。因此，深度链接可能会被延迟

     
     

   • Flutter SDK 最低版本 v1.8.0
   • React-Native SDK 最低版本 v3.9.0
   • Cordova SDK 最低版本 v1.8.0
   • 确保在应用目标的" Other Linker Flags "中添加" -ObjC "

   • 在初始化 Singular SDK 时，通过向 SingularConfig 添加 enableOdmWithTimeoutInterval 配置选项，让 Singular 收集 ODM 信息。
     
     enableOdmWithTimeoutInterval 设置一个以秒为单位的超时值。建议使用 5 秒的超时值。该超时值设置了 Singular SDK 在安装后首次启动时，延迟初始化以等待来自 ODM SDK 的 ODM 信息的最长时间。

     重要： 等待来自 ODM SDK 的 ODM 信息的过程会延迟 Singular SDK 回调，例如 Singular 深度链接回调处理程序。因此，深度链接可能会被延迟

     config.enableOdmWithTimeoutInterval = 5

   1. 在应用首次启动后不久获取设备端信息
      
      Swift:

      import GoogleAdsOnDeviceConversion
      
      // Set the time when the app was first launched.
      ConversionManager.sharedInstance.setFirstLaunchTime(Date())
      
      // Fetch the conversion info.
      ConversionManager.sharedInstance.fetchAggregateConversionInfo(for: .installation)
      { aggregateConversionInfo, error in
         guard error == nil else { return }
         guard let info = aggregateConversionInfo else {
            // Troubleshoot:
            // 1. Check that the Date passed to setFirstLaunchTime() was when the app
            //    first launched.
            // 2. Check that your app is running in an approved region.
            return
         }
         guard info.count  0 else { return }
      
         print("Conversion info \(info)")
         // Use info as the value in the odm_info query parameter in
         // the App Conversion API detailed in Step 6.
         // For example, if info is "abcdEfadGdaf", then odm_info=abcdEfadGdaf.
      }

      
      Objective C:

      @import GoogleAdsOnDeviceConversion;
      
      // Set the time when the app was first launched.
      [[ODCConversionManager sharedInstance] setFirstLaunchTime:[NSDate date]];
      
      // Fetch the conversion info.
      [[ODCConversionManager sharedInstance]
         fetchAggregateConversionInfoForInteraction:ODCInteractionTypeInstallation
         completion:^(NSString * _Nullable aggregateConversionInfo,
                      NSError * _Nullable error) {
         if (error) {
            return;
         }
         if (aggregateConversionInfo.length == 0) {
            // Troubleshoot:
            // 1. Check that the NSDate passed to setFirstLaunchTime() was when the app
            //    first launched.
            // 2. Check that your app is running in an approved region.
            return;
         }
      
         NSLog(@"Conversion info %@", aggregateConversionInfo);
         // Use aggregateConversionInfo as the value in the odm_info query parameter in
         // the App Conversion API detailed in Step 6.
         // For example, if aggregateConversionInfo is "abcdEfadGdaf",
         // then odm_info=abcdEfadGdaf.
      }];

      重要：

      • 此步骤是一个异步操作，因此可能需要您在其完成前不要发送 Session 事件。
      • 收集 odm_info 并将其共享到您的应用存储中，以便您可以在首次会话时附加它。此值将通过 "odm_info" 参数传递给 Singular 的 S2S API
      • 如果出现错误，请收集该错误。此值将通过" odm_error "参数传递给 Singular 的 S2S API
      • 请注意，随 setFirstLaunchTime 传递的日期时间戳不应与通过" utime "参数传递给 Singular S2S API 的安装时间戳有显著差异。
   2. 将设备端信息传递给 Singular 的 S2S API
      
      对于每个应用安装会话 (install=true)， 将 ODM info 和 ODM error 包含在 Singular S2S /launch 端点中。

何时以及如何为 EEA 用户收集用户同意信号，应遵循您企业和应用对用户隐私的要求。请咨询您企业的法律顾问，以了解您的应用需要如何遵守内部隐私政策以及 GDPR、ePrivacy 指令和数字市场法案等隐私法规。

如果您决定收集用户同意信号，通常建议：

• 仅在用户明确选择加入或退出时才设置用户同意信号。如果用户未做出选择，建议将 LDS 保持未设置状态。用户信号的缺失可能很重要。
• 用户同意信号通常在应用体验中的"隐私选择"或"隐私设置"中收集。
• 在可能的情况下，并根据您应用的同意提示设计和策略，在应用流程的早期展示隐私提示，以确保 Singular 和其他 SDK 能够尽早收集用户同意信号
  

如果您的企业确定针对 EEA 用户的欧盟隐私法规适用于您的应用： 请根据您的应用向这些用户展示的同意提示，实现 Singular SDK/S2S 的"Limit Data Sharing"功能。

如果您的企业确定欧盟隐私法规不适用于您的应用 ，您可以在 Singular 中选择退出 EEA 用户同意信号。请在合作伙伴配置的"User Privacy"部分下勾选"EEA opt-out"选项。使用此选项后，Google 不会使用 LDS 和用户同意信号。

• 如果使用此选项，则 不需要 为 EEA 用户实现 LDS
• 此选项可以在 Google 的 3 月更新上线之前启用

Singular 的 Limit Data Sharing (LDS) 是一项功能，允许应用开发者向 Singular 传递每个用户的用户同意信号。LDS 按用户设置，可以在 SDK 初始化之前或之后设置。LDS 用于 Singular 用户隐私回传，并传递给 Google 等特定合作伙伴，他们会用它来遵守自己的数据实践。

请参阅" 通过 Limit Data Sharing 支持用户隐私选择常见问题 "

Google 列出了支持所需用户同意信号的 同意管理平台 (CMP)。如果您使用其中一个 CMP，您可以提取用户同意信号，并 通过 Singular 的 LimitDataSharing 功能传递它们 。

对于选择退出用户同意的 EEA 用户：

• 在 Singular 中将无法获得对 Google Ads 广告系列的用户级归因。Google 将无法向 MMP 报告这些归因
• Google Ads 将为这些用户建模转化，这反映在 Singular 从 Google Ads 数据连接器中拉取的汇总网络指标中。
• Google Ads 将无法将这些用户的数据用于广告目的

对于选择加入用户同意的 EEA 用户：

• 可以实现对 Google Ads 广告系列的用户级归因
• Google Ads 将把这些数据用于广告目的