跳轉至

显示分析同意横幅

在歐盟和歐洲經濟區地區，以下 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会根据是否添加了第三方营销跟踪工具自动生成同意列表 - 设置按钮可以在应用内配置，以便用户可以随时重新同意并检查同意状态第三方Hive SDK

曝露同意橫幅使用者介面

Hive SDK 提供透過 Analytics 的 ContentMode 類別物件的同意橫幅 UI 顯示功能。

同意橫幅 UI 設定主要根據 ContentMode 物件的功能參數設定分為「預設同意橫幅 UI」和「自訂同意橫幅 UI」。

預設同意橫幅 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 > Hive 依賴項。
  2. 通過勾選並保存如下所示，啟用分析同意模式選項。

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