UniConsent

Leading Consent Management Platform

Compliant with GDPR, CCPA, COPPA, LGPD, PECR, PDPA, PIPEDA, and more.

Get Started

如何将 UniConsent CMP 与 AAP/MMP Firebase SDK 集成

Firebase Analytics 是经认证的 Google Mobile Measurement Partner (MMP) 和 App Attribution Partner (AAP)。本指南介绍如何将 UniConsent 同意管理平台 (CMP) 与 Firebase Analytics 集成，以确保用户同意信号被正确传递用于归因和分析目的。

Android 集成

UniConsent CMP 会自动检测 Firebase Analytics 的存在，并使用 Firebase Analytics SDK API 传输同意信号。

第 1 步：初始化 Firebase SDK 和 UniConsent CMP SDK

有关完整设置的详细信息，请参阅 Firebase Android SDK 初始化指南。

第 2 步：在 handle(Event event) 回调中开始使用 Firebase

确保在 CMP 回调中开始使用 Firebase，以便在用户同意可用时进行操作：

override fun handle(event: Event?) {
    // Example: send Firebase event or other analytics metrics
    Bundle bundle = new Bundle();
    bundle.putString(FirebaseAnalytics.Param.ITEM_ID, "id");
    bundle.putString(FirebaseAnalytics.Param.ITEM_NAME, "name");
    bundle.putString(FirebaseAnalytics.Param.CONTENT_TYPE, "image");
    mFirebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_CONTENT, bundle);
}

预期结果

集成成功后，您会看到类似以下的调试日志：

Sending consent signal to FirebaseAnalytics

此外，在过滤 com.uniconsent.sdk.aap 的日志时，您应该会看到类似以下的确认信息：

Successfully set consent signal to FirebaseAnalytics: {AD_USER_DATA=GRANTED, AD_STORAGE=GRANTED, AD_PERSONALIZATION=GRANTED, ANALYTICS_STORAGE=GRANTED}

这些日志确认 UniConsent 已成功将用户同意选择传递给 Firebase Analytics，以实现正确的归因处理。

iOS 集成

在 iOS 上，UniConsent CMP 同样会自动检测 Firebase Analytics 并使用相应的 SDK API 发送同意信号。

预期结果

正确集成后，调试日志将包含：

Sending consent signal to FirebaseAnalytics

在过滤 com.uniconsent.sdk.aap 的日志时，您应该会看到：

Successfully set consent signal to FirebaseAnalytics: {AD_USER_DATA=GRANTED, AD_STORAGE=GRANTED, AD_PERSONALIZATION=GRANTED, ANALYTICS_STORAGE=GRANTED}

这些日志确认 UniConsent 已将适当的同意信号传输给 Firebase Analytics，以满足归因合规要求。

在 Firebase 日志中确认同意设置

要验证同意设置是否已正确传递给 Firebase，您可以启用详细日志并检查日志输出。

第 1 步：启用详细日志

运行以下命令启用 Firebase Analytics 的详细日志：

adb shell setprop log.tag.FA VERBOSE

第 2 步：过滤日志

过滤以 Setting consent 开头的日志条目。您应该会看到类似以下的日志，表明同意已成功应用：

Setting consent, ... AD_STORAGE=granted

注意

为确保用户同意可用，请务必在 CMP 的 override fun handle(event: Event?) (Android) 或 public func onDismiss() (iOS) 回调中调用 MMP/AAP API。

在以下指南中了解更多关于 UniConsent SDK API 的信息：

总结

通过将 UniConsent CMP 与 Firebase Analytics 集成，您可以确保应用在遵守同意法规的同时，继续享受 Firebase AAP 和 MMP 功能带来的优势。

如需进一步帮助，请参阅 UniConsent SDK 官方文档或联系我们的支持团队。