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

• 追踪由您任何 Google Ads 广告系列驱动的所有安装和再互动
• 点击归因与展示归因

该集成使用Link ID，该ID 在 Google Ads 中生成且对每个应用都是唯一的。一旦在 Singular 中配置了Link ID，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中分别映射为“广告系列ID”、“广告系列名称”、“子广告系列ID”和“子广告网络”。

请注意，Google Ads 中的“转化”在 Singular 中同时指代安装和再互动。

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

自 2020 年 1 月起，Google Ads 不再对“搜索安装应用广告系列”进行归因，因此这些数据不会显示在用户级报告中。如需了解更多信息，请参阅 Google的公告。 

请确认您的 Singular SDK 实现已包含对深度链接和延迟深度链接的支持。 

一旦完成集成，Singular 与 Google 的集成将自动为使用数据源的 Google 广告系列启用延迟深层链接。

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

由于建模转化无法追溯到单一具体的广告互动，Google 无法向 Singular 或任何 Google 应用归因合作伙伴提供相应的确定性响应。这可能会导致 Google 与第三方平台报告的转化数据存在差异。

已选择退出用户的应用活动在上报给 Google 时，其广告 ID 会被清零，因此 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 的集成转化测量可在您的第三方应用归因合作伙伴界面中，为您的 Google 应用广告系列提供更实时、更全面且更准确的归因分析。该功能融合了创新技术（例如利用事件数据进行设备端转化测量），在确保用户隐私不受影响的前提下提升测量精度。即使缺少用户级标识符，也能提供事件级别的洞察。

其覆盖范围包括：

• 拒绝应用跟踪透明度（ATT）的 iOS 14.5 及以上版本用户
• 欧洲经济区（EEA）内的 Android 用户，以及在 Android 设备上已关闭广告个性化设置的用户。

Google Ads 的整合转化测量仅支持点击安装测量。

在 Singular 中，集成转化测量归因将报告为

• 点击安装
• 安装
• 归因类型为概率归因（详细分解仅在 Singular 用户级报告中提供）

iOS 整合式轉換追蹤採用基於事件資料的裝置端追蹤技術，需整合 Google 的 ODM SDK 以及 Singular SDK（或 S2S API）的更新。

1. 请通过以下三种方式之一集成 Google 的基于事件数据的设备端测量（ODM SDK）：

   Google Analytics for FirebaseSwift Package ManagerCocoapods

   参阅Google 指南

   1. 在 Xcode 中，导航至“文件”>“添加包”。
   2. 在弹出的提示框中，输入GoogleAdsOnDeviceConversionGitHub 仓库地址：https://github.com/googleads/google-ads-on-device-conversion-ios-sdk
   3. 完成后，Xcode 将开始解析您的包依赖项并在后台下载。

   1. 在您的 Podfile 中添加GoogleAdsOnDeviceConversionpod。

      pod 'GoogleAdsOnDeviceConversion'

   2. 运行

      pod install --repo-update

2. 更新 Singular SDK 或 S2S API 实现

   iOS SDKUnity SDKFlutter, React-Native, CordovaREST S2S API

   • 原生 SDK 最低版本12.8.1
   • 确保在应用目标的“其他链接器标志”中添加“-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 中添加“启用 ODM 并设置超时间隔”配置选项，允许 Singular 收集 ODM 信息。
     
     “启用 ODM 并设置超时间隔”需设置 以秒为单位的超时 值。建议使用 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”

   • 通过在初始化 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.
      }];

      重要提示：

      • 此步骤为异步操作，因此可能需要您在操作完成前暂勿发送会话事件。
      • 收集odm_info并将其保存至应用存储，以便在首次会话中进行追加。该值将通过“odm_info”参数传递给 Singular 的 S2S API
      • 如果发生错误，请收集错误信息。该值将通过“odm_error”参数传递给 Singular 的 S2S API
      • 请注意，通过setFirstLaunchTime传递的日期时间戳不应与通过“utime”参数传递给 Singular S2S API 的安装时间戳存在显著差异。
   2. 将设备端信息传递给 Singular 的 S2S API
      
      对于每个应用安装会话（install=true），请将 ODM 信息和 ODM 错误包含在发送至Singular S2S /launch端点的请求中。

何时以及如何收集 EEA 用户的同意信号，应遵循贵公司及应用程序对用户隐私的要求。请咨询贵公司的法律顾问，以了解您的应用程序如何遵守内部隐私政策以及 GDPR、电子隐私指令和《数字市场法案》等隐私法规。

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

• 仅在用户明确选择加入或退出时设置用户同意信号。若用户未做出选择，建议保持 LDS 未设置状态。用户信号的缺失可能具有重要意义。
• 用户同意信号通常在应用使用过程中的“隐私选择”或“隐私设置”环节收集。
• 在条件允许的情况下，并根据您应用的同意提示设计和策略，请在应用流程的早期阶段显示隐私提示，以确保 Singular 及其他 SDK 能尽早收集用户同意信号
   

如果贵公司确定欧盟针对欧洲经济区（EEA）用户的隐私法规适用于您的应用：请根据应用向这些用户展示的同意提示，实施 Singular SDK/S2S 的“限制数据共享”功能。

 

如果贵公司确定欧盟隐私法规不适用于您的应用，您可以在 Singular 中选择退出 EEA 用户同意信号。请在合作伙伴配置的“用户隐私”部分中勾选“EEA 选择退出”选项。启用此选项后，Google 将不再使用 LDS 和用户同意信号。


 

• 启用此选项后，无需为EEA 用户实施 LDS
• 此选项可在 Google 三月更新上线前启用

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 将使用这些数据用于广告投放