Logo文档

联盟营销

学习如何在 NEXTDEVKIT 中实现联盟跟踪

NEXTDEVKIT 通过集成的提供商支持联盟跟踪和管理。这允许您运行联盟计划、跟踪推荐并自动处理佣金支付。

支持的提供商

Affonso

Affonso 是一个综合性的联盟管理平台,与 Stripe 无缝集成,可实现自动跟踪和支付。

设置

要启用联盟功能,请完成以下步骤:

1. 创建联盟计划

1.1 Affonso 设置

  1. 注册:在 Affonso 注册。
  2. 创建联盟计划:设置您的计划,定义佣金费率。
  3. 连接 Stripe:按照联盟指示连接您的 Stripe 账户。
  4. 获取您的联盟 ID:在 Affonso 仪表板中找到您的联盟 ID。

以下是如何在 Affonso 仪表板中找到您的联盟 ID:

如何找到您的 Affonso 联盟 ID

2. 环境配置

将您的 Affonso 联盟计划 ID 添加到环境变量中:

NEXT_PUBLIC_AFFILIATE_AFFONSO_ID="your-affonso-id"

3. 配置

联盟配置位于 src/config/index.ts

src/config/index.ts
export const appConfig = {
  // ... 其他配置
  affiliate: {
    affonso: {
      enabled: true,
      id: process.env.NEXT_PUBLIC_AFFILIATE_AFFONSO_ID || "",
    },
  },
} as const satisfies AppConfig;

推荐跟踪

注册跟踪

当用户通过联盟链接注册时,注册会自动跟踪:

src/components/auth/signup-form.tsx
if (appConfig.affiliate.affonso.enabled) {
  window.Affonso.signup(values.email);
}

购买跟踪

联盟推荐在结账过程中自动跟踪:

src/components/marketing/pricing/pricing-card.tsx
const referralId = typeof window !== "undefined" ? window.affonso_referral : null;

const result = await createCheckoutLink({
  type: targetPrice.type,
  priceId: targetPrice.priceId,
  redirectUrl,
  referralId, // 传递给 Stripe 元数据
});

配置选项

Affonso 配置

选项类型描述
enabledboolean启用/禁用 Affonso 跟踪
idstring您的 Affonso 联盟计划 ID

Affonso 脚本会自动设置 30 天的 cookie 持续时间用于推荐跟踪。这可以在脚本配置中自定义:

data-cookie_duration="30" // 30 天