跳转至

显示 Analytics 同意横幅

在欧盟和欧洲经济区地区，以下 DMA 法规自 2024 年 3 月 6 日起生效。

Alphabet、亚马逊、苹果、字节跳动、Meta、微软等把关者在收集个人信息以提供定制广告时必须获得用户的明确同意。

因此，如果您通过 Firebase 或欧盟和欧洲经济区地区的营销归因工具向 Google 传输数据，则必须获得这些地区用户的同意才能提供信息。

Hive SDK 提供了一个同意横幅显示功能，允许您检查您是否同意收集个人信息。

基本操作流程

如果您将个人信息收集协议应用于用户应用程序，它将从下面SDK操作流程的第3步开始运行。

  1. 在SDK初始化和登录期间显示的条款和条件协议
  2. CMP同意弹出窗口曝光，例如ADIZ
  3. 通过调用Analytics.showConsentModeIfRequire()有条件地曝光个人信息收集同意UI - 如果用户已经给予同意，则同意横幅U不显示，仅在截止日期已过或需要额外同意时显示
  4. 通过调用Analytics.showConsentMode()，个人信息收集同意的UI始终曝光
    - 如果之前已给予同意，则根据值设置同意状态曝光UI - 当[ConsentMode]对象参数设置为null时，Hive SDK会根据是否添加了第三方营销跟踪工具自动生成同意列表 - 设置按钮可以在应用内配置，以便用户可以随时重新同意并检查同意状态third-partyHive SDK

暴露同意横幅用户界面

Hive SDK 提供了通过 Analytics 的 ContentMode 类对象展示同意横幅 UI 的功能。

同意横幅用户界面设置主要分为“默认同意横幅用户界面”和“自定义同意横幅用户界面”，具体取决于ContentMode对象的功能参数设置。

默认同意横幅 UI 设置

如果您将[ConsentMode]对象参数输入为null，则根据是否添加了在Hive SDK中使用的第三方营销跟踪工具，下面将自动创建“基本同意列表”。

当您在应用中完成同意收集个人信息时，Hive SDK 可以通过回调确定您已对以下每个项目的值表示同意。

  • [ConsentMode.ConsentForm.providerName]: * "main": 常见的同意项 * "google", "adjust", "appsflyer", "singular" "airbridge: 默认同意横幅中包含的提供商项

自定义同意横幅 UI 设置

与Hive SDK提供的基本同意横幅UI不同，它包括与用户应用程序个性相匹配的UI和文本。 输入与[ContentMode]对象中提供的每个参数相对应的修改文本，如下所示。

  • ConsentMode.title: 这是显示在同意横幅顶部的文本。
  • ConsentMode.companyName: 当作为基本信息公开时，公司名称在 mainForm 的 dataUsageDescription 中与所需标题一起设置。
  • ConsentMode.privacyPolicy: 这是在您点击同意横幅底部的“隐私政策”按钮时运行的 URL。
  • ConsentMode.mainForm: 指定为默认同意项。如果您不同意 mainForm，则无法同意其他项。
  • ConsentMode.formList: 每个公司共享个人信息的同意项。
  • ConsentForm.providerName: 与同意主题对应的提供者名称。如果设置为 "main"，则该设置将与 ConsentMode.mainForm 设置相同。
  • ConsentForm.dataUsageTitle: 关于与 providerName 共享设备信息的标题文本。
  • ConsentForm.dataUsageDescription: dataUsageTitle 的详细信息。
  • ConsentForm.personalizationTitle: 同意提供个性化广告信息的标题短语。
  • ConsentForm.personalizationDescription: personalizationTitle 的详细信息。
  • ConsentStatus.providerName: 与同意主题对应的提供者名称。如果没有单独设置，将设置为 "main", * "google", "adjust", "appsflyer", "singular" "airbridge" 中的一个。
  • ConsentStatus.consentForDataUsage: 是否与 [providerName] 共享设备信息。根据用户的同意，设置 [Analytics.CONSENT_GRANTED] 或 [Analytics.CONSENT_DENIED] 值。如果第一次没有设置，将为 "not-set" 或空字符串。
  • ConsentStatus.consentForPersonalization: 是否与 [providerName] 共享个性化广告信息。根据用户的同意，设置 [Analytics.CONSENT_GRANTED] 或 [Analytics.CONSENT_DENIED] 值。如果第一次没有设置，将为 "not-set" 或空字符串。

与第三方同意管理平台（CMP）集成

通过使用符合TCF标准的文件，该文件在显示同意横幅弹出窗口时创建，您可以设置使同意横幅UI不会与第三方同意管理平台（CMP）重复显示。

当调用 Analytics.showConsentModeIfRequire() 时，如果 checkCmp 参数为真，并且根据 TCF 标准保存了文件，则读取该文件，并且文件中的公司同意设置。这将被视为如此。 checkCmp 参数的默认值为真。

例如，如果您使用 Adiz，您可以访问 Google AdMob 控制台，创建 GDPR 消息，然后尝试重置 Adiz。

为了避免在CMP中重复显示同意横幅，请按以下顺序进行合作伙伴设置。在将公司设置为合作伙伴之前，先设置需要同意的公司。有关设置的详细信息，请参阅 HIVE ADIZ > 创建GDPR消息。

  1. 点击左侧菜单中的 隐私与消息。- - 在欧洲法规菜单中，点击‘GDPR’ 设置。然后，输入您的消息并转到可以设置合作公司的页面。

    ![](https://developers.withhive.com/wp-content/uploads/2024/04/구글ump\_파트너-설정\_1.png){width="700"px}

  2. 点击审核广告合作伙伴 > 自定义广告合作伙伴下的编辑按钮。 然后，您可以查看广告合作伙伴的列表并进行编辑，以选择您需要的合作伙伴。

    ![](https://developers.withhive.com/wp-content/uploads/2024/04/구글ump\_파트너-설정\_2.png){width="700"px}

![](https://developers.withhive.com/wp-content/uploads/2024/04/구글ump\_파트너-설정\_3.png){width="700"px}

  3. 检查需要同意的公司的名称。（合作伙伴列表不提供搜索功能，因此使用 Ctrl+F 搜索会更方便。）

  4. 需要AppsFlyer同意 → 检查Appsflyer<

  5. 调整所需的同意 → 检查 Adjust GmbH

  6. 需要单一同意 → 检查 Singular Labs Inc. * ※ Google 被自动选中。 * ※ Airbridge 目前未列为合作伙伴。

    ![](https://developers.withhive.com/wp-content/uploads/2024/04/구글ump_파트너-설정_4.png){width="700px"}

  7. 保存后，您可以看到所选的合作伙伴公司在列表中显示。

    ![](https://developers.withhive.com/wp-content/uploads/2024/04/구글ump_파트너-설정_5.png){width="450px"}

设置 Hive SDK 分析同意横幅曝光

描述如何在 Hive SDK 开发环境中设置分析同意横幅的曝光。

Hive SDK Unity

  1. 从Unity项目顶部菜单中的Hive > Hive Dependencies窗口中打开Hive Dependencies。
  2. 通过勾选并保存如下所示，启用Analytics Consent-Mode选项。

Hive SDK 安卓原生

在应用级别的 build.gradle 中声明 'Analytics Consent-Mode' 库。

implementation "com.com2us.android.hive:hive-analytics-consent-mode:${HIVE_SDK_VERSION}" // Enter SDK version if not using BoM

Hive SDK iOS 原生

在您的Podfile中声明“分析同意模式”框架。

pod 'HiveAnalyticsConsentMode', '${HIVE_SDK_VERSION}' # Enter SDK version