@cacic-fct/ 账户管理者- 隐私

从账户 API 读取 CACiC 账户隐私偏好时的角客户端.

安装

从公共 npm 注册处安装 Bun :

bun add @cacic-fct/account-manager-privacy

使用

import { CacicAccountPrivacyService, provideCacicAccountPrivacy } from '@cacic-fct/account-manager-privacy';

当账户 API 基础 URL 与默认不同时, 将提供者添加到应用程序配置中 :

providers: [
  provideCacicAccountPrivacy({
    apiBaseUrl: 'https://account.cacic.com.br/api',
  }),
];

弹出 CacicAccountPrivacyService 读取诸如 analyticsEnabled, (中文(简体) ), errorDebuggingEnabled, (中文(简体) ), performanceMonitoringEnabled,以及 cookieBannerAccepted。 。 。 .

使用 refreshTrackingCookies() 在登录/ 会话刷新后要求账户管理器刷新共享的 CACiC 分析 cookie 。 使用 clearTrackingCookies() 在双胞胎应用程序中登出时,然后重新定向.

Umami 跟踪助手

静态站点可以使用浏览器帮助在加载 Umami 之前尊重账户管理器隐私设置 :

import { initCacicUmamiTracking } from '@cacic-fct/account-manager-privacy/umami-tracking';

await initCacicUmamiTracking({
  websiteId: 'your-umami-website-id',
  domains: ['cacic.com.br'],
});

帮助者刷新 /api/tracking/session,读取共享的 CACiC 饼干,当账户管理器拥有时加载 Umami analytics_tracking 启用和调用 umami.identify() 与 cacic-analytics-id 饼干作为美美的区别ID。 匿名访客没有被跟踪 identify() 除非一个同意饼干明确禁止分析。 Cookie横幅接受情况在识别有效载荷中单独报告。 它不会发送电子邮件、名称或配置字段,除非呼叫者明确通过 identifyData。 。 。 .

通过只制作的脚本标记配置分析器的站点可以使用当前标注的靴子:

import { startCacicUmamiTrackingFromCurrentScript } from '@cacic-fct/account-manager-privacy/umami-tracking';

startCacicUmamiTrackingFromCurrentScript({
  identifyData: {
    source: window.location.hostname,
  },
});

出版

这个包具有独立的放出周期. 更新情况 libs/account-privacy 触发软件包的发布工作流程,从而撞出这个软件包自己的 version 在合并应公布的更改之前. CI 工作流程通过 Trusted Publishing 发布此软件包至 npm.