Tích hợp Stripe với Adapty Attribution
Kết nối tài khoản Stripe của bạn với Adapty Attribution để attribution các lượt mua trong web funnel với các quảng cáo đã dẫn dắt chúng. Sau khi kết nối, các giao dịch mua, gia hạn, hoàn tiền và chargeback từ Stripe sẽ xuất hiện trong analytics của Adapty Attribution, và các sự kiện chuyển đổi có thể được gửi 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
- Adapty web pixel gán cho mỗi khách truy cập một click ID và ghi lại dữ liệu quảng cáo từ URL landing page.
- Khi thanh toán, funnel của bạn đính kèm click ID vào giao dịch Stripe.
- Adapty nhận giao dịch qua webhook mà nó tạo trong tài khoản Stripe của bạn và khớp với lần nhấp quảng cáo.
Giao dịch mua trên 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
Cài đặt Adapty web pixel trên funnel của bạn. Nếu không có pixel, sẽ không có click ID để đính kèm và các giao dịch sẽ không thể được attribution cho quảng cáo.
Bước 1. Gắn click ID vào checkout
Khi tạo giao dịch, hãy đọc click ID và thêm vào metadata của Stripe dưới key adpt_click_id:
const adptClickId = window.adaptyPixel.getClickId();Giá trị này phải nằm trên PaymentIntent (với thanh toán một lần) hoặc trên Subscription (với thanh toán định kỳ), vì đó là những đối tượng mà Adapty đọc. Nếu bạn tạo chúng trực tiếp:
metadata: { adpt_click_id: adptClickId }Nếu bạn sử dụng Stripe Checkout, hãy đặt metadata trong các đối tượng lồng nhau. Metadata trên chính Checkout Session sẽ không được sao chép sang PaymentIntent hay Subscription, vì vậy click ID đặt ở đó sẽ không bao giờ đến được Adapty:
stripe.checkout.sessions.create({
// ...
payment_intent_data: { metadata: { adpt_click_id: adptClickId } }, // one-off payments
subscription_data: { metadata: { adpt_click_id: adptClickId } }, // subscriptions
})Hãy thiết lập metadata khi bạn tạo PaymentIntent, không phải bằng cách cập nhật sau đó. Stripe sao chép metadata vào charge tại thời điểm charge được tạo, vì vậy một click ID được thêm vào sau này sẽ không bao giờ đến được Adapty.
click_id là một mã định danh ngẫu nhiên ngắn, không phải bí mật và không phải dữ liệu cá nhân. Nó hiển thị trên Stripe dashboard của bạn, điều này là bình thường.
Bước 2. Kết nối tài khoản Stripe của bạn
Đầu tiên, hãy tạo key trong Stripe. Trong Stripe dashboard của bạn, vào Developers → API keys và tạo một restricted key với các quyền sau:
| Tài nguyên | Quyền truy cập |
|---|---|
| Charges | Read |
| Refunds | Read |
| Invoices | Read |
| Balance transactions | Read |
| Disputes | Read |
| Webhook endpoints | Write |
Quyền ghi trên các endpoint webhook cho phép Adapty tạo webhook để xử lý thanh toán của bạn — bạn không cần tự cấu hình thủ công trong Stripe. Mọi thứ khác vẫn ở chế độ 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à hiển thị lỗi nêu rõ quyền còn thiếu.
Sử dụng live key. Adapty loại bỏ các giao dịch ở chế độ test ngay khi nhận được, do đó test key (rk_test_...) 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, truy cập Integrations > Stripe.
- Dán key vào API key. Tùy chọn, nhập Name để phân biệt các tài khoản — mặc định, Adapty sử dụng 4 ký tự cuối của key.
- Nhấp 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 khóa 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 tài khoản Stripe đó trong một ứng dụng khác, hãy thêm khóa tương tự vào ứng dụng đó.
Adapty nhập các giao dịch kể từ thời điểm bạn kết nối tài khoản. Để nhập 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
Thực hiện một giao dịch mua thực sự qua phễu của bạn — Adapty loại bỏ các giao dịch ở chế độ thử nghiệm. Giao dịch mua 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ừ một quảng cáo có URL được gắn thẻ, giao dịch mua sẽ được attribution cho chiến dịch, nhóm quảng cáo và quảng cáo đó; 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 hàng trên web được attributed sẽ tuân theo cùng một mapping sự kiện như phần còn lại của chiến dịch: các sự kiện bạn bật trong phần 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 mapping cho Meta Ads và TikTok for Business.