---
title: "Kết nối FunnelFox với Adapty"
description: "Kết nối web funnel của FunnelFox với Adapty để các giao dịch mua hàng trên web cấp mức độ truy cập trong ứng dụng di động của bạn."
---

> **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-skills && claude plugin install adapty-skills@adapty` — other tools: `npx skills add adaptyteam/adapty-skills --all`

[FunnelFox](https://funnelfox.com) xây dựng web funnel: các landing page và quiz giúp bán gói đăng ký của bạn bên ngoài App Store và Google Play. Kết nối FunnelFox với Adapty để cấp quyền truy cập tính năng trả phí trong ứng dụng di động cho người mua hàng qua web, đồng thời xem giao dịch của họ trên cùng dashboard với các giao dịch từ cửa hàng.

Kết nối chỉ cần một khóa và một ID mức độ truy cập. Sau đó, ứng dụng của bạn cần xác định người mua để đạt được mức độ truy cập đó. Xem [Cấp quyền truy cập trong ứng dụng của bạn](#provide-access-in-your-app).

## Cách tích hợp hoạt động \{#how-the-integration-works\}

FunnelFox thu thập thanh toán trên web. Sau đó, FunnelFox gọi [Adapty Server-side API](getting-started-with-server-side-api) để tạo [hồ sơ người dùng](profiles-crm), ghi lại giao dịch và cấp [mức độ truy cập](access-level) có ID bạn nhập trong cài đặt tích hợp FunnelFox. Các lần gia hạn, hủy và thanh toán thất bại đều cập nhật hồ sơ người dùng đó. Các giao dịch mua trên web sẽ xuất hiện trong [Adapty analytics](analytics) cùng với doanh thu từ App Store và Google Play.

Adapty liên kết giao dịch mua trên web với người dùng ứng dụng thông qua customer user ID. Theo mặc định, FunnelFox sử dụng địa chỉ email được nhập khi thanh toán làm ID đó.

Để tự xây dựng flow tương tự với quy trình thanh toán web của riêng bạn thay vì dùng FunnelFox funnel, hãy xem [Đồng bộ giao dịch mua giữa web và mobile](sync-subscribers-from-web).

## Kết nối FunnelFox \{#connect-funnelfox\}

Bạn thiết lập kết nối ở phía FunnelFox, theo [hướng dẫn tích hợp Adapty của FunnelFox](https://funnelfox.com/docs/integrations/subscription-management/adapty#setup). Hướng dẫn này yêu cầu hai giá trị từ Adapty:

- **Secret API key**: Mở [**App Settings**](https://app.adapty.io/settings/general) trong Adapty và sao chép secret key.
- **Access level ID**: [Mức độ truy cập](access-level) cần cấp. Bạn cũng có thể thiết lập riêng cho từng phần tử checkout, như mô tả trong [Thiết lập mức độ truy cập cho từng phần tử checkout](#set-the-access-level-on-each-checkout-element).

## Đặt mức độ truy cập cho từng phần tử thanh toán \{#set-the-access-level-on-each-checkout-element\}

Trong FunnelFox, trường **Custom entitlement** trên một phần tử thanh toán xác định [mức độ truy cập](access-level) mà giao dịch mua qua phần tử đó cấp cho người dùng. Mọi ứng dụng Adapty đều bắt đầu với mức độ truy cập `premium`; nếu muốn cấp mức độ truy cập khác, hãy [tạo mức độ đó](create-access-level) trước.

Đặt trường này cho từng phần tử thanh toán trong funnel. Một funnel có thể chứa nhiều hơn một phần tử, chẳng hạn như nút Wallet và một accordion checkout, và mỗi phần tử đều có trường **Custom entitlement** riêng.

:::important
Hãy đăng lại funnel sau khi bạn thay đổi cài đặt tích hợp hoặc bất kỳ giá trị **Custom entitlement** nào. Một funnel đã được đăng sẽ tiếp tục phục vụ theo cấu hình trước đó cho đến khi bạn đăng lại.
:::

## Cấp quyền truy cập trong ứng dụng của bạn \{#provide-access-in-your-app\}

Để mở khóa các tính năng trả phí cho người mua qua web, hãy gọi `Adapty.activate()` hoặc `Adapty.identify()` với cùng customer user ID mà FunnelFox đã sử dụng. Theo mặc định, ID đó là địa chỉ email mà người mua đã nhập khi thanh toán. Xem <InlineTooltip tooltip="Identifying users">[iOS](identifying-users), [Android](android-identifying-users), [React Native](react-native-identifying-users), [Flutter](flutter-identifying-users), [Unity](unity-identifying-users), [Kotlin Multiplatform](kmp-identifying-users), và [Capacitor](capacitor-identifying-users)</InlineTooltip> để biết cách gọi.

Cài đặt ứng dụng từ một liên kết trong funnel không tự động xác định người mua. Cho đến khi ứng dụng của bạn gọi `Adapty.identify()` với ID khớp, hồ sơ người dùng đang giữ mức độ truy cập và hồ sơ người dùng mà ứng dụng đã tạo vẫn tách biệt, và ứng dụng sẽ không hiển thị quyền truy cập đã trả phí. Đăng nhập bằng email thanh toán sẽ ghép hai hồ sơ đó lại với nhau.

Để mở khóa quyền truy cập mà không cần bước đăng nhập, hãy truyền customer user ID từ funnel vào ứng dụng thông qua deferred deep link, sau đó gọi `Adapty.identify()` với ID đó khi khởi chạy lần đầu.

Sau đó đọc mức độ truy cập từ hồ sơ người dùng để mở khóa các tính năng. Xem <InlineTooltip tooltip="Kiểm tra trạng thái gói đăng ký">[iOS](ios-check-subscription-status), [Android](android-check-subscription-status), [React Native](react-native-check-subscription-status), [Flutter](flutter-check-subscription-status), [Unity](unity-check-subscription-status), [Kotlin Multiplatform](kmp-check-subscription-status), và [Capacitor](capacitor-check-subscription-status)</InlineTooltip>.

## Kiểm tra tích hợp \{#test-the-integration\}

1. Hoàn tất một giao dịch mua trong funnel của bạn.
2. Trong Adapty, mở [**Profiles**](https://app.adapty.io/profiles/users) và tìm hồ sơ người dùng theo customer user ID mà FunnelFox sử dụng.
3. Xác nhận rằng mức độ truy cập có ID bạn đã nhập trong cài đặt tích hợp FunnelFox đang hoạt động trên hồ sơ đó.
4. Mở ứng dụng, xác định cùng người dùng đó và xác nhận rằng các tính năng trả phí đã được mở khóa.

## Khắc phục sự cố \{#troubleshooting\}

### Người mua qua web mở ứng dụng nhưng không có quyền truy cập

Ứng dụng của bạn chưa xác định được người mua. FunnelFox đã cấp mức độ truy cập cho một hồ sơ người dùng được định danh bằng ID mà nó sử dụng — mặc định là email thanh toán — nhưng ứng dụng của bạn đang đọc một hồ sơ người dùng khác. Hãy gọi `Adapty.identify()` với ID đó, như được mô tả trong [Cấp quyền truy cập trong ứng dụng của bạn](#provide-access-in-your-app).

## Các tích hợp FunnelFox khác \{#other-funnelfox-integrations\}

FunnelFox kết nối với ba sản phẩm của Adapty, mỗi sản phẩm được thiết lập riêng biệt.

| Sản phẩm | FunnelFox gửi gì cho Adapty | Hướng dẫn thiết lập |
|---|---|---|
| Core | Hồ sơ người dùng, giao dịch và mức độ truy cập, giúp các giao dịch mua trên web mở khóa ứng dụng | Bài viết này |
| Adapty Attribution | Sự kiện giao dịch kèm dữ liệu chiến dịch, funnel và thử nghiệm | [Tích hợp FunnelFox với Adapty Attribution](ua-funnelfox) |
| Adapty Mail | Địa chỉ email, lịch sử mua hàng và sự kiện gói đăng ký | [Kết nối FunnelFox với Adapty Mail](mail-funnelfox) |