Tạo sản phẩm

Cách bạn tạo sản phẩm trong Adapty phụ thuộc vào việc bạn đã có sản phẩm trong các cửa hàng hay chưa:

• Nếu sản phẩm chưa tồn tại trong App Store và/hoặc Google Play, hãy tạo chúng trong Adapty và đẩy lên các cửa hàng ngay lập tức.
• Nếu sản phẩm đã tồn tại trong App Store và/hoặc Google Play, hãy tạo chúng trong Adapty và kết nối với sản phẩm đã có trong cửa hàng.

Tạo sản phẩm và đẩy lên cửa hàng

Để thêm sản phẩm mới vào ứng dụng:

1. Vào Products từ menu chính của Adapty.

2. Nhấn Create product ở góc trên bên phải. Adapty hỗ trợ tất cả các loại sản phẩm: gói đăng ký, non-consumable (bao gồm quyền truy cập trọn đời) và consumable.

3. Chọn Create a new product and push to stores.

4. Nhập các thông tin sau:
   • Product name: nhập tên sản phẩm sẽ dùng trên Adapty dashboard. Tên này chủ yếu để bạn tham khảo, vì vậy hãy chọn tên nào tiện nhất cho bạn khi sử dụng trong Adapty Dashboard.
   • Access Level: Chọn mức độ truy cập mà sản phẩm thuộc về. Mức độ truy cập dùng để xác định các tính năng được mở khóa sau khi mua sản phẩm. Lưu ý rằng danh sách này chỉ chứa các mức độ truy cập đã được tạo trước đó. Mức độ truy cập premium được tạo sẵn trong Adapty theo mặc định, nhưng bạn cũng có thể thêm các mức độ truy cập khác.
   • Subscription duration: chọn thời hạn của gói đăng ký từ danh sách. Bạn không thể thay đổi sau khi sản phẩm đã được tạo.
     • Weekly/Monthly/2 Months/3 Months/6 Months/Annual: Thời hạn của gói đăng ký.
     • Lifetime: Dùng cho các sản phẩm mở khóa tính năng premium của ứng dụng vĩnh viễn.
     • Non-Subscriptions: Dành cho các sản phẩm mua một lần không có thời hạn. Sản phẩm mua một lần không cấp mức độ truy cập — nó xuất hiện trong mảng nonSubscriptions của hồ sơ người dùng, và ứng dụng của bạn tự quyết định những gì được mở khóa.
     • Consumables: Các mặt hàng consumable có thể được mua nhiều lần và sử dụng trong suốt vòng đời của ứng dụng. Ví dụ như tiền tệ trong game và các vật phẩm phụ trợ. Sản phẩm consumable cũng không cấp mức độ truy cập. Để cấp mức độ truy cập từ sản phẩm mua một lần, hãy dùng Lifetime.
   • Price (USD): Giá sản phẩm tính bằng USD. Giá này sẽ được dùng làm cơ sở để tự động tính toán và thiết lập giá cho tất cả các quốc gia. Bạn có thể tùy chỉnh giá cho từng quốc gia và khu vực sau.

5. Nhấp Save & Continue.
6. Cấu hình thông tin sản phẩm cho App Store nếu bạn có kế hoạch xuất bản ở đó:
   • Product ID: Tạo ID duy nhất và cố định cho sản phẩm.
   • Product group: Chọn nhóm sản phẩm hiện có mà bạn đã tạo trong App Store Connect hoặc nhấp Create new Product Group và đặt tên cho nhóm đó. Sau khi Adapty tạo xong, bạn có thể chọn từ danh sách thả xuống.
   • Screenshot: Tải lên ảnh chụp màn hình của in-app purchase thể hiện rõ sản phẩm hoặc dịch vụ được cung cấp. Ảnh chụp màn hình này chỉ dùng cho quá trình xét duyệt App Store và không được hiển thị trên App Store. Xem yêu cầu về kích thước và định dạng ảnh chụp màn hình tại đây.

7. Nhấp Push data to App Store.

8. Cấu hình thông tin sản phẩm cho Google Play nếu bạn có kế hoạch xuất bản ở đó:
   • Base Product ID: Tạo ID duy nhất và cố định cho sản phẩm.
   • Subscription: Chọn nhóm gói đăng ký hiện có mà bạn đã tạo trong Google Play Console hoặc nhấp Create new Product Group và đặt tên và ID cho nhóm đó. Sau khi Adapty tạo xong, bạn có thể chọn từ danh sách thả xuống.
   Note

   Grace Period và Account Hold Period sẽ được tự động đặt về giá trị mặc định theo quy định của Play Store. Bạn có thể thay đổi chúng sau trong Google Play Console.

9. Nhấp Push data to Play Store.
10. Đối với iOS, cấu hình ưu đãi giới thiệu – dùng thử miễn phí – bằng cách chọn Free duration từ danh sách thả xuống. Trong thiết lập ban đầu này, bạn có thể thêm thời gian dùng thử miễn phí giới thiệu. Sau khi sản phẩm chính được các cửa hàng phê duyệt, bạn có thể thêm các ưu đãi khác (ví dụ: ưu đãi, ưu đãi thu hút khách hàng cũ) bằng cách liên kết ID hiện có từ console của cửa hàng.

11. Cuối cùng, nhấp Save để xác nhận tạo sản phẩm.

Tạo sản phẩm và kết nối sản phẩm hiện có trong cửa hàng

Để thêm sản phẩm mới vào ứng dụng:

1. Vào Products từ menu chính của Adapty.

2. Nhấn Create product ở góc trên bên phải. Adapty hỗ trợ tất cả các loại sản phẩm: gói đăng ký, non-consumable (bao gồm cả trọn đời), và consumable.

3. Chọn Connect an existing store product.

4. Nhập các thông tin sau:

   • Product name: nhập tên sản phẩm sẽ được sử dụng trong Adapty dashboard. Tên này chủ yếu để bạn tham khảo, vì vậy hãy chọn tên nào tiện lợi nhất cho bạn khi sử dụng trong Adapty Dashboard.

   • Access Level ID: chọn mức độ truy cập mà sản phẩm thuộc về. Mức độ truy cập dùng để xác định các tính năng được mở khóa sau khi mua sản phẩm. Lưu ý danh sách này chỉ chứa các mức độ truy cập đã được tạo trước đó. Mức độ truy cập premium được tạo sẵn trong Adapty, nhưng bạn cũng có thể thêm mức độ truy cập khác.

• Subscription duration: chọn thời hạn gói đăng ký từ danh sách. Bạn không thể thay đổi sau khi sản phẩm đã được tạo.
  • Weekly/Monthly/2 Months/3 Months/6 Months/Annual: Thời hạn gói đăng ký.
  • Lifetime: Dùng cho các sản phẩm cấp quyền truy cập trọn đời vào các tính năng premium của ứng dụng.
  • Non-Subscriptions: Dành cho sản phẩm mua một lần, không có thời hạn. Sản phẩm mua một lần dạng này không cấp mức độ truy cập — nó xuất hiện trong mảng nonSubscriptions của hồ sơ người dùng, và ứng dụng của bạn tự quyết định mở khóa gì.
  • Consumables: Consumable có thể được mua nhiều lần và sử dụng hết trong vòng đời ứng dụng. Ví dụ như tiền tệ trong game hay các vật phẩm bổ sung. Consumable cũng không cấp mức độ truy cập. Để cấp mức độ truy cập từ sản phẩm mua một lần, hãy dùng Lifetime.
  • Price (USD): Giá sản phẩm tính bằng USD. Nếu sản phẩm của bạn đã có trên cửa hàng, giá trị này sẽ không ảnh hưởng đến giá thực tế; bạn có thể chọn bất kỳ giá trị nào trong danh sách. Sau này, bạn có thể tùy chỉnh giá theo từng khu vực ngay trong Adapty Dashboard.

5. Nhấp Continue.

6. Cấu hình thông tin sản phẩm từ mỗi cửa hàng:

   • App Store:
     • App Store Product ID: Mã định danh duy nhất này được dùng để truy cập sản phẩm trên thiết bị. Chọn từ danh sách. Nếu không thấy trong danh sách, hãy kiểm tra cấu hình trong App Store Connect và đảm bảo nó chính xác và thuộc ứng dụng này.
   • Play Store:
     • Google Play Product ID: Đây là mã định danh sản phẩm từ Play Store. Chọn từ danh sách. Nếu không thấy trong danh sách, hãy kiểm tra cấu hình trong Google Play Console và đảm bảo nó chính xác và thuộc ứng dụng này.
     • Base Plan ID: ID này dùng để xác định base plan cho sản phẩm trên Play Store. Khi thêm Product ID của gói đăng ký trên Play Store, bạn cần cung cấp Base Plan ID. Một base plan xác định các chi tiết cơ bản của gói đăng ký, bao gồm chu kỳ thanh toán, loại gia hạn (tự động gia hạn hoặc trả trước) và giá tương ứng. Lưu ý rằng trong Adapty, mỗi sự kết hợp giữa cùng một gói đăng ký và các base plan khác nhau được coi là sản phẩm riêng biệt.
     • Legacy fallback product: Sản phẩm dự phòng này chỉ được dùng cho các ứng dụng sử dụng phiên bản SDK Adapty cũ hơn (phiên bản 2.5 trở xuống). Bằng cách đánh dấu sản phẩm là tương thích ngược trong Google Play Console, Adapty có thể xác định liệu nó có thể được mua bởi các phiên bản SDK cũ hay không. Đối với trường này, hãy chỉ định giá trị theo định dạng <subscription_id>:<base_plan_id>.
   • Stripe:
     • Stripe Product ID: Đây là mã định danh duy nhất cho sản phẩm trong Stripe.
     • Stripe Price ID: Trong Stripe, các đối tượng price bao gồm nhiều hơn chỉ là số tiền; chúng còn bao gồm cả hành vi thuế, bậc khối lượng và khoảng thời gian gói đăng ký. Vì một sản phẩm có thể có nhiều mức giá, hãy chỉ định đúng price ID khi tạo sản phẩm trong Adapty.
   • Paddle:
     • Paddle Product ID: Đây là mã định danh duy nhất cho sản phẩm trong Paddle.
     • Paddle Price ID: Trong Paddle, các đối tượng price bao gồm nhiều hơn chỉ là số tiền; chúng còn bao gồm cả hành vi thuế, bậc khối lượng và khoảng thời gian gói đăng ký. Vì một sản phẩm có thể có nhiều mức giá, hãy chỉ định đúng price ID khi tạo sản phẩm trong Adapty.

7. Tùy chọn: Bạn có thể thêm sản phẩm từ bất kỳ cửa hàng tùy chỉnh nào bằng cách nhấp Add custom store. Trong cửa sổ Manage custom store info, bạn có thể chọn cửa hàng tùy chỉnh hiện có hoặc thêm cửa hàng mới và liên kết sản phẩm với nó. Lưu ý rằng Adapty chỉ theo dõi giao dịch từ App Store, Google Play và Stripe. Đối với các cửa hàng tùy chỉnh, bạn cần gửi giao dịch bằng phương thức Set transaction của Adapty server-side API.

8. Nhấp Save product để hoàn tất việc tạo sản phẩm. Quá trình đồng bộ trạng thái sản phẩm có thể mất đến năm phút, vì vậy hãy đợi cho đến khi chúng cập nhật trong bảng.

9. Bạn có thể tạo offer cho sản phẩm nếu cần. Để thêm offer, nhấp Yes, add offers. Nếu không, nhấp No, thanks.

Các bước tiếp theo

Chúc mừng! Bạn đã thêm sản phẩm vào Adapty. Tiếp theo là gì?

• Nếu bạn chưa cấu hình ưu đãi giới thiệu/ưu đãi, bạn có thể thực hiện ngay.
• Nếu bạn không muốn làm việc đó hoặc đã làm xong, hãy tiến hành thiết lập paywall để bật in-app purchase.
• Nếu bạn muốn điều chỉnh sản phẩm trong cửa hàng (ví dụ: đặt giá theo khu vực hoặc cấu hình thời gian ân hạn), hãy thực hiện trong App Store Connect hoặc Google Play Console.
• Đọc thêm về cách chỉnh sửa sản phẩm sau này.