Hướng dẫn chuyển đổi

Chuyển từ RevenueCat sang openpurr mà không mất một khách hàng nào

Giữ nguyên Purchases SDK mà ứng dụng của bạn đang dùng. Import khách hàng hiện có từ bản xuất dữ liệu của RevenueCat: openpurr tự lấy từng giao dịch mua từ Apple và Google. Các phiên bản ứng dụng cũ vẫn hoạt động trong lúc mọi người cập nhật.

Cập nhật

Tóm tắt

  • openpurr là giải pháp thay thế RevenueCat mã nguồn mở, tự host. Nó hoạt động với Purchases SDK chính thức của RevenueCat, không chỉnh sửa.
  • Ứng dụng của bạn chỉ thêm một dòng (proxy URL của SDK) và một lệnh gọi syncPurchases một lần. Phần code mua hàng còn lại giữ nguyên.
  • openpurr import chuyển khách hàng hiện có từ bản xuất dữ liệu của RevenueCat sang. Bản thân các giao dịch mua được lấy từ Apple và Google, không phải sao chép.
  • Ứng dụng trên App Store có thể dùng Scheduled Data Export của RevenueCat. Google Play cần bản xuất dữ liệu để chuyển đổi từ RevenueCat Support, bản duy nhất có purchase token.
  • Cả hai backend đều được cập nhật cho đến khi phần lớn người dùng đã cập nhật ứng dụng, nên không ai bị mất quyền truy cập.
  • Trên gói miễn phí của Cloudflare, quá trình import xử lý khoảng 2.500 khách hàng mỗi ngày. Trên Workers Paid, một lần import lớn chỉ mất vài giờ.
Cách hoạt động

Quá trình chuyển đổi từ RevenueCat diễn ra thế nào

openpurr không sao chép lịch sử mua hàng ra khỏi RevenueCat. Nó chỉ cần biết ai sở hữu giao dịch mua nào, rồi hỏi các store, giống hệt như khi ứng dụng của bạn gửi một giao dịch mua.

Import

Bản xuất dữ liệu của RevenueCat cho biết app user nào sở hữu giao dịch mua nào trên store. openpurr import hỏi Apple và Google về từng giao dịch mua và ghi lại câu trả lời của store cho người dùng đó. Mọi người được chuyển sang cùng lúc, kể cả những người không bao giờ mở lại ứng dụng.

Bản cập nhật ứng dụng

Phiên bản mới trỏ Purchases SDK tới openpurr và gửi giao dịch mua của từng khách hàng một lần bằng syncPurchases. Cách này bao quát cả những người bị bản xuất dữ liệu bỏ sót và những người mua sau khi bản xuất được tạo.

Hai backend song song, trong một thời gian

Các phiên bản ứng dụng cũ vẫn giao tiếp với RevenueCat cho đến khi người dùng cập nhật. RevenueCat chuyển tiếp thông báo của Apple tới openpurr, và một subscription Pub/Sub thứ hai làm điều tương tự cho Google, nên cả hai đều luôn được cập nhật.

Trong ứng dụng của bạn

Những gì thay đổi trong ứng dụng của bạn

Đặt proxy URL trước khi gọi configure, và gửi giao dịch mua của từng khách hàng một lần. Hai thay đổi này cũng áp dụng cho Android, Flutter và React Native; hướng dẫn có code cho từng nền tảng.

// Trước configure(): dòng duy nhất mà hầu hết ứng dụng cần thêm
Purchases.proxyURL = URL(string: "https://purchases.example.com")!
Purchases.configure(withAPIKey: "appl_…")

// Một lần mỗi lượt cài đặt: gửi giao dịch mua của khách hàng này tới openpurr
let synced = "openpurr.synced"
if !UserDefaults.standard.bool(forKey: synced) {
  Purchases.shared.syncPurchases { _, error in
    if error == nil { UserDefaults.standard.set(true, forKey: synced) }
  }
}
Import

Import khách hàng từ RevenueCat

CLI của openpurr đọc nguyên các cột của RevenueCat: app user ID, mã giao dịch App Store, purchase token của Google Play và các thuộc tính như $email.

npm install -g @openpurr/cli
openpurr login --url https://<your back office>

# Kiểm tra vài dòng đầu: hỏi Apple và Google, không ghi gì cả
openpurr import revenuecat-export.csv --dry-run --limit 50

# Import tất cả. Dừng bất cứ lúc nào; chạy lại để tiếp tục.
openpurr import revenuecat-export.csv

Không ai mất quyền truy cập

Giao dịch mua mà ứng dụng đã gửi cho một khách hàng vẫn thuộc về họ; quá trình import không bao giờ chuyển nó đi.

Không có webhook trùng lặp

Giao dịch mua được import không phải giao dịch mới, nên openpurr không gửi sự kiện nào cho chúng.

Biểu đồ trung thực

Khách hàng được import được tính từ ngày mua đầu tiên, không bị tính là khách hàng mới vào ngày import.

Ứng dụng vẫn chạy bình thường

Trên gói miễn phí của Cloudflare, quá trình import dừng ở mức 90% giới hạn hằng ngày và tiếp tục vào ngày hôm sau.

Dừng và tiếp tục

Tiến độ được lưu lại. Import một dòng hai lần không thay đổi gì, nên có thể chạy lại với bản xuất dữ liệu mới hơn.

Chạy thử trước

Chế độ dry run hỏi các store và báo cáo những gì sẽ xảy ra, mà không ghi gì cả.

Từng bước

Cách chuyển đổi từ RevenueCat trong bảy bước

Cả hai backend tiếp tục chạy cho đến khi bạn sẵn sàng chuyển hẳn, nên khách hàng dùng phiên bản ứng dụng cũ vẫn giữ quyền truy cập.

  1. Cài đặt openpurr

    Triển khai openpurr Lite lên tài khoản Cloudflare của bạn, cấp quyền truy cập API của App Store và Google Play, rồi tạo lại sản phẩm, entitlement và offering với cùng các identifier. Bạn thậm chí có thể giữ nguyên public SDK key của RevenueCat.

  2. Giữ cả hai backend được cập nhật

    Đặt openpurr làm Apple Server Notification Forwarding URL trong RevenueCat, và thêm push subscription của openpurr vào topic thông báo Play của bạn.

    Nguồn: RevenueCat: thông báo server của Apple (tiếng Anh)

  3. Lấy bản xuất dữ liệu

    Chỉ dùng App Store: Scheduled Data Export của RevenueCat đã có đủ những gì cần thiết. Với Google Play, hãy yêu cầu RevenueCat Support cung cấp bản xuất dữ liệu để chuyển đổi, vì chỉ bản đó có purchase token. Hướng dẫn có sẵn mẫu yêu cầu để bạn sao chép.

    Nguồn: RevenueCat: xuất dữ liệu hoặc chuyển đi (tiếng Anh)

  4. Import

    Chạy openpurr import, chạy thử dry run trước. Lỗi ở từng dòng riêng lẻ được ghi vào báo cáo và không làm dừng quá trình import.

  5. Phát hành bản cập nhật ứng dụng

    Thêm proxy URL và lệnh gọi syncPurchases một lần. Phát hành sau khi quá trình import đã hoàn tất.

  6. Kiểm tra

    openpurr doctor kiểm tra cài đặt. Tra cứu những khách hàng bạn biết, và so sánh số gói đăng ký đang hoạt động với biểu đồ của RevenueCat.

  7. Hoàn tất việc chuyển đổi

    Khi phần lớn khách hàng đã cập nhật, hãy trỏ Apple và Google thẳng tới openpurr, bật webhook của openpurr và tắt webhook của RevenueCat.

Mọi lệnh và cài đặt đều có trong hướng dẫn đầy đủ (tiếng Anh) →

Những gì được chuyển

Những gì được chuyển từ RevenueCat, và những gì không

Gói đăng ký và giao dịch mua, kèm gia hạn, hoàn tiền, thời gian ân hạn và hết hạnCó, lấy từ Apple và Google
Ai sở hữu giao dịch mua nàoCó, từ bản xuất dữ liệu của RevenueCat
App user ID, kể cả ID ẩn danhCó, giữ nguyên
Thuộc tính khách hàng ($email, $displayName và thuộc tính của riêng bạn)Có, từ Audience export
Sản phẩm, entitlement và offeringBạn tạo lại, với cùng các identifier
Lịch sử biểu đồ trước khi chuyển đổiMột phần: hãy lưu các file CSV biểu đồ của RevenueCat để tham khảo
Paywall, thử nghiệm, tích hợp, Customer CenterKhông: openpurr không có các tính năng này
Hỏi đáp

Hỏi đáp về chuyển đổi từ RevenueCat

Tôi có phải sửa code mua hàng không?

Không. openpurr hoạt động với Purchases SDK chính thức của RevenueCat, không chỉnh sửa. Bản cập nhật ứng dụng chỉ thêm proxy URL trước khi gọi configure, và một lệnh gọi syncPurchases một lần. getOfferings, purchase, restorePurchases, logIn và các hàm khác vẫn giữ nguyên.

Tôi có cần RevenueCat hỗ trợ để chuyển đổi không?

Với ứng dụng trên App Store thì không: Scheduled Data Export của RevenueCat đã có các mã giao dịch mà openpurr cần. Với Google Play thì có: theo tài liệu của RevenueCat, chỉ bản xuất dữ liệu để chuyển đổi do RevenueCat Support chuẩn bị mới có purchase token mà Google yêu cầu.

Còn những khách hàng không bao giờ cập nhật ứng dụng thì sao?

Quá trình import bao gồm cả họ: giao dịch mua của họ được lấy từ Apple và Google và gán cho đúng các app user ID cũ. Trong lúc họ vẫn dùng phiên bản ứng dụng cũ, phiên bản đó giao tiếp với RevenueCat, vì vậy cả hai backend đều được cập nhật cho đến khi phần lớn người dùng đã cập nhật ứng dụng.

Một lần import mất bao lâu?

Mỗi khách hàng cần khoảng 30 lượt ghi dòng vào cơ sở dữ liệu. Trên gói miễn phí của Cloudflare, con số đó tương đương khoảng 2.500 khách hàng mỗi ngày, và quá trình import tự tạm dừng khi chạm giới hạn hằng ngày rồi tiếp tục vào ngày hôm sau. Trên Workers Paid ($5 mỗi tháng), một lần import lớn chỉ mất vài giờ.

Dữ liệu của tôi có bị sao chép từ RevenueCat không?

Chỉ có thông tin app user nào sở hữu giao dịch mua nào trên store được chuyển sang, cộng thêm các thuộc tính nếu bạn import chúng. Bản thân các giao dịch mua được lấy trực tiếp từ Apple và Google, nên openpurr ghi lại trạng thái hiện tại theo các store, bao gồm cả gia hạn và hoàn tiền.

Sẵn sàng chuyển đổi?

Hướng dẫn đi qua từng bước. Nếu có điều gì trong cài đặt của bạn không phù hợp, hãy mở một issue: các trường hợp chuyển đổi thực tế định hình những gì được xây dựng tiếp theo.