> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.
# 合作伙伴
> 通过 Dodo Payments 启动和管理您的联盟计划，同时处理交易。
## 介绍
本指南将引导您如何跟踪联盟推荐、处理佣金事件，并通过 Dodo Payments 与可信的联盟合作伙伴关系来增加收入。我们提供与领先的联盟平台的集成，包括 **Affonso** 和 **Dub Partners**，以帮助您无缝管理和跟踪您的联盟计划。
## 主要功能
无需电子表格或手动跟踪。当发生购买时，推荐会被自动归因并记录。
您和您的合作伙伴都可以从专用仪表板监控表现和线索。
使用跟踪脚本、元数据字段和 webhook 事件来捕获注册和交易期间的推荐数据。
所有敏感凭证和 webhook 数据都通过一流的加密方式安全交换和存储。
在几分钟内启动您的推广计划——无需更改任何代码，只需复制粘贴脚本片段和 API 令牌。
通过我们与领先推广营销平台 Affonso 和 Dub Partners 的集成，将推广跟踪直接嵌入结账流程。
## 集成选项
Dodo Payments 与两个领先的联盟管理平台集成：
* **[Affonso](https://affonso.io)**：一个全面的联盟管理平台，提供自动佣金跟踪、实时报告和专用的联盟仪表板。
* **[Dub Partners](https://dub.co)**：使用 Dub 的链接管理和转化跟踪为您的联盟计划提供详细的归因分析。
选择最适合您需求的平台，或者在不同的用例中同时使用两个平台。
## Affonso 集成
我们与 Affonso 合作，这是一个领先的联盟管理平台，以推动您的销售。请按照以下步骤将您的 Dodo Payments 账户与 Affonso 连接，并开始跟踪联盟驱动的销售。
要开始，请通过添加 API 密钥连接您的 Dodo Payments 账户。
### 如何获取您的 Dodo Payments API 密钥
* 登录到您的 **Dodo Payments 仪表板**
* 在左侧菜单中转到 **开发者** 部分
* 点击 **API 密钥**
* 选择 **添加 API 密钥**
* 给它命名（例如 "Affonso 集成"）
* 点击 **创建** 并 **复制** 您的 API 密钥
### 将您的 API 密钥添加到 Affonso
* 通过 [affonso.io](https://affonso.io/) 打开您的 **Affonso 仪表板**
* 转到 **程序详情 > 连接**
* 点击 **Dodo Payments 集成** 卡片
* 粘贴您的 Dodo Payments API 密钥
* 点击 **连接**
您的 API 密钥将由 Affonso 安全加密。
连接后，您会从 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 的传入事件。
将 Affonso 像素放置在您的网站上以开始跟踪推广访问和转化。
```html theme={null}
```
此脚本：
* 跟踪推广访问
* 设置一个包含推荐 ID 的 cookie（`affonso_referral`）
* 允许注册和支付跟踪
请将其放在所有用户访问或转化的域名上（例如营销网站、应用）。
为了获得漏斗可视性并优化推广表现，请将用户注册跟踪为线索。
```js theme={null}
// After successful registration
window.Affonso.signup(userEmail);
```
这将：
* 如果用户通过联盟链接访问，则将新的推荐记录为 **潜在客户**
* 在您的仪表板和联盟的统计数据中显示
最佳实践：在成功注册或双重选择加入（DOI）后触发此操作。
为正确归因佣金，请在结账时将 Affonso 的推荐 ID 传递给 Dodo Payments。
### 支付集成
```js theme={null}
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();
```
### 订阅集成
```js theme={null}
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();
```
### 支付链接
```js theme={null}
// Original Dodo Payments Link
const originalLink = 'https://checkout.dodopayments.com/buy/';
// Append referral ID as reference_id
const linkWithReferral = `${originalLink}?metadata_affonso_referral=${window.affonso_referral}`;
```
更多详情请参阅 [Dodo Payments API documentation](https://docs.dodopayments.com/api-reference/introduction)
在公开发布之前，请使用实时推广链接和测试交易验证您的设置。
**测试清单：**
* ✅ 创建一个推广并生成跟踪链接
* ✅ 通过推广链接访问您的网站
* ✅ 确保 Affonso 脚本加载并设置了 `affonso_referral` cookie
* ✅ 完成一次注册（可选）
* ✅ 通过 Dodo Payments 完成一次支付
* ✅ 确认 Affonso 仪表板中的跟踪和归因
## Dub Partners 集成
您还可以使用 [Dub Partners](https://dub.co) 来跟踪联盟推荐和转化。Dub 的转化跟踪功能允许您将销售归因于您的联盟链接，提供有关哪些合作伙伴带来最多收入的详细分析。
有关详细的设置说明，请参阅我们的 [Dub integration guide](/integrations/dub)，其中介绍了如何跟踪销售转化事件并将收入归因于推广链接。
### 使用 Dub Partners 快速设置
1. **在您的 Dub 仪表板中为推广链接启用转化跟踪**
2. **在创建结账会话时捕获 Dub 点击 ID**（`dub_id` cookie）
3. **将点击 ID** 与客户信息一起存储在支付元数据中
4. **配置 webhook 集成**，在支付成功时将销售数据发送到 Dub
该集成自动跟踪：
* 一次性支付
* 订阅激活
* 定期订阅支付
查看完整的 Dub 集成指南，了解示例代码和转换模板。
## 需要帮助吗？
如果您在集成过程中遇到任何问题或需要支持：
* 通过 [affonso.io](https://affonso.io/) 上的 **实时聊天** 与我们交流
* 通过 **[support@affonso.io](mailto:support@affonso.io)** 给我们发送邮件
* 访问 [Dub documentation](https://dub.co/docs) 查看转化跟踪指南
* 通过其 [dashboard](https://app.dub.co) 联系 Dub 支持
如需有关 Dodo Payments 的 API 具体问题，请参考 docs.dodopayments.com 或联系我们的支持团队。
* [Affonso Integration](#affonso-integration)（上文）
* [Dub Partners Integration](/integrations/dub)