Singular通过与Google Ads的App Conversion API进行服务器到服务器的自归因整合，跟踪Google Ads广告活动，其中包括

• 跟踪由谷歌广告活动驱动的所有安装和重新吸引活动
• 点击和浏览归因

集成使用链接 ID，该ID 由 Google Ads 生成，每个应用程序都是唯一的。一旦在 Singular 中配置了链接 ID，Singular 就会开始向 Google 发送所有安装、会话和配置的应用内转换事件。

利用从谷歌返回的归属点击信息，Singular 可以执行最后接触归因（请参阅Singular 的归因流程），并使用您在谷歌广告控制面板中收到的相同细粒度广告活动信息，为您提供广告活动绩效报告。

要开始跟踪与 Google Ads 广告系列相关的转换和事件，您首先需要进入 Google Ads 账户设置转换操作（也称为导入事件）。

请参阅Google Ads Attribution Integration：有关详细说明，请参阅《如何导入事件》。

接下来，您可以配置并启动 Google 广告系列。请按照Google 的说明了解更多选项和配置方法。

一旦追踪到归因，您的谷歌广告活动就会出现在Singular报告界面。

Singular支持报告Google Ads应用程序广告系列的点击、观看、安装和重新吸引数据。目前，可用数据包括Google 广告系列 ID、广告 系列名称、广告组 ID 以及 Google 频道（Youtube、展示、搜索）。这些数据在 Singular 中分别映射为 "广告系列 ID"、"广告系列名称"、"子广告系列 ID "和 "子广告网络"。

请注意，Google Ads 中的"转换 "指的是 Singular 中的安装和重新吸引。

此外，Google Ads 和所有第三方之间存在固有差异，详见 GoogleAds 文档。

自 2020 年 1 月起，Google Ads 不再归因于搜索安装的应用程序广告系列，因此用户级报告中不会显示。有关详细信息，请参阅 Google公告。

验证您的 Singular SDK 实施是否支持深度链接和延迟深度链接。

一旦实施，您的Singular与谷歌的集成将自动为使用Feeds的谷歌广告系列启用延迟深度链接。

谷歌广告报告的应用程序转换可能包含确定来源和模型来源的混合。请参阅Google 文档，了解模型转化可能对您的广告系列产生的影响。

由于建模转化与单个特定广告互动无关，因此 Google 无法向 Singular 或任何 Google 的应用归因合作伙伴提供相应的确定性响应。这可能会导致谷歌和 3Ps 报告的转化率出现差异。

退出用户的应用程序活动会报告给谷歌，但广告 ID 已清零，因此谷歌不会收到任何个人身份信息。

当启用自动标记时，谷歌在提供广告时也会附加 "ID"：

• Gbraid（iOS）：附加到 iOS 14.5+ 点击的标识符
• Gclid（安卓、iOS）：谷歌点击 ID

如果这些广告启用了深度链接，当用户深度链接到应用程序时，Singular SDK/S2S 集成会捕获 ID。Singular 会将任何可用的 ID 转发给谷歌，谷歌会在 Singular 中将这些 ID 自归属地报告为再次点击。在使用 "gbraid "的情况下，这些再接触归因的粒度会降低。基于 "Gbraid "的再接触归因有

• 营销活动 ID
• 营销活动名称

参与观看是指用户对视频广告的印象持续时间超过 10 秒。在 Google 和 Singular 的报告中，"参与观看 "被视为点击归因。

在 Singular 的用户级日志中，"engagedview "转化会在 "passthrough "字段中的 "interaction_type"="engagement "下报告归因于谷歌的转化/事件数据。

在汇总报告中，参与视图转换是在"转换类型"="点击 "下报告的。

Google 的 "综合转化衡量 "可在第三方应用归因合作伙伴界面中为您的 Google 应用营销活动提供更实时、更全面、更准确的归因。它采用了创新技术，如使用事件数据进行设备上转换测量，以提高测量的准确性，同时不会损害用户隐私。即使缺少用户级标识符，也能获得事件级洞察力。

它涵盖

• 拒绝接受应用程序跟踪透明度 (ATT) 的 iOS 14.5+ 用户
• 欧洲经济区（EEA）的安卓用户

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

• 点击
• 安装
• 归因于概率（细分仅适用于 Singular 用户级报告）

iOS 集成转换测量使用事件数据进行设备上测量，需要集成谷歌的 ODM SDK 以及 Singular SDK（或 S2S API）更新。

1. 使用这三个选项中的任何一个集成谷歌使用事件数据的设备上测量（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. 更新奇异 SDK 或 S2S API 实现

   Singular SDK (Native)Singular SDK (Unity)Singular SDK (Flutter, React-Native, Cordova)Singular 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 中添加 "Enable ODM With Timeout Interval（启用超时间隔的 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. 在应用程序首次启动后不久获取设备上的信息
      
      斯威夫特

      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），都要向Singular S2S /launch端点提供 ODM 信息和 ODM 错误信息。

何时以及如何收集 EEA 用户的同意信号应符合您的业务和应用程序对用户隐私的要求。请咨询您企业的法律顾问，了解您的应用程序需要如何遵守内部隐私政策和隐私法规，如 GDPR、ePrivacy Directive 和 Digital Markets Act。

如果您决定收集用户同意信号，一般建议如下：

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

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

Singular的限制数据共享（LDS）是一项允许应用程序开发者将每个用户的用户同意信号传递给Singular的功能。LDS是按用户设置的，可以在SDK初始化之前或之后设置。LDS 用于 Singular 用户隐私回传，并传递给某些合作伙伴（如谷歌），后者使用它来遵守自己的数据惯例。

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

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

从 2024 年 3 月开始

对于选择退出用户同意的欧洲经济区用户：

• Singular中将无法提供谷歌广告活动的用户级归因。 Google 将无法向 MMP 报告这些属性
• 谷歌广告将为这些用户建立转化模型，这将反映在Singular从谷歌广告数据连接器中提取的聚合网络指标中。
• 谷歌广告无法将这些用户数据用于广告目的

对于选择用户同意的欧洲经济区用户：

• 谷歌广告活动的用户级归因是可能的
• 谷歌广告将把这些数据用于广告目的