---
title: "Tích hợp Paddle với Adapty Attribution"
description: "Kết nối tài khoản Paddle của bạn với Adapty Attribution để gán các giao dịch mua, gia hạn, hoàn tiền và tranh chấp từ web-funnel cho các quảng cáo đã tạo ra chúng."
---

> **AI agents**: to search Adapty docs faster and with fewer tokens, install the Adapty skill. Claude Code (self-updating via plugin): `claude plugin marketplace add adaptyteam/adapty-sdk-integration-skill && claude plugin install adapty-sdk-integration@adapty` — other tools: `npx skills add adaptyteam/adapty-sdk-integration-skill --all`

Kết nối tài khoản Paddle của bạn với Adapty Attribution để gán các giao dịch mua hàng trong web funnel của bạn cho các quảng cáo đã dẫn dắt chúng. Sau khi kết nối, các giao dịch mua hàng, gia hạn, hoàn tiền và chargeback từ Paddle sẽ xuất hiện trong phân tích Adapty Attribution, và các sự kiện chuyển đổi có thể được gửi ngược lại cho các mạng quảng cáo để tối ưu hóa chiến dịch.

## Cách hoạt động \{#how-it-works\}

1. [Web pixel của Adapty](ua-web-pixel) gán cho mỗi khách truy cập funnel một click ID và thu thập dữ liệu quảng cáo từ URL landing page.
2. Tại bước thanh toán, funnel của bạn đính kèm click ID vào giao dịch Paddle.
3. Adapty nhận giao dịch qua webhook mà nó tạo trong tài khoản Paddle của bạn và khớp giao dịch đó với lượt click quảng cáo.

:::note
Các giao dịch mua qua web không có sự kiện cài đặt ứng dụng, vì vậy Adapty sử dụng ngày tính phí đầu tiên của gói đăng ký làm ngày cohort.
:::

## Trước khi bắt đầu \{#before-you-start\}

[Thiết lập Adapty web pixel](ua-web-pixel) trên funnel của bạn. Nếu không có pixel, sẽ không có click ID để gắn kết và các giao dịch sẽ không thể được attribution cho quảng cáo.

## Bước 1. Đính kèm click ID vào checkout \{#step-1-attach-the-click-id-at-checkout\}

Khi bạn mở checkout hoặc tạo giao dịch, hãy đọc click ID và thêm vào `customData` của Paddle với key `adpt_click_id`:

```js
const adptClickId = window.adaptyPixel.getClickId();

customData: { adpt_click_id: adptClickId }
```

Chỉ đính kèm click ID vào giao dịch ban đầu. Paddle tự động sao chép custom data của gói đăng ký sang các giao dịch gia hạn, do đó Adapty sẽ tự động gán attribution cho các lần gia hạn, hoàn tiền và chargeback.

`click_id` là một mã định danh ngẫu nhiên ngắn, không phải thông tin bí mật và không phải dữ liệu cá nhân. Nó hiển thị trong Paddle dashboard của bạn, điều này là hoàn toàn bình thường.

## Bước 2. Kết nối tài khoản Paddle của bạn \{#step-2-connect-your-paddle-account\}

Đầu tiên, tạo key trong Paddle. Trong Paddle dashboard của bạn, vào **Developer Tools → Authentication** và tạo một API key với các quyền sau:

| Tài nguyên | Quyền truy cập |
|---|---|
| Transactions | Read |
| Adjustments | Read |
| Notification settings | Write |

Quyền ghi trên cài đặt thông báo cho phép Adapty tạo điểm đến webhook để nhận thông tin thanh toán — bạn không cần tự cấu hình gì trong Paddle. Tất cả các quyền còn lại chỉ đọc: Adapty không bao giờ ghi vào dữ liệu thanh toán của bạn. Một key thiếu quyền bắt buộc sẽ bị từ chối ngay khi kết nối với thông báo lỗi nêu rõ quyền còn thiếu.

:::warning
Dùng live key. Các key của Paddle phụ thuộc vào môi trường, và Adapty sẽ loại bỏ các sự kiện sandbox ngay khi nhận được, vì vậy một sandbox key vẫn kết nối thành công và hiển thị là **Valid**, nhưng không có dữ liệu nào xuất hiện. Để xác minh tích hợp, hãy kết nối live key và thực hiện một giao dịch mua thực.
:::

Sau đó, thêm key vào Adapty:

1. Trong Adapty Attribution, đi tới [**Integrations > Paddle**](https://app.adapty.io/ua/integrations/paddle).
2. Dán key vào **API key**. Tùy chọn, nhập **Name** để phân biệt các tài khoản — theo mặc định, Adapty sử dụng 4 ký tự cuối của key.
3. Nhấn **Connect**.

Tài khoản đã kết nối sẽ xuất hiện trong bảng cùng với môi trường, trạng thái key và trạng thái webhook. Kết nối này áp dụng cho ứng dụng bạn đang cấu hình. Để nhận thanh toán từ cùng một tài khoản Paddle trong một ứng dụng khác, hãy thêm key đó vào ứng dụng đó.

Adapty chỉ import giao dịch kể từ thời điểm bạn kết nối tài khoản. Để đưa vào các giao dịch trước đó, hãy liên hệ với chúng tôi tại [support@adapty.io](mailto:support@adapty.io).

## Xác minh tích hợp \{#verify-the-integration\}

Hãy thực hiện một giao dịch mua thực sự qua funnel của bạn — Adapty bỏ qua các giao dịch sandbox. Giao dịch sẽ xuất hiện trong [Adapty Attribution analytics](ua-analytics) sau vài giờ. Nếu lượt truy cập của bạn đến từ quảng cáo có [URL được gắn tag](ua-web-pixel), giao dịch mua sẽ được attribution vào chiến dịch, ad set và ad đó; nếu không, nó sẽ được tính là organic.

## Gửi sự kiện chuyển đổi đến mạng quảng cáo \{#send-conversion-events-to-the-ad-network\}

Các giao dịch mua từ web được attribution sẽ tuân theo cùng cách ánh xạ sự kiện như phần còn lại của chiến dịch: những sự kiện bạn bật trong mục **Events names** của cấu hình chiến dịch sẽ được gửi lại đến pixel mà bạn đã liên kết với chiến dịch đó. Xem hướng dẫn thiết lập ánh xạ cho [Meta Ads](ua-facebook) và [TikTok for Business](ua-tiktok).