Consent DB API（仅限企业版）

Consent DB 允许您实时记录、存储和查询同意记录。启用后，每个同意事件都会被记录，包括用户的 UUID、同意字符串、IP 地址和可选的身份映射。

Consent DB 仅面向企业版账户提供。如需启用，请联系 support@uniconsent.com。

JavaScript Data Layer API

Consent DB 使用与 Google Tag Manager 的 dataLayer 类似的数据层模式。您可以随时向 window._unicData 推送数据——无论是在 CMP 脚本加载之前还是之后。

设置

<script>
window._unicData = window._unicData || [];
</script>

设置用户 ID

将用户身份（例如登录后）关联到同意 UUID。这些 ID 将包含在所有后续的同意日志事件中。

window._unicData = window._unicData || [];
_unicData.push({
    user_ids: {
        auth_uid: 'user_12345',
        email_hash: 'sha256_of_email'
    }
});

您可以多次推送——用户 ID 会被合并：

_unicData.push({ user_ids: { auth_uid: 'user_12345' } });
_unicData.push({ user_ids: { loyalty_id: 'LY9876' } });
// Result: { auth_uid: 'user_12345', loyalty_id: 'LY9876' }

发送身份事件

要立即发送身份事件，将用户 ID 关联到同意 UUID，而无需等待同意操作：

_unicData.push({
    event: 'send_identity',
    user_ids: {
        auth_uid: 'user_12345'
    }
});

支持的 ID 类型

以下是可用的系统默认 ID 类型：

• auth_uid — 已认证的用户 ID
• email — 电子邮件地址
• email_hash — 经过哈希处理的电子邮件地址
• phone — 电话号码
• phone_hash — 经过哈希处理的电话号码
• customer_id — 客户 ID
• crm_id — CRM ID

您还可以在控制台中的 Consent Logs > Search > Settings（齿轮图标）下自定义 ID 类型。

获取 Consent UUID

您可以从用户本地存储的 __unid 键中获取同意 UUID，也可以通过 JavaScript API 获取：

__unicapi('getConsentId', 2, (consentId) => {
    console.log(consentId);
});

控制台

启用 Consent DB 后，侧边栏的 Consent Data 下会出现 Consent Logs 页面。控制台提供以下功能：

• 指标 — 同意记录数量（最近 30 天）和唯一 ID 数量
• 搜索 — 通过 UUID 查询日志，或通过 ID 类型和值查询（例如查找特定 auth_uid 的所有同意记录）
• 记录表 — 时间、项目、UUID、同意类型、IP（已脱敏）、页面 URL、同意字符串、用户 ID

查询同意日志

按 UUID 查询

在 UUID 搜索框中输入同意 UUID，即可查找特定设备或浏览器的所有同意记录。

按用户身份查询

选择 ID 类型（例如 auth_uid）并输入 ID 值，即可查找与该身份关联的所有跨设备同意记录。

还有问题？

请联系我们：support@uniconsent.com