跳转到主要内容

介绍

本指南将引导您如何跟踪联盟推荐、处理佣金事件,并通过 Dodo Payments 与可信的联盟合作伙伴关系来增加收入。我们提供与领先的联盟平台的集成,包括 AffonsoDub Partners,以帮助您无缝管理和跟踪您的联盟计划。

主要功能

自动佣金归属

无需电子表格或手动跟踪。推荐在购买时会自动归属和记录。

实时报告

您和您的联盟可以通过专用仪表板监控性能和潜在客户。

灵活的跟踪选项

使用跟踪脚本、元数据字段和 Webhook 事件来捕获注册和交易中的推荐数据。

完全加密和安全

所有敏感凭据和 Webhook 数据都使用一流的加密技术安全交换和存储。

快速设置

在几分钟内启动您的联盟计划——除了复制粘贴脚本片段和 API 令牌外,无需更改代码。

无缝集成

通过我们与 Affonso 和 Dub Partners 的集成,将联盟跟踪直接嵌入您的结账流程中,这些都是领先的联盟营销平台。

集成选项

Dodo Payments 与两个领先的联盟管理平台集成:
  • Affonso:一个全面的联盟管理平台,提供自动佣金跟踪、实时报告和专用的联盟仪表板。
  • Dub Partners:使用 Dub 的链接管理和转化跟踪为您的联盟计划提供详细的归因分析。
选择最适合您需求的平台,或者在不同的用例中同时使用两个平台。

Affonso 集成

我们与 Affonso 合作,这是一个领先的联盟管理平台,以推动您的销售。请按照以下步骤将您的 Dodo Payments 账户与 Affonso 连接,并开始跟踪联盟驱动的销售。
1

与 Dodo Payments 连接

要开始,请通过添加您的 API 密钥来连接您的 Dodo Payments 账户。

如何获取您的 Dodo Payments API 密钥

  • 登录到您的 Dodo Payments 仪表板
  • 在左侧菜单中转到 开发者 部分
  • 点击 API 密钥
  • 选择 添加 API 密钥
  • 给它命名(例如 “Affonso 集成”)
  • 点击 创建复制 您的 API 密钥

将您的 API 密钥添加到 Affonso

  • 通过 affonso.io 打开您的 Affonso 仪表板
  • 转到 程序详情 > 连接
  • 点击 Dodo Payments 集成 卡片
  • 粘贴您的 Dodo Payments API 密钥
  • 点击 连接
您的 API 密钥将由 Affonso 安全加密。
2

将 Webhook 添加到 Dodo Payments

连接后,您将从 Affonso 收到一个唯一的 webhook URL。这使得支付跟踪和联盟佣金触发成为可能。

在 Dodo Payments 中添加 Webhook URL

  • 在您的 Dodo Payments 仪表板中,转到 开发者 → Webhooks
  • 点击 添加 Webhook
  • 粘贴您的 Affonso webhook URL(来自您的程序设置)
  • 保存 webhook

在 Affonso 中添加 Webhook 密钥

  • 在 Dodo Payments 中保存 webhook 后,复制提供的签名密钥
  • 将其粘贴回 Affonso 的 Dodo Payments webhook 设置
这允许 Affonso 安全验证来自 Dodo Payments 的传入事件。
3

添加跟踪脚本

将 Affonso 像素放置在您的网站上,以开始跟踪联盟访问和转化。
<!-- Place in <head> tag -->
<script async defer
src="https://affonso.io/js/pixel.min.js"
data-affonso="YOUR_PUBLIC_PROGRAM_ID"
data-cookie_duration="YOUR_COOKIE_DURATION">
</script>
此脚本:
  • 跟踪联盟访问
  • 设置带有推荐 ID 的 cookie (affonso_referral)
  • 启用注册和支付跟踪
请将此放置在用户访问或转化的所有域上(例如,营销网站、应用程序)。
4

跟踪用户注册

为了获得漏斗可见性并优化联盟表现,请将用户注册跟踪为潜在客户。
// After successful registration
window.Affonso.signup(userEmail);
这将:
  • 如果用户通过联盟链接访问,则将新的推荐记录为 潜在客户
  • 在您的仪表板和联盟的统计数据中显示
最佳实践:在成功注册或双重选择(DOI)后触发此操作。
5

将推荐数据传递给 Dodo Payments

为了正确归因佣金,在结账时将推荐 ID 从 Affonso 传递给 Dodo Payments。

支付集成

import DodoPayments from 'dodopayments';

const referralId = window.affonso_referral;

const client = new DodoPayments({
  bearerToken: process.env['DODO_PAYMENTS_API_KEY'],
});

async function main() {
  const payment = await client.payments.create({
    payment_link: true,
    billing: { city: 'city', country: 'AF', state: 'state', street: 'street', zipcode: 0 },
    customer: { email: 'email@email.com', name: 'name' },
    product_cart: [{ product_id: 'product_id', quantity: 0 }],
    metadata: {
      affonso_referral: referralId,
    },
  });

  console.log(payment.payment_id);
}

main();

订阅集成

import DodoPayments from 'dodopayments';

const referralId = window.affonso_referral;

const client = new DodoPayments({
  bearerToken: process.env['DODO_PAYMENTS_API_KEY'],
});

async function main() {
  const subscription = await client.subscriptions.create({
    billing: { city: 'city', country: 'IN', state: 'state', street: 'street', zipcode: 89789 },
    customer: { customer_id: 'customer_id' },
    product_id: 'product_id',
    payment_link: true,
    return_url: 'https://example.com/success',
    quantity: 1,
    metadata: {
      affonso_referral: referralId,
    },
  });

  console.log(subscription.subscription_id);
}

main();

支付链接

// Original Dodo Payments Link
const originalLink = 'https://checkout.dodopayments.com/buy/<YOUR_PRODUCT_ID>';

// Append referral ID as reference_id
const linkWithReferral = `${originalLink}?metadata_affonso_referral=${window.affonso_referral}`;
有关更多详细信息,请参见 Dodo Payments API 文档
6

测试您的集成

在公开发布之前,使用实时联盟链接和测试交易测试您的设置。测试清单:
  • ✅ 创建一个联盟并生成跟踪链接
  • ✅ 通过联盟链接访问您的网站
  • ✅ 确保 Affonso 脚本加载并且 affonso_referral cookie 被设置
  • ✅ 完成注册(可选)
  • ✅ 通过 Dodo Payments 完成支付
  • ✅ 在您的 Affonso 仪表板中确认跟踪和归因

Dub Partners 集成

您还可以使用 Dub Partners 来跟踪联盟推荐和转化。Dub 的转化跟踪功能允许您将销售归因于您的联盟链接,提供有关哪些合作伙伴带来最多收入的详细分析。
有关详细的设置说明,请参见我们的 Dub 集成指南,其中涵盖如何跟踪销售转化事件并将收入归因于您的联盟链接。

使用 Dub Partners 快速设置

  1. 在您的 Dub 仪表板中为联盟链接 启用转化跟踪
  2. 在创建结账会话时 捕获 Dub 点击 ID (dub_id cookie)
  3. 在支付元数据中 存储点击 ID 以及客户信息
  4. 配置 webhook 集成,在支付成功时将销售数据发送到 Dub
该集成自动跟踪:
  • 一次性支付
  • 订阅激活
  • 定期订阅支付

了解更多

查看完整的 Dub 集成指南,其中包含代码示例和转换模板。

需要帮助吗?

如果您在集成过程中遇到任何问题或需要支持:

Affonso 支持

Dub 支持

Dodo Payments 支持

对于 Dodo Payments 特定的 API 查询,请参阅 docs.dodopayments.com 或联系我们的支持团队。

集成指南