Fetch custom paywalls and products in Flutter SDK
Trước khi hiển thị các paywall tùy chỉnh, bạn cần lấy thông tin về chúng. Lưu ý rằng chủ đề này đề cập đến các paywall tùy chỉnh. Để được hướng dẫn về cách lấy flow và paywall được tùy chỉnh bằng Paywall Builder, vui lòng tham khảo Lấy flow & paywall.
Bạn muốn xem ví dụ thực tế về cách tích hợp Adapty SDK vào ứng dụng di động? Hãy xem ứng dụng mẫu của chúng tôi, minh họa toàn bộ quá trình thiết lập, bao gồm hiển thị paywall, thực hiện mua hàng và các chức năng cơ bản khác.
Trước khi bắt đầu tải paywall và sản phẩm trong ứng dụng di động (nhấn để mở rộng)
-
Tạo sản phẩm của bạn trong Adapty Dashboard.
-
Tạo paywall và thêm sản phẩm vào paywall trong Adapty Dashboard.
-
Tạo placement và thêm paywall vào placement trong Adapty Dashboard.
-
Cài đặt Adapty SDK trong ứng dụng di động của bạn.
Lấy thông tin flow
Trong Adapty, một sản phẩm là sự kết hợp của các sản phẩm từ cả App Store và Google Play. Các sản phẩm đa nền tảng này được tích hợp vào paywall, giúp bạn hiển thị chúng trong các placement cụ thể của ứng dụng di động.
Để hiển thị các sản phẩm, bạn cần lấy một AdaptyFlow từ một trong các placement của mình bằng phương thức getFlow.
Đừng hardcode product ID. ID duy nhất bạn nên hardcode là placement ID. Paywall được cấu hình từ xa, vì vậy số lượng sản phẩm và ưu đãi có thể thay đổi bất kỳ lúc nào. Ứng dụng của bạn phải xử lý những thay đổi này một cách linh hoạt—nếu hôm nay paywall trả về hai sản phẩm và ngày mai là ba, hãy hiển thị tất cả mà không cần thay đổi code.
try {
final flow = await Adapty().getFlow(placementId: 'YOUR_PLACEMENT_ID');
// the requested flow
} on AdaptyError catch (adaptyError) {
// handle the error
} catch (e) {
// handle the error
}
| Tham số | Bắt buộc | Mô tả |
|---|---|---|
| placementId | bắt buộc | Mã định danh của Placement. Đây là giá trị bạn đã chỉ định khi tạo placement trong Adapty Dashboard. |
| fetchPolicy | mặc định: AdaptyFlowFetchPolicy.reloadRevalidatingCacheData |
Tuy nhiên, nếu bạn cho rằng người dùng của mình thường xuyên gặp tình trạng mất kết nối, hãy cân nhắc dùng Chính sách thứ ba, Lưu ý rằng cache vẫn được giữ nguyên sau khi khởi động lại ứng dụng và chỉ bị xóa khi cài đặt lại ứng dụng hoặc thực hiện dọn dẹp thủ công. Adapty SDK lưu trữ paywall ở hai tầng: cache được cập nhật thường xuyên như mô tả ở trên và paywall dự phòng. Chúng tôi cũng dùng CDN để tải paywall nhanh hơn và một server dự phòng độc lập trong trường hợp CDN không thể truy cập. Hệ thống này được thiết kế để đảm bảo bạn luôn nhận được phiên bản paywall mới nhất, đồng thời đảm bảo độ tin cậy ngay cả khi kết nối mạng kém. |
| loadTimeout | mặc định: 5 giây | Giá trị này giới hạn thời gian chờ cho phương thức này. Nếu server Adapty không phản hồi kịp thời hoặc trả về lỗi, SDK sẽ trả về flow từ cache. Nếu không có gì trong cache và server hết thời gian chờ hoặc trả về lỗi server, SDK sẽ yêu cầu flow từ server dự phòng (bản sao CDN chỉ phục vụ đối tượng All Users của placement). Phương án cuối cùng, SDK trả về flow từ tệp dự phòng của bạn. Lưu ý rằng trong một số trường hợp hiếm gặp, phương thức này có thể hết thời gian chờ muộn hơn một chút so với giá trị được chỉ định trong |
Để điền vào bộ nhớ cache trước khi người dùng cần flow, hãy gọi preloadFlows (Flutter SDK 4.3.0+) cho nhiều placement cùng một lúc. Truyền fetchPolicy: AdaptyFlowFetchPolicy.returnCacheDataElseLoad để đọc bản sao đã được tải trước từ bộ nhớ cache thay vì kết nối mạng.
Trong v4, getFlow không nhận tham số locale. Đối với paywall tùy chỉnh, tất cả các bản dịch có sẵn đều được trả về trong Remote Config của flow (flow.remoteConfigs) — chọn bản phù hợp với thiết bị hoặc cài đặt ngôn ngữ của người dùng. Xem Localizations và mã locale.
Các tham số trả về:
| Parameter | Description |
|---|---|
| Flow | Một đối tượng AdaptyFlow chứa các định danh của flow (instanceIdentity, variationId), tên, placement, các biến thể paywall (paywalls), và các Remote Config (remoteConfigs). |
Lấy danh sách sản phẩm
Sau khi có flow, bạn có thể truy vấn mảng sản phẩm tương ứng với nó:
try {
final products = await Adapty().getPaywallProducts(flow: flow);
// the requested products array
} on AdaptyError catch (adaptyError) {
// handle the error
} catch (e) {
// handle the error
}Tham số trả về:
| Tham số | Mô tả |
|---|---|
| Products | Danh sách các đối tượng AdaptyPaywallProduct bao gồm: mã định danh sản phẩm, tên sản phẩm, giá, đơn vị tiền tệ, thời hạn gói đăng ký và một số thuộc tính khác. |
Khi triển khai thiết kế paywall của riêng bạn, bạn có thể sẽ cần truy cập các thuộc tính từ đối tượng AdaptyPaywallProduct. Dưới đây là các thuộc tính được sử dụng phổ biến nhất, nhưng hãy tham khảo tài liệu được liên kết để biết đầy đủ chi tiết về tất cả các thuộc tính hiện có.
| Thuộc tính | Mô tả |
|---|---|
| Title | Để hiển thị tiêu đề của sản phẩm, sử dụng product.localizedTitle. Lưu ý rằng bản địa hóa dựa trên quốc gia cửa hàng mà người dùng đã chọn, chứ không phải ngôn ngữ của thiết bị. |
| Price | Để hiển thị giá đã được bản địa hóa, sử dụng product.price.localizedString. Bản địa hóa này dựa trên thông tin ngôn ngữ của thiết bị. Bạn cũng có thể truy cập giá dưới dạng số bằng product.price.amount. Giá trị sẽ được cung cấp theo đơn vị tiền tệ địa phương. Để lấy ký hiệu tiền tệ tương ứng, sử dụng product.price.currencySymbol. |
| Subscription Period | Để hiển thị kỳ hạn (ví dụ: tuần, tháng, năm, v.v.), sử dụng product.subscription?.localizedPeriod. Bản địa hóa này dựa trên ngôn ngữ của thiết bị. Để lấy kỳ hạn gói đăng ký theo cách lập trình, sử dụng product.subscription?.period. Từ đó bạn có thể truy cập enum unit để lấy độ dài (tức là ngày, tuần, tháng, năm hoặc không xác định). Giá trị numberOfUnits sẽ cho bạn biết số đơn vị kỳ hạn. Ví dụ: với gói đăng ký theo quý, bạn sẽ thấy AdaptyPeriodUnit.month trong thuộc tính unit và 3 trong thuộc tính numberOfUnits. |
| Billing plan | Chỉ dành cho iOS. Đối với sản phẩm cam kết 12 tháng, sử dụng product.subscription?.pricingTerms để hiển thị cả hai mức giá mà Apple yêu cầu: billingPrice.localizedString và billingPeriod cho kỳ thanh toán hàng tháng, commitmentInfo.price.localizedString và commitmentInfo.period cho tổng giá trị theo năm. billingPlan là AdaptySubscriptionBillingPlan.monthly cho gói cam kết và AdaptySubscriptionBillingPlan.upFront trong các trường hợp còn lại. Với gói cam kết, product.price và product.subscription?.period trả về tổng giá trị và kỳ hạn theo năm, không phải theo từng kỳ thanh toán. Trên Android, pricingTerms là null. Yêu cầu Adapty SDK 4.3.0 trở lên. |
| Introductory Offer | Để hiển thị huy hiệu hoặc chỉ báo khác cho thấy gói đăng ký có ưu đãi giới thiệu, hãy kiểm tra thuộc tính product.subscription?.offer?.phases. Đây là một danh sách có thể chứa tối đa hai giai đoạn giảm giá: giai đoạn dùng thử miễn phí và giai đoạn giá ưu đãi giới thiệu. Trong mỗi đối tượng giai đoạn có các thuộc tính hữu ích sau:• paymentMode: một enum với các giá trị AdaptyPaymentMode.freeTrial, AdaptyPaymentMode.payAsYouGo, AdaptyPaymentMode.payUpFront và AdaptyPaymentMode.unknown. Dùng thử miễn phí sẽ có kiểu AdaptyPaymentMode.freeTrial.• price: Giá giảm dưới dạng số. Với dùng thử miễn phí, giá trị này là 0.• localizedNumberOfPeriods: một chuỗi được bản địa hóa theo ngôn ngữ của thiết bị, mô tả độ dài của ưu đãi. Ví dụ: ưu đãi dùng thử ba ngày sẽ hiển thị 3 days trong trường này.• subscriptionPeriod: Ngoài ra, bạn có thể lấy thông tin chi tiết của kỳ hạn ưu đãi bằng thuộc tính này. Cách dùng tương tự như đã mô tả ở phần trước.• localizedSubscriptionPeriod: Kỳ hạn gói đăng ký được định dạng theo ngôn ngữ của người dùng. |
Tăng tốc độ tải flow với flow đối tượng mặc định
Thông thường, flow được tải gần như ngay lập tức, vì vậy bạn không cần lo lắng về việc tối ưu quá trình này. Tuy nhiên, trong trường hợp bạn có nhiều đối tượng và placement, và người dùng có kết nối internet yếu, việc tải flow có thể mất nhiều thời gian hơn mong muốn. Trong những tình huống như vậy, bạn có thể muốn hiển thị một flow mặc định để đảm bảo trải nghiệm người dùng mượt mà thay vì không hiển thị gì cả.
Để giải quyết vấn đề này, bạn có thể sử dụng phương thức getFlowForDefaultAudience, phương thức này lấy flow của placement được chỉ định cho đối tượng All Users. Tuy nhiên, điều quan trọng cần hiểu là cách tiếp cận được khuyến nghị là lấy flow bằng phương thức getFlow, như được mô tả chi tiết trong phần Lấy thông tin flow ở trên.
Tại sao chúng tôi khuyến nghị sử dụng getFlow
Phương thức getFlowForDefaultAudience có một số hạn chế đáng kể:
- Các vấn đề tương thích ngược tiềm ẩn: Nếu bạn cần hiển thị các paywall khác nhau cho các phiên bản ứng dụng khác nhau (hiện tại và tương lai), bạn có thể gặp khó khăn. Bạn sẽ phải thiết kế các paywall hỗ trợ phiên bản hiện tại (cũ) hoặc chấp nhận rằng người dùng với phiên bản hiện tại (cũ) có thể gặp sự cố với các paywall không hiển thị được.
- Mất khả năng targeting: Tất cả người dùng sẽ thấy cùng một paywall được thiết kế cho đối tượng All Users, nghĩa là bạn mất đi khả năng targeting cá nhân hóa (bao gồm theo quốc gia, attribution marketing hoặc các thuộc tính tùy chỉnh của riêng bạn).
Nếu bạn chấp nhận những hạn chế này để đổi lấy tốc độ tải flow nhanh hơn, hãy sử dụng phương thức getFlowForDefaultAudience như sau. Nếu không, hãy tiếp tục dùng getFlow đã được mô tả ở trên.
try {
final flow = await Adapty().getFlowForDefaultAudience(placementId: 'YOUR_PLACEMENT_ID');
// the requested flow
} on AdaptyError catch (adaptyError) {
// handle error
} catch (e) {
// handle unknown error
}
| Tham số | Bắt buộc | Mô tả |
|---|---|---|
| placementId | bắt buộc | Định danh của Placement. Đây là giá trị bạn đã chỉ định khi tạo placement trong Adapty Dashboard. |
| fetchPolicy | mặc định: AdaptyFlowFetchPolicy.reloadRevalidatingCacheData |
Tuy nhiên, nếu bạn cho rằng người dùng của mình thường xuyên gặp sự cố kết nối internet, hãy cân nhắc dùng Chính sách thứ ba, Lưu ý rằng cache vẫn được giữ nguyên sau khi khởi động lại ứng dụng và chỉ bị xóa khi ứng dụng được cài đặt lại hoặc khi dọn dẹp thủ công. |
Trước khi hiển thị các paywall tùy chỉnh, bạn cần lấy thông tin về chúng. Lưu ý rằng chủ đề này đề cập đến các paywall tùy chỉnh. Để được hướng dẫn về cách lấy paywall cho các paywall được tùy chỉnh bằng Paywall Builder, vui lòng tham khảo Lấy paywall Paywall Builder và cấu hình của chúng.
Bạn muốn xem ví dụ thực tế về cách tích hợp Adapty SDK vào ứng dụng di động? Hãy xem ứng dụng mẫu của chúng tôi, minh họa toàn bộ quá trình thiết lập, bao gồm hiển thị paywall, thực hiện mua hàng và các chức năng cơ bản khác.
Trước khi bắt đầu lấy paywall và sản phẩm trong ứng dụng di động của bạn (nhấn để mở rộng)
-
Tạo sản phẩm của bạn trong Adapty Dashboard.
-
Tạo paywall và đưa các sản phẩm vào paywall của bạn trong Adapty Dashboard.
-
Tạo placement và đưa paywall vào placement trong Adapty Dashboard.
-
Cài đặt Adapty SDK vào ứng dụng di động của bạn.
Lấy thông tin paywall
Trong Adapty, một sản phẩm là sự kết hợp của các sản phẩm từ cả App Store và Google Play. Các sản phẩm đa nền tảng này được tích hợp vào các paywall, cho phép bạn hiển thị chúng trong các placement cụ thể của ứng dụng di động.
Để hiển thị các sản phẩm, bạn cần lấy một Paywall từ một trong các placement của mình bằng phương thức getPaywall.
Đừng hardcode product ID. ID duy nhất bạn cần hardcode là placement ID. Paywall được cấu hình từ xa, vì vậy số lượng sản phẩm và ưu đãi có thể thay đổi bất cứ lúc nào. Ứng dụng của bạn phải xử lý những thay đổi này một cách linh hoạt—nếu hôm nay paywall trả về hai sản phẩm và ngày mai trả về ba, hãy hiển thị tất cả mà không cần thay đổi code.
try {
final paywall = await Adapty().getPaywall(placementId: "YOUR_PLACEMENT_ID", locale: "en");
// the requested paywall
} on AdaptyError catch (adaptyError) {
// handle the error
} catch (e) {
}
| Tham số | Bắt buộc | Mô tả |
|---|---|---|
| placementId | bắt buộc | Mã định danh của Placement. Đây là giá trị bạn đã chỉ định khi tạo placement trong Adapty Dashboard. |
| locale | tùy chọn mặc định: | Mã định danh của bản địa hóa paywall. Tham số này là mã ngôn ngữ gồm một hoặc nhiều subtag được phân cách bằng ký tự dấu trừ (-). Subtag đầu tiên là mã ngôn ngữ, subtag thứ hai là mã vùng. Ví dụ: Xem Các bản địa hóa và mã ngôn ngữ để biết thêm thông tin về mã ngôn ngữ và cách chúng tôi khuyến nghị sử dụng. |
| fetchPolicy | mặc định: AdaptyPaywallFetchPolicy.reloadRevalidatingCacheData |
Tuy nhiên, nếu bạn cho rằng người dùng của mình thường xuyên gặp tình trạng mạng không ổn định, hãy cân nhắc dùng Chính sách thứ ba, Lưu ý rằng cache vẫn được giữ nguyên khi khởi động lại ứng dụng và chỉ bị xóa khi gỡ cài đặt ứng dụng hoặc thực hiện dọn dẹp thủ công. Adapty SDK lưu trữ paywall ở hai lớp: cache được cập nhật thường xuyên như mô tả ở trên và paywall dự phòng. Chúng tôi cũng dùng CDN để tải paywall nhanh hơn và một server dự phòng độc lập trong trường hợp CDN không truy cập được. Hệ thống này được thiết kế để đảm bảo bạn luôn nhận được phiên bản paywall mới nhất, đồng thời đảm bảo độ tin cậy ngay cả khi kết nối mạng bị hạn chế. |
| loadTimeout | mặc định: 5 giây | Giá trị này giới hạn thời gian chờ cho phương thức này. Nếu server Adapty không phản hồi kịp thời hoặc trả về lỗi, SDK sẽ trả về paywall từ server dự phòng (bản sao CDN chỉ phục vụ đối tượng All Users của placement), từ cache, hoặc từ file dự phòng của bạn. Lưu ý rằng trong một số trường hợp hiếm gặp, phương thức này có thể hết thời gian chờ muộn hơn một chút so với giá trị đã chỉ định trong |
Đừng hardcode ID sản phẩm! Vì các paywall được cấu hình từ xa, các sản phẩm có sẵn, số lượng sản phẩm và các ưu đãi đặc biệt (như dùng thử miễn phí) có thể thay đổi theo thời gian. Hãy đảm bảo code của bạn xử lý được những tình huống này.
Ví dụ: nếu ban đầu bạn nhận được 2 sản phẩm, ứng dụng của bạn nên hiển thị 2 sản phẩm đó. Tuy nhiên, nếu sau này bạn nhận được 3 sản phẩm, ứng dụng của bạn nên hiển thị cả 3 mà không cần thay đổi bất kỳ dòng code nào. Thứ duy nhất bạn phải hardcode là placement ID.
Các tham số trả về:
| Tham số | Mô tả |
|---|---|
| Paywall | Một đối tượng AdaptyPaywall chứa: danh sách ID sản phẩm, mã định danh paywall, Remote Config và một số thuộc tính khác. |
Lấy danh sách sản phẩm
Sau khi có paywall, bạn có thể truy vấn mảng sản phẩm tương ứng với nó:
try {
final products = await Adapty().getPaywallProducts(paywall: paywall);
// the requested products array
} on AdaptyError catch (adaptyError) {
// handle the error
} catch (e) {
}Các tham số phản hồi:
| Tham số | Mô tả |
|---|---|
| Products | Danh sách các đối tượng AdaptyPaywallProduct gồm: mã định danh sản phẩm, tên sản phẩm, giá, đơn vị tiền tệ, thời hạn gói đăng ký, và một số thuộc tính khác. |
Khi tự thiết kế paywall, bạn sẽ cần truy cập các thuộc tính từ đối tượng AdaptyPaywallProduct. Dưới đây là các thuộc tính thường dùng nhất — xem tài liệu được liên kết để biết đầy đủ thông tin về tất cả các thuộc tính có sẵn.
| Thuộc tính | Mô tả |
|---|---|
| Tiêu đề | Để hiển thị tiêu đề sản phẩm, dùng product.localizedTitle. Lưu ý rằng việc bản địa hóa dựa trên quốc gia cửa hàng mà người dùng đã chọn, chứ không phải ngôn ngữ của thiết bị. |
| Giá | Để hiển thị giá đã được bản địa hóa, dùng product.price.localizedString. Việc bản địa hóa này dựa trên thông tin ngôn ngữ của thiết bị. Bạn cũng có thể truy cập giá dưới dạng số thông qua product.price.amount. Giá trị sẽ được trả về theo đơn vị tiền tệ địa phương. Để lấy ký hiệu tiền tệ tương ứng, dùng product.price.currencySymbol. |
| Chu kỳ gói đăng ký | Để hiển thị chu kỳ (ví dụ: tuần, tháng, năm, v.v.), dùng product.subscription?.localizedPeriod. Việc bản địa hóa này dựa trên ngôn ngữ của thiết bị. Để lấy chu kỳ gói đăng ký theo cách lập trình, dùng product.subscription?.period. Từ đó bạn có thể truy cập enum unit để lấy độ dài (tức là day, week, month, year hoặc unknown). Giá trị numberOfUnits cho biết số đơn vị chu kỳ. Ví dụ: với gói đăng ký theo quý, thuộc tính unit sẽ là AdaptyPeriodUnit.month và numberOfUnits sẽ là 3. |
| Ưu đãi giới thiệu | Để hiển thị huy hiệu hoặc chỉ báo cho biết gói đăng ký có ưu đãi giới thiệu, hãy kiểm tra thuộc tính product.subscription?.offer?.phases. Đây là danh sách có thể chứa tối đa hai giai đoạn giảm giá: giai đoạn dùng thử miễn phí và giai đoạn giá ưu đãi giới thiệu. Trong mỗi đối tượng phase có các thuộc tính hữu ích sau:• paymentMode: một enum với các giá trị AdaptyPaymentMode.freeTrial, AdaptyPaymentMode.payAsYouGo, AdaptyPaymentMode.payUpFront và AdaptyPaymentMode.unknown. Dùng thử miễn phí sẽ có kiểu AdaptyPaymentMode.freeTrial.• price: Giá giảm dưới dạng số. Với dùng thử miễn phí, giá trị này sẽ là 0.• localizedNumberOfPeriods: một chuỗi được bản địa hóa theo ngôn ngữ của thiết bị, mô tả độ dài của ưu đãi. Ví dụ: ưu đãi dùng thử ba ngày sẽ hiển thị 3 days trong trường này.• subscriptionPeriod: Ngoài ra, bạn có thể lấy thông tin chi tiết từng phần của chu kỳ ưu đãi bằng thuộc tính này. Cách hoạt động tương tự như mô tả ở phần trước.• localizedSubscriptionPeriod: Chu kỳ gói đăng ký của ưu đãi đã được định dạng theo ngôn ngữ của người dùng. |
Tăng tốc độ tải paywall bằng paywall mặc định cho đối tượng
Thông thường, paywall được tải gần như ngay lập tức, nên bạn không cần lo lắng về việc tối ưu tốc độ này. Tuy nhiên, trong các trường hợp bạn có nhiều đối tượng và paywall, hoặc người dùng có kết nối internet yếu, việc tải paywall có thể mất nhiều thời gian hơn mong muốn. Trong những tình huống như vậy, bạn có thể muốn hiển thị một paywall mặc định để đảm bảo trải nghiệm người dùng mượt mà, thay vì không hiển thị paywall nào cả.
Để giải quyết vấn đề này, bạn có thể sử dụng phương thức getPaywallForDefaultAudience, phương thức này tải paywall của placement được chỉ định cho đối tượng All Users. Tuy nhiên, điều quan trọng cần hiểu là cách tiếp cận được khuyến nghị là tải paywall bằng phương thức getPaywall, như đã trình bày chi tiết trong phần Lấy thông tin Paywall ở trên.
Lý do chúng tôi khuyến nghị sử dụng getPaywall
Phương thức getPaywallForDefaultAudience có một số hạn chế đáng kể:
- Các vấn đề tương thích ngược tiềm ẩn: Nếu bạn cần hiển thị các paywall khác nhau cho các phiên bản ứng dụng khác nhau (hiện tại và tương lai), bạn có thể gặp khó khăn. Bạn sẽ phải thiết kế các paywall hỗ trợ phiên bản hiện tại (cũ) hoặc chấp nhận rằng người dùng có phiên bản hiện tại (cũ) có thể gặp sự cố với các paywall không được hiển thị.
- Mất khả năng nhắm mục tiêu: Tất cả người dùng sẽ thấy cùng một paywall được thiết kế cho đối tượng All Users, nghĩa là bạn mất đi khả năng nhắm mục tiêu cá nhân hóa (bao gồm theo quốc gia, attribution marketing hoặc các thuộc tính tùy chỉnh của riêng bạn).
Nếu bạn chấp nhận những hạn chế này để đổi lấy tốc độ tải paywall nhanh hơn, hãy sử dụng phương thức getPaywallForDefaultAudience như sau. Nếu không, hãy tiếp tục dùng getPaywall đã được mô tả ở trên.
try {
final paywall = await Adapty().getPaywallForDefaultAudience(placementId: 'YOUR_PLACEMENT_ID');
} on AdaptyError catch (adaptyError) {
// handle error
} catch (e) {
// handle unknown error
}Phương thức getPaywallForDefaultAudience khả dụng từ Flutter SDK phiên bản 3.2.0 trở lên.
| Tham số | Bắt buộc | Mô tả |
|---|---|---|
| placementId | bắt buộc | Mã định danh của Placement. Đây là giá trị bạn đã chỉ định khi tạo placement trong Adapty Dashboard. |
| locale | tùy chọn mặc định: | Mã định danh của bản địa hóa paywall. Tham số này là mã ngôn ngữ gồm một hoặc nhiều thẻ con được phân tách bằng ký tự dấu trừ (-). Thẻ con đầu tiên là mã ngôn ngữ, thẻ con thứ hai là mã vùng. Ví dụ: Xem Bản địa hóa và mã locale để biết thêm thông tin về mã locale và cách chúng tôi khuyến nghị sử dụng chúng. |
| fetchPolicy | mặc định: AdaptyPaywallFetchPolicy.reloadRevalidatingCacheData |
Tuy nhiên, nếu người dùng của bạn thường xuyên gặp tình trạng mạng không ổn định, hãy cân nhắc dùng Chính sách thứ ba, Lưu ý rằng cache vẫn được giữ nguyên khi khởi động lại ứng dụng và chỉ bị xóa khi gỡ cài đặt ứng dụng hoặc thực hiện dọn dẹp thủ công. |