Cà i đặt ứng dụng
Bạn có thể Ä‘iá»u hÆ°á»›ng đến tab General của trang App Settings để quản lý hà nh vi, giao diện và chia sẻ doanh thu của ứng dụng. Tại đây, bạn có thể tùy chỉnh tên và biểu tượng ứng dụng, quản lý các khóa Adapty SDK và API, thiết láºp trạng thái ChÆ°Æ¡ng trình Doanh nghiệp Nhá», và chá»n múi giá» cho analytics và biểu đồ của ứng dụng.
1. Chi tiết ứng dụng
Chá»n tên và biểu tượng duy nhất đại diện cho ứng dụng của bạn trong giao diện Adapty. LÆ°u ý rằng tên và biểu tượng ứng dụng sẽ không ảnh hưởng đến tên và biểu tượng ứng dụng trên App Store hoặc Google Play. Ngoà i ra, hãy chắc chắn chá»n Danh mục ứng dụng phù hợp phản ánh đúng mục Ä‘Ãch và ná»™i dung của ứng dụng. Äiá»u nà y sẽ giúp ngÆ°á»i dùng khám phá ứng dụng của bạn và đảm bảo nó xuất hiện trong các danh mục cá»a hà ng ứng dụng phù hợp.
2. Thà nh viên Chương trình Doanh nghiệp NhỠvà Phà Dịch vụ Giảm
Nếu tổ chức của bạn đã đăng ký ChÆ°Æ¡ng trình Doanh nghiệp Nhá» của Apple hoặc chÆ°Æ¡ng trình Phà Dịch vụ Giảm của Google, ứng dụng của bạn sẽ được hưởng mức hoa hồng cá»a hà ng giảm.
Hãy thông báo cho Adapty nếu ứng dụng của bạn đã đăng ký chÆ°Æ¡ng trình hoa hồng giảm. Äể đảm bảo tÃnh toán chÃnh xác, hãy chỉ định trạng thái của các chÆ°Æ¡ng trình nà y trong phần “Reduced Store Feeâ€.
Cà i đặt phà giảm chỉ áp dụng cho các giao dịch trong tÆ°Æ¡ng lai. Hãy thay đổi trạng thái của bạn trÆ°á»›c khi nó có hiệu lá»±c, và Adapty sẽ Ä‘iá»u chỉnh tá»· lệ hoa hồng.
- Nếu bạn gia hạn tham gia chÆ°Æ¡ng trình phà giảm, hãy thêm thêm má»™t khoảng thá»i gian đủ Ä‘iá»u kiện.
- Nếu bạn mất tÆ° cách thà nh viên chÆ°Æ¡ng trình, hãy thay đổi ngà y hết hạn của khoảng thá»i gian đủ Ä‘iá»u kiện hiện tại.
Các bà i viết sau đây khám phá chủ đỠnà y sâu hơn:
3. Múi giỠbáo cáo
Chá»n múi giá» tÆ°Æ¡ng ứng vá»›i vị trà bạn Ä‘ang ở, hoặc nÆ¡i analytics và biểu đồ của ứng dụng có liên quan nhất. Chúng tôi khuyến nghị sá» dụng cùng múi giá» vá»›i tà i khoản App Store Connect hoặc Google Play Console để đảm bảo tÃnh nhất quán. LÆ°u ý rằng cà i đặt múi giá» nà y không ảnh hưởng đến các tÃch hợp bên thứ ba trong hệ thống Adapty, vốn sá» dụng múi giá» UTC.
Bạn có thể truy cáºp cà i đặt múi giá» trong phần Reported timezone của tab General trên trang App Settings. Bạn cÅ©ng có thể chá»n đặt cùng má»™t múi giá» cho tất cả các ứng dụng trong tà i khoản Adapty của mình bằng cách đánh dấu và o ô tÆ°Æ¡ng ứng.
4. Äịnh nghÄ©a lượt cà i đặt cho analytics
Chá»n Ä‘iá»u gì được định nghÄ©a là má»™t sá»± kiện cà i đặt má»›i trong analytics:
| Cơ sở | Mô tả |
|---|---|
| New device_ids | (Khuyến nghị) Má»—i lần cà i đặt ứng dụng từ cá»a hà ng trên má»™t thiết bị được tÃnh là má»™t lượt cà i đặt má»›i. Äiá»u nà y bao gồm cả lần cà i đặt đầu tiên và cà i đặt lại. Lượt cà i đặt được tÃnh theo ID thiết bị và không bị ảnh hưởng bởi xác thá»±c ngÆ°á»i dùng. Tạo hồ sÆ¡ ngÆ°á»i dùng (khi kÃch hoạt SDK hoặc đăng xuất), đăng nháºp hoặc nâng cấp ứng dụng không tạo ra thêm sá»± kiện cà i đặt. Và dụ: nếu cùng má»™t ứng dụng được cà i đặt trên 5 thiết bị khác nhau, bạn sẽ thấy 5 lượt cà i đặt trong analytics. |
| New customer_user_ids | Tùy chá»n nà y dà nh cho các ứng dụng xác định ngÆ°á»i dùng trong Adapty iOS, Android, React Native, Flutter, Unity, Kotlin Multiplatform, Capacitor . Äối vá»›i ngÆ°á»i dùng đã đăng nháºp, chỉ lần cà i đặt đầu tiên gắn vá»›i customer user ID má»›i được tÃnh là má»™t lượt cà i đặt. Cà i đặt trên các thiết bị bổ sung không được tÃnh là lượt cà i đặt má»›i. NgÆ°á»i dùng ẩn danh (ngÆ°á»i dùng chÆ°a đăng nháºp) không được tÃnh trong analytics. Cà i đặt lại ứng dụng hoặc đăng nháºp lại không tạo thêm lượt cà i đặt. Các cá»a hà ng ứng dụng và ná»n tảng attribution (nhÆ° App Store Connect, Google Play Console và AppsFlyer) sá» dụng phÆ°Æ¡ng pháp dá»±a trên thiết bị để đếm lượt cà i đặt. Nếu bạn đếm lượt cà i đặt theo customer user ID trong Adapty, số lượt cà i đặt có thể khác vá»›i các dịch vụ bên ngoà i nà y. âš ï¸ Nếu bạn không xác định ngÆ°á»i dùng trong Adapty, sẽ không có lượt cà i đặt nà o được tÃnh khi báºt tùy chá»n nà y. |
| New profiles in Adapty | (Legacy) Má»—i lần cà i đặt, cà i đặt lại ứng dụng và các hồ sÆ¡ ngÆ°á»i dùng ẩn danh được tạo ra trong quá trình đăng xuất Ä‘á»u được tÃnh là lượt cà i đặt má»›i. |
LÆ°u ý rằng tùy chá»n nà y chỉ ảnh hưởng đến trang Analytics và không tác Ä‘á»™ng đến trang Overview, nÆ¡i bạn có thể cấu hình chế Ä‘á»™ xem riêng.
5. Logic tăng giá trên App Store
Äể duy trì dữ liệu chÃnh xác và tránh sá»± khác biệt giữa analytics Adapty và kết quả từ App Store Connect, Ä‘iá»u quan trá»ng là phải chá»n tùy chá»n phù hợp khi Ä‘iá»u chỉnh các cấu hình liên quan đến tăng giá trong App Store Connect. Vì váºy, bạn có thể chá»n logic sẽ được áp dụng cho việc tăng giá gói đăng ký trong Adapty:
- Giá gói đăng ký cho ngÆ°á»i dùng hiện tại được giữ nguyên: Bằng cách chá»n tùy chá»n nà y, giá hiện tại sẽ được giữ lại cho những ngÆ°á»i đăng ký hiện có, ngay cả khi bạn thay đổi giá trong App Store Connect. Äiá»u nà y có nghÄ©a là ngÆ°á»i đăng ký hiện tại sẽ tiếp tục bị tÃnh phà theo giá gói đăng ký ban đầu của há».
- Khi giá gói đăng ký thay đổi trong App Store Connect, nó sẽ thay đổi cho cả ngÆ°á»i đăng ký hiện tại: Nếu bạn chá»n tùy chá»n nà y, má»i thay đổi vá» giá được thá»±c hiện trong App Store Connect cÅ©ng sẽ được áp dụng cho ngÆ°á»i đăng ký hiện có. Äiá»u nà y có nghÄ©a là ngÆ°á»i đăng ký hiện tại sẽ bị tÃnh phà theo giá má»›i phản ánh mức giá được cáºp nháºt trong App Store Connect.
Äiá»u quan trá»ng cần lÆ°u ý là tùy chá»n được chá»n không chỉ ảnh hưởng đến analytics trong Adapty mà còn tác Ä‘á»™ng đến các tÃch hợp và hà nh vi xá» lý giao dịch tổng thể.
Hãy đảm bảo rằng bạn chá»n tùy chá»n phù hợp vá»›i cách tiếp cáºn mong muốn của mình khi xá» lý giá gói đăng ký cho ngÆ°á»i đăng ký hiện tại. Äiá»u nà y sẽ giúp duy trì dữ liệu chÃnh xác và đồng bá»™ hóa giữa analytics Adapty và kết quả thu được từ App Store Connect.
6. Chia sẻ mức Ä‘á»™ truy cáºp có trả phà giữa các tà i khoản ngÆ°á»i dùng
Cà i đặt Sharing paid access between user accounts xác định Adapty sẽ là m gì khi có nhiá»u hÆ¡n má»™t hồ sÆ¡ ngÆ°á»i dùng cố gắng truy cáºp cùng má»™t giao dịch mua. Bạn có thể chỉ định cà i đặt chia sẻ quyá»n truy cáºp riêng biệt cho môi trÆ°á»ng sandbox.
Enabled (mặc định)
NgÆ°á»i dùng đã xác định (những ngÆ°á»i có Customer User ID) có thể chia sẻ cùng má»™t mức Ä‘á»™ truy cáºp do Adapty cung cấp nếu thiết bị của hỠđăng nháºp và o cùng má»™t Apple/Google ID. Äiá»u nà y hữu Ãch khi ngÆ°á»i dùng cà i lại ứng dụng và đăng nháºp bằng email khác — há» vẫn có thể truy cáºp và o giao dịch mua trÆ°á»›c đó. Vá»›i tùy chá»n nà y, nhiá»u ngÆ°á»i dùng đã xác định có thể dùng chung má»™t mức Ä‘á»™ truy cáºp.
Dù mức Ä‘á»™ truy cáºp được chia sẻ, tất c ÿÿ ả các giao dịch trong quá khứ và tÆ°Æ¡ng lai vẫn được ghi lại dÆ°á»›i dạng sá»± kiện trong Customer User ID gốc để đảm bảo tÃnh nhất quán của dữ liệu phân tÃch và lÆ°u giữ toà n bá»™ lịch sá» giao dịch — bao gồm thá»i gian dùng thá», mua gói đăng ký, gia hạn, v.v., Ä‘á»u được liên kết vá»›i cùng má»™t hồ sÆ¡ ngÆ°á»i dùng.
Transfer access to new user
NgÆ°á»i dùng đã xác định vẫn có thể tiếp tục truy cáºp mức Ä‘á»™ truy cáºp do Adapty cung cấp, ngay cả khi hỠđăng nháºp bằng Customer User ID khác hoặc cà i lại ứng dụng, miá»…n là thiết bị đăng nháºp và o cùng má»™t Apple/Google ID.
Khác vá»›i tùy chá»n trÆ°á»›c, Adapty sẽ chuyển giao dịch mua giữa các ngÆ°á»i dùng đã xác định. Äiá»u nà y đảm bảo ná»™i dung đã mua vẫn khả dụng, nhÆ°ng chỉ má»™t ngÆ°á»i dùng có thể truy cáºp tại má»™t thá»i Ä‘iểm. Và dụ: nếu UserA mua gói đăng ký và UserB đăng nháºp trên cùng thiết bị đó và khôi phục giao dịch, UserB sẽ được cấp quyá»n truy cáºp gói đăng ký đó, còn UserA sẽ bị thu hồi.
Nếu má»™t trong hai ngÆ°á»i dùng (má»›i hoặc cÅ©) chÆ°a được xác định, mức Ä‘á»™ truy cáºp vẫn sẽ được chia sẻ giữa các hồ sÆ¡ ngÆ°á»i dùng đó trong Adapty.
Dù mức Ä‘á»™ truy cáºp được chuyển giao, tất cả các giao dịch trong quá khứ và tÆ°Æ¡ng lai vẫn được ghi lại dÆ°á»›i dạng sá»± kiện trong Customer User ID gốc để đảm bảo tÃnh nhất quán của dữ liệu phân tÃch và lÆ°u giữ toà n bá»™ lịch sá» giao dịch — bao gồm thá»i gian dùng thá», mua gói đăng ký, gia hạn, v.v., Ä‘á»u được liên kết vá»›i cùng má»™t hồ sÆ¡ ngÆ°á»i dùng.
Sau khi chuyển sang Transfer access to new user, mức Ä‘á»™ truy cáºp sẽ không được chuyển ngay láºp tức giữa các hồ sÆ¡ ngÆ°á»i dùng. Quá trình chuyển giao cho từng mức Ä‘á»™ truy cáºp cụ thể chỉ được kÃch hoạt khi Adapty nháºn được sá»± kiện từ cá»a hà ng, chẳng hạn nhÆ° gia hạn gói đăng ký, khôi phục, hoặc khi xác thá»±c giao dịch.
Disabled
Hồ sÆ¡ ngÆ°á»i dùng đã xác định đầu tiên được cấp mức Ä‘á»™ truy cáºp sẽ giữ nó mãi mãi. Äây là lá»±a chá»n tốt nhất nếu logic nghiệp vụ của bạn yêu cầu giao dịch mua phải được gắn vá»›i má»™t Customer User ID duy nhất.
LÆ°u ý rằng mức Ä‘á»™ truy cáºp vẫn được chia sẻ giữa các ngÆ°á»i dùng ẩn danh.
Bạn có thể “gỡ liên kết†giao dịch mua bằng cách xóa hồ sÆ¡ ngÆ°á»i dùng của chủ sở hữu. Sau khi xóa, mức Ä‘á»™ truy cáºp sẽ khả dụng cho hồ sÆ¡ ngÆ°á»i dùng đầu tiên yêu cầu nó, dù là ẩn danh hay đã xác định.
Việc tắt chia sẻ chỉ ảnh hưởng đến ngÆ°á»i dùng má»›i. Các gói đăng ký đã được chia sẻ giữa ngÆ°á»i dùng sẽ tiếp tục được chia sẻ ngay cả sau khi tắt tùy chá»n nà y.
Apple và Google yêu cầu in-app purchase phải được chia sẻ hoặc chuyển giao giữa các ngÆ°á»i dùng vì há» dá»±a và o Apple/Google ID để liên kết giao dịch mua. Nếu không có chia sẻ, việc khôi phục giao dịch mua có thể không hoạt Ä‘á»™ng sau khi cà i lại ứng dụng.
Tắt chia sẻ có thể khiến ngÆ°á»i dùng không thể lấy lại quyá»n truy cáºp sau khi đăng nháºp.
Chúng tôi khuyến nghị chỉ tắt chia sẻ nếu ngÆ°á»i dùng của bạn bắt buá»™c phải đăng nháºp trÆ°á»›c khi thá»±c hiện giao dịch mua. Nếu không, má»™t ngÆ°á»i dùng đã xác định có thể mua gói đăng ký, đăng nháºp và o tà i khoản khác và mất quyá»n truy cáºp vÄ©nh viá»…n.
Tôi nên chá»n cà i đặt nà o?
| Ứng dụng của tôi… | Tùy chá»n nên chá»n |
|---|---|
| Không có hệ thống đăng nháºp và chỉ sá» dụng ID hồ sÆ¡ ngÆ°á»i dùng ẩn danh của Adapty. | Dùng tùy chá»n mặc định, vì mức Ä‘á»™ truy cáºp luôn được chia sẻ giữa các ID hồ sÆ¡ ngÆ°á»i dùng ẩn danh cho cả ba tùy chá»n. |
| Có hệ thống đăng nháºp tùy chá»n và cho phép khách hà ng mua trÆ°á»›c khi tạo tà i khoản. | Chá»n Transfer access to new user để đảm bảo những khách hà ng mua khi chÆ°a có tà i khoản vẫn có thể khôi phục giao dịch sau nà y. |
| Yêu cầu khách hà ng tạo tà i khoản trÆ°á»›c khi mua, nhÆ°ng cho phép giao dịch mua được liên kết vá»›i nhiá»u Customer User ID. | Chá»n Transfer access to new user để đảm bảo chỉ má»™t Customer User ID có quyá»n truy cáºp tại má»™t thá»i Ä‘iểm, đồng thá»i vẫn cho phép ngÆ°á»i dùng đăng nháºp bằng Customer User ID khác mà không mất quyá»n truy cáºp đã trả phÃ. |
| Yêu cầu khách hà ng tạo tà i khoản trÆ°á»›c khi mua, vá»›i quy tắc nghiêm ngặt rà ng buá»™c giao dịch mua vá»›i má»™t Customer User ID duy nhất. | Chá»n Disabled để đảm bảo giao dịch không bao giỠđược chuyển giao giữa các tà i khoản. |
7. Khóa SDK và API
Sá» dụng Public SDK key để tÃch hợp Adapty SDK và o ứng dụng của bạn, và Secret Key để truy cáºp Server API của Adapty. Bạn có thể tạo khóa má»›i hoặc thu hồi khóa hiện có khi cần. Äể tạo token cho Developer CLI, hãy và o Settings → Developer API. Xem Authentication.
8. Thiết bị kiểm thá»
Chỉ định các thiết bị sẽ được sá» dụng để kiểm thá» nhằm đảm bảo chúng nháºn được cáºp nháºt tức thì cho các thay đổi vá» paywall hoặc placement, bá» qua bất kỳ Ä‘á»™ trá»… bá»™ nhá»› đệm nà o. Äể biết thêm thông tin, xem Testing devices.
9. TÃnh nhất quán biến thể xuyên placement
Xác định thá»i gian bao lâu sau khi hoà n thà nh má»™t test, ngÆ°á»i dùng vẫn được phục vụ vá»›i các biến thể trong test đó. Äiá»u nà y ảnh hưởng đến Ä‘á»™ chÃnh xác của analytics và trải nghiệm ngÆ°á»i dùng — vì việc hiển thị cho ngÆ°á»i dùng má»™t Æ°u đãi khác vá»›i những gì hỠđã thấy trÆ°á»›c đó có thể ảnh hưởng đến quyết định mua hà ng của há».
Thá»i gian nhất quán tối Ä‘a và mặc định là 90 ngà y.
Hãy lÆ°u ý những Ä‘iá»u sau:
- Thay đổi cà i đặt nà y sẽ ảnh hưởng đến tất cả những ngÆ°á»i dùng đã nháºn được má»™t biến thể trÆ°á»›c đó. Há» sẽ ngay láºp tức đủ Ä‘iá»u kiện cho má»™t paywall má»›i khi thấy má»™t placement, Ä‘iá»u nà y có thể là m há»ng kết quả của các A/B test Ä‘ang chạy.
- Nếu thá»i gian nhất quán đã hết cho má»™t ngÆ°á»i dùng, há» có thể được phục vụ vá»›i má»™t paywall hoặc A/B test má»›i. Tuy nhiên, ngay cả khi đó, há» sẽ không thể tham gia và o bất kỳ cross-placement test nà o khác.
10. Xóa ứng dụng
Nếu bạn không còn cần má»™t ứng dụng nữa, bạn có thể xóa nó khá»i Adapty.
Xin lưu ý rằng hà nh động nà y không thể hoà n tác, và bạn sẽ không thể khôi phục ứng dụng hoặc dữ liệu của nó.