如何设置同意日志记录

同意日志记录（Consent DB）会记录用户的每一个同意事件，允许您通过 UUID 或用户身份查询和审计同意记录。本指南将引导您完成功能的启用和使用。

前提条件

• 必须由 UniConsent 为您的账户启用 Consent DB。请联系 support@uniconsent.com 启用此功能。
• 您必须使用企业版方案。

第 1 步：为项目启用 Consent DB

1. 在 UniConsent 控制台中进入项目设置
2. 滚动到 Consent Logging 部分
3. 将 Enable Consent Logging 切换为开启状态
4. 点击 Save，然后 Publish 您的更改

发布后，CMP 将自动开始向 Consent DB 发送同意事件。

第 2 步：关联用户身份（可选）

要将同意记录与您的用户关联（例如登录后），请在页面中添加以下代码：

<script>
window._unicData = window._unicData || [];
_unicData.push({
    user_ids: {
        auth_uid: 'your_user_id'
    }
});
</script>

此代码可以放置在页面的任何位置——CMP 脚本加载之前或之后均可。CMP 会获取用户 ID 并将其包含在同意事件中。

您可以包含多种身份类型：

_unicData.push({
    user_ids: {
        auth_uid: 'user_12345',
        email_hash: 'sha256_hash_of_email',
        customer_id: 'CUST-9876'
    }
});

第 3 步：在控制台中查看同意日志

1. 在侧边栏中，点击 Consent Data > Consent Logs
2. 顶部会显示关键指标：
   • Consent Records (30d) — 最近 30 天内的同意事件总数
   • Unique IDs — 所有时间内的唯一 UUID 总数
3. 使用 Search 部分查询日志：
   • By UUID — 输入同意 UUID 查找该设备的所有记录
   • By ID Type + Value — 选择 ID 类型（例如 auth_uid）并输入值，以跨设备查找记录

记录类型

每条记录会显示其内容类型：

GPP 字符串会完整记录，包含 GPP 头部，因此任何 GPP 解码器都可以读取。

第 4 步：添加自定义 ID 类型（可选）

如果您使用系统默认值之外的身份类型，可以添加自定义类型：

1. 在 Consent Logs 页面中，点击 Search 部分标题中的齿轮图标
2. 在 Custom ID Types 区域中，输入自定义类型名称（例如 loyalty_id）
3. 点击 Add

自定义 ID 类型将与系统默认值一起显示在搜索下拉菜单中。

示例：完整集成

<!-- UniConsent CMP tag (async) -->
<script async src='https://cmp.uniconsent.com/v2/YOUR_PROJECT_ID/cmp.js'></script>

<!-- Set user identity (works before CMP loads) -->
<script>
window._unicData = window._unicData || [];

// After user login, push their identity
function onUserLogin(userId, emailHash) {
    _unicData.push({
        user_ids: {
            auth_uid: userId,
            email_hash: emailHash
        }
    });
}
</script>

工作原理

1. CMP 脚本加载并读取启用了 enable_consentdb 的项目配置
2. 通过 _unicData.push() 设置的用户 ID 会被获取
3. 当用户给予或更新同意时，同意事件会连同用户 ID 一起发送到 Consent DB
4. 事件存储在 ClickHouse 中，可在控制台中进行查询

仍有疑问？

联系我们：support@uniconsent.com