跳转到主要内容

​
介绍

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

​
主要功能

Automated Commission Attribution

无需电子表格或手动跟踪。当发生购买时，推荐会被自动归因并记录。

Real-Time Reporting

您和您的合作伙伴都可以从专用仪表板监控表现和线索。

Flexible Tracking Options

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

Fully Encrypted & Secure

所有敏感凭证和 webhook 数据都通过一流的加密方式安全交换和存储。

Quick Setup

在几分钟内启动您的推广计划——无需更改任何代码，只需复制粘贴脚本片段和 API 令牌。

Seamless Integration

通过我们与领先推广营销平台 Affonso 和 Dub Partners 的集成，将推广跟踪直接嵌入结账流程。

​
集成选项

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

​
Affonso 集成

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

Connect with 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

Add Webhook to 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

Add the Tracking Script

将 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

Track User Signups

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

Pass Referral Data to Dodo Payments

为正确归因佣金，请在结账时将 Affonso 的推荐 ID 传递给 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 documentation
6

Testing Your Integration

在公开发布之前，请使用实时推广链接和测试交易验证您的设置。测试清单：
  • ✅ 创建一个推广并生成跟踪链接
  • ✅ 通过推广链接访问您的网站
  • ✅ 确保 Affonso 脚本加载并设置了 affonso_referral cookie
  • ✅ 完成一次注册（可选）
  • ✅ 通过 Dodo Payments 完成一次支付
  • ✅ 确认 Affonso 仪表板中的跟踪和归因

​
Dub Partners 集成

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

​
使用 Dub Partners 快速设置

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

Learn More

查看完整的 Dub 集成指南，了解示例代码和转换模板。

​
需要帮助吗？

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

Affonso Support

Dub Support

Dodo Payments Support

如需有关 Dodo Payments 的 API 具体问题，请参考 docs.dodopayments.com 或联系我们的支持团队。

Integration Guides