Dub

Dub 是一个开源的现代链接管理平台,适用于企业家、创作者和增长团队。

此插件允许您在用户使用 Dub 链接注册时跟踪潜在客户。它还添加了 OAuth 链接支持,以允许您构建扩展 Dub 链接管理基础设施的集成。

安装

安装插件

首先,安装插件:

npm install @dub/better-auth

安装 Dub SDK

接下来,在您的服务器上安装 Dub SDK:

npm install dub

配置插件

将插件添加到您的认证配置中:

auth.ts
import { betterAuth } from "better-auth"
import { dubAnalytics } from "@dub/better-auth"
import { dub } from "dub"

export const auth = betterAuth({
    plugins: [
        dubAnalytics({
            dubClient: new Dub()
        })
    ]
})

使用

潜在客户跟踪

默认情况下,该插件将跟踪注册事件作为潜在客户。您可以通过将 disableLeadTracking 设置为 true 来禁用此功能。

import { dubAnalytics } from "@dub/better-auth";
import { betterAuth } from "better-auth";
import { Dub } from "dub";

const dub = new Dub();

const betterAuth = betterAuth({
  plugins: [
    dubAnalytics({
      dubClient: dub,
      disableLeadTracking: true, // 禁用潜在客户跟踪
    }),
  ],
});

OAuth 链接

该插件支持用于账户链接的 OAuth。

首先,您需要在 Dub 中设置 OAuth 应用程序。Dub 支持 OAuth 2.0 认证,如果您构建扩展 Dub 功能的集成,则推荐使用此认证 了解更多关于 OAuth 的信息

获取客户端 ID 和客户端密钥后,您可以配置插件。

dubAnalytics({
  dubClient: dub,
  oauth: {
    clientId: "your-client-id",
    clientSecret: "your-client-secret",
  },
});

在客户端中,您需要使用 dubAnalyticsClient 插件。

import { createAuthClient } from "better-auth/client";
import { dubAnalyticsClient } from "@dub/better-auth/client";

const authClient = createAuthClient({
  plugins: [dubAnalyticsClient()],
});

要使用 Dub 链接账户,您需要使用 dub.link

POST
/dub/link
const { data, error } = await authClient.dub.link({    callbackURL: "/dashboard", // required});
PropDescriptionType
callbackURL
链接后重定向的 URL
string

选项

您可以向插件传递以下选项:

dubClient

Dub 客户端实例。

disableLeadTracking

禁用注册事件的潜在客户跟踪。

leadEventName

注册潜在客户的事件名称。

customLeadTrack

自定义潜在客户跟踪函数。

oauth

Dub OAuth 配置。

oauth.clientId

Dub OAuth 的客户端 ID。

oauth.clientSecret

Dub OAuth 的客户端密钥。

oauth.pkce

为 Dub OAuth 启用 PKCE。

On this page