DMA同意橫幅的顯示

自2024年3月6日起，因應歐盟和歐洲經濟區內強制性的DMA法規，Google要求在這些地區通過Firebase或行銷歸因工具傳送廣告/測量數據至Google時，必須獲得明確的用戶同意。

像Alphabet、Amazon、Apple、ByteDance、Meta和Microsoft等守門人必須在收集個人信息以提供個性化廣告時獲得用戶的明確同意。

為了解決這個問題，Hive SDK 提供了 DMA 同意橫幅曝光功能 以支持 Google 的「歐盟用戶同意政策」合規性。

當應用**DMA同意橫幅曝光**功能時，您可以顯示一個橫幅，以檢查用戶對於為廣告和測量目的收集個人信息的同意。

基本操作流程¶

當個人資訊收集同意應用於您的應用程式時，它將從以下SDK操作流程的**第3步**開始運作。

在SDK初始化和登錄期間顯示服務條款同意
顯示CMP同意彈出窗口，例如ADIZ
調用Analytics.showConsentModeIfRequire()來有條件地顯示個人資訊收集同意UI
- 如果用戶已經同意，則不顯示同意橫幅UI。只有在同意過期或需要額外同意時才會顯示。
- 當[ConsentMode]對象參數設置為null時，根據是否將第三方營銷追蹤工具添加到Hive SDK，自動生成同意列表
調用Analytics.showConsentMode()來始終顯示個人資訊收集同意UI
- 如果有先前的同意記錄，則根據該值顯示設置的UI
- 應用內設置按鈕可以配置，以便用戶可以隨時再次同意或檢查同意狀態
- 當[ConsentMode]對象參數設置為null時，根據是否將第三方營銷追蹤工具添加到Hive SDK，自動生成同意列表

Hive SDK 通過 Hive Analytics 的 ContentMode 類對象提供同意橫幅 UI 顯示功能。

同意橫幅 UI 配置根據 ContentMode 物件的功能參數設置大致分為「默認同意橫幅 UI」和「自定義同意橫幅 UI」。

當 [ConsentMode] 物件參數設置為 null 時，根據是否將第三方行銷追蹤工具添加到 SDK，自動生成以下「預設同意列表」。

當用戶在應用程式中完成個人信息收集同意時，Hive SDK 通過回調傳遞每個項目的同意結果。
通過回調傳遞的值以 ConsentStatus 對象的列表形式提供。

id: 同意項目的唯一識別碼
- 用途 ad_user_data、ad_personalization、analytics_storage
- 每個 MMP 供應商對於 ad_personalization 目的: google、adjust、appsflyer、singular、airbridge
granted: 同意項目的同意狀態
- Analytics.CONSENT_GRANTED 表示已同意，Analytics.CONSENT_DENIED 表示已拒絕
consentDate: 用戶做出同意決定的時間（以毫秒為單位）
expiredDate: 同意過期的時間（以毫秒為單位）

與 Hive SDK 提供的預設同意橫幅 UI 不同，這包括可以自訂的 UI 和文本，以符合您應用程式的特徵。輸入與下方所示的 [ContentMode] 物件提供的每個參數對應的修改文本。

ConsentMode.title: 顯示在同意橫幅頂部的文本。
ConsentMode.companyName: 在顯示基本信息時，必須提供公司名稱，並在同意表單的標題和內容中設置。
ConsentMode.privacyPolicy: 當按下同意橫幅底部的「隱私政策」按鈕時運行的 URL。
ConsentMode.adUserData: 用於廣告用戶數據使用的同意項目 (ad_user_data)。
ConsentMode.adPersonalization: 用於個性化廣告使用的同意項目 (ad_personalized)。
ConsentMode.analyticsStorage: 用於分析和統計數據收集的同意項目 (analytics_storage)。 (目前僅支持「Google」)
ConsentForm.id: 同意項目的唯一標識符。可以包括目的 (ad_user_data, ad_personalization, analytics_storage) 以及每個 MMP 廠商的個性化廣告目的 ("google", "adjust", "appsflyer", "singular", "airbridge")。
ConsentForm.title: 同意項目的標題文本。
ConsentForm.content: 同意項目的描述文本。
ConsentStatus.id: 同意項目的唯一標識符。參考 ConsentForm.id 內容。
ConsentStatus.granted: 同意項目的同意狀態值。當同意時為 Analytics.CONSENT_GRANTED，當拒絕時為 Analytics.CONSENT_DENIED。

在顯示同意橫幅彈出窗口時，您可以通過利用符合 TCF 標準的文件來配置，以避免與第三方同意管理平台 (CMP) 顯示重複的同意橫幅 UI。

當調用 Analytics.showConsentModeIfRequire() 並將 checkCmp 參數設置為 true 時，如果根據 TCF 標準存儲了文件，則該文件將被讀取並視為已配置同意。 checkCmp 參數的默認值為 true。

例如，使用 ADIZ 时，您可以访问 Google AdMob 控制台以创建 GDPR 消息，然后初始化 ADIZ。有关详细的配置信息，请参阅 Hive ADIZ > 创建 GDPR 消息。

本節說明如何在開發環境中為每個 Hive SDK 引擎配置同意橫幅曝光。

在應用層級的 build.gradle 中聲明 'Analytics Consent-Mode' 庫。


implementation "com.com2us.android.hive:hive-analytics-consent-mode:${HIVE_SDK_VERSION}"    // 輸入 Hive SDK 版本，當不使用 BoM 時

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


pod 'HiveAnalyticsConsentMode', '${HIVE_SDK_VERSION}'       # 输入 SDK 版本