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 Partner 提供相应的确定性响应。这可能会导致 Google 与第三方之间报告的转化出现差异。

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

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

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

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

• Campaign ID
• Campaign Name

互动浏览是指用户观看视频广告持续超过 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 支持儿童应用。

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

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

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

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. 在您的 Podfile 中添加 GoogleAdsOnDeviceConversion pod。

      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
   • 确保将"-ObjC "添加到应用目标的"Other Linker Flags "中

   • 要让 Singular 收集 ODM 信息，请将 enableOdmWithTimeoutInterval 配置选项添加到 SingularConfig 中，用于初始化 Singular SDK。
     
     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

   • 要让 Singular 收集 ODM 信息，请添加 Enable ODM With Timeout Interval 配置选项（位于您的 SingularSDKObject 中）。
     
     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
   • 确保将"-ObjC "添加到应用目标的"Other Linker Flags "中

   • 要让 Singular 收集 ODM 信息，请将 enableOdmWithTimeoutInterval 配置选项添加到 SingularConfig 中，用于初始化 Singular SDK。
     
     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 的"限制数据共享"功能。

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

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

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

请参阅"通过限制数据共享支持用户隐私选择常见问题"

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

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

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

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

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