Tích hợp Paddle với Adapty Attribution
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
- Web pixel của Adapty 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.
- Tại bước thanh toán, funnel của bạn đính kèm click ID vào giao dịch Paddle.
- 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.
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
Thiết lập Adapty 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
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:
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
Đầ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.
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:
- Trong Adapty Attribution, đi tới Integrations > Paddle.
- 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.
- 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.
Xác minh tích hợp
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 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, 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
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 và TikTok for Business.