跳转到主要内容

​
介绍

本指南将引导您如何跟踪联盟推荐、处理佣金事件，并通过 Dodo Payments 与可信的联盟合作伙伴关系来增加收入。

​
主要功能

自动佣金归属

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

实时报告

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

灵活的跟踪选项

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

完全加密和安全

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

快速设置

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

无缝集成

通过我们与领先的联盟营销平台 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 protected]', 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 仪表板中确认跟踪和归属

​
需要帮助吗？

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

Affonso 支持

Dodo Payments 支持

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