Các lệnh Adapty CLI này quản lý sản phẩm, ánh xạ chúng với ID sản phẩm trên App Store và Google Play, cũng như liên kết ưu đãi từ cửa hàng vào sản phẩm.

Sản phẩm

Danh sách sản phẩm Adapty

Liệt kê tất cả sản phẩm của một ứng dụng.

adapty products list --app <app-id>

Flag	Bắt buộc	Mô tả
--app	Có	App ID (UUID)

Hỗ trợ pagination flags.

adapty products get

Xem chi tiết cho một sản phẩm cụ thể.

adapty products get --app <app-id> <product-id>

Argument	Description
product-id	Product ID (UUID)

Flag	Required	Description
--app	Yes	App ID (UUID)

adapty products create

Tạo một sản phẩm mới.

adapty products create --app <app-id> --title "Monthly" --access-level-id <access-level-id> --period monthly --ios-product-id com.example.monthly

Cờ	Bắt buộc	Mô tả
--app	Có	ID ứng dụng (UUID)
--title	Có	Tiêu đề sản phẩm
--access-level-id	Có	ID (UUID) của mức độ truy cập mà sản phẩm này mở khóa
--period	Có	Chu kỳ gói đăng ký: weekly, monthly, two_months, trimonthly, semiannual, annual, lifetime
--ios-product-id	Bắt buộc có ít nhất một cửa hàng	ID sản phẩm từ App Store Connect
--android-product-id	Bắt buộc có ít nhất một cửa hàng	ID sản phẩm từ Google Play Console
--android-base-plan-id	Bắt buộc khi dùng --android-product-id trừ khi --period lifetime	ID base plan từ Google Play Console
--stripe-product-id	Bắt buộc có ít nhất một cửa hàng	ID sản phẩm từ Stripe
--stripe-price-id	Bắt buộc khi dùng --stripe-product-id	ID giá từ Stripe
--paddle-product-id	Bắt buộc có ít nhất một cửa hàng	ID sản phẩm từ Paddle
--paddle-price-id	Bắt buộc khi dùng --paddle-product-id	ID giá từ Paddle

Mỗi sản phẩm cần ít nhất một cửa hàng: --ios-product-id, --android-product-id, --stripe-product-id, hoặc --paddle-product-id. Một sản phẩm có thể chứa ID của nhiều cửa hàng cùng lúc.

Để bán sản phẩm trên web qua Stripe hoặc Paddle, hãy kết nối nhà cung cấp thanh toán với Adapty trước: xem Stripe và Paddle. Với mỗi cửa hàng này, cần truyền cả product ID lẫn price ID. Lệnh sẽ thất bại nếu bạn chỉ truyền một trong hai.

adapty products create --app <app-id> --title "Monthly" --access-level-id <access-level-id> --period monthly --stripe-product-id prod_xxx --stripe-price-id price_xxx

Sản phẩm chỉ dành cho web hoàn toàn hợp lệ: bạn có thể tạo sản phẩm chỉ với Stripe hoặc Paddle ID mà không cần App Store hay Google Play ID.

adapty products update

Cập nhật một sản phẩm hiện có.

ID sản phẩm trên cửa hàng và ID giá không thể thay đổi sau khi tạo và không có sẵn trong lệnh này. Để sử dụng các ID cửa hàng khác, hãy tạo sản phẩm mới.

adapty products update --app <app-id> <product-id> --title "Monthly" --access-level-id <access-level-id>

Argument	Description
product-id	Product ID (UUID)

Flag	Bắt buộc	Mô tả
--app	Có	ID ứng dụng (UUID)
--title	Không	Tiêu đề sản phẩm
--access-level-id	Không	ID (UUID) của mức độ truy cập mà sản phẩm này mở khóa

Ưu đãi sản phẩm

Liên kết các ưu đãi bạn đã tạo trong App Store Connect hoặc Google Play Console với một sản phẩm Adapty để Adapty có thể áp dụng chúng. Để biết từng loại ưu đãi làm gì và cách tạo ưu đãi trong cửa hàng, xem Thêm ưu đãi vào Adapty.

Thêm các ưu đãi sau:

• Ưu đãi và ưu đãi thu hút khách hàng cũ trên App Store.
• Tất cả ưu đãi trên Google Play, bao gồm cả dùng thử miễn phí. Google Play không có loại ưu đãi giới thiệu, vì vậy bản dùng thử là một ưu đãi trên base plan và chỉ áp dụng sau khi bạn liên kết nó trong Adapty.

Không thêm ưu đãi giới thiệu của App Store: chúng tự động áp dụng cho người dùng đủ điều kiện.

Một ưu đãi đã được liên kết vẫn cần được chọn cho sản phẩm trong một flow hoặc một paywall trước khi người dùng có thể thấy nó. Để chọn ưu đãi trong paywall, hãy dùng Adapty Dashboard: xem Hiển thị ưu đãi.

adapty products list và adapty products get hiển thị số lượng ưu đãi được liên kết với mỗi sản phẩm trong offers_count. Con số này chỉ bao gồm các ưu đãi đã được liên kết trong Adapty, không bao gồm các ưu đãi tồn tại trong các cửa hàng.

adapty product-offers list

Liệt kê tất cả các ưu đãi được liên kết với một sản phẩm.

adapty product-offers list --app <app-id> --product <product-id>

Flag	Bắt buộc	Mô tả
--app	Có	App ID (UUID)
--product	Có	Product ID (UUID)

Trả về tất cả ưu đãi trong một trang và không chấp nhận pagination flags.

adapty product-offers get

Lấy thông tin chi tiết của một ưu đãi cụ thể.

adapty product-offers get --app <app-id> <offer-id>

Argument	Description
offer-id	Offer ID (UUID)

Flag	Required	Description
--app	Yes	App ID (UUID)

adapty product-offers create

Liên kết một ưu đãi từ cửa hàng với một sản phẩm.

adapty product-offers create --app <app-id> --product <product-id> --title "Spring" --type promotional --ios-offer-id spring_ios --android-offer-id spring-android

Flag	Required	Description
--app	Yes	App ID (UUID)
--product	Yes	Product ID (UUID)
--title	Yes	Tên ưu đãi, chỉ hiển thị trên Adapty Dashboard
--type	Yes	Loại ưu đãi: promotional hoặc win_back
--ios-offer-id	Bắt buộc có ít nhất một cửa hàng	Offer ID từ App Store Connect
--android-offer-id	Bắt buộc có ít nhất một cửa hàng	Offer ID từ Google Play Console

Ưu đãi thu hút khách hàng cũ chỉ dành cho App Store, vì vậy --type win_back chỉ nhận --ios-offer-id. Đối với mọi ưu đãi trên Google Play, kể cả dùng thử miễn phí, hãy dùng --type promotional.

adapty product-offers create --app <app-id> --product <product-id> --title "Come back" --type win_back --ios-offer-id winback_ios

adapty product-offers update

Cập nhật một ưu đãi hiện có.

adapty product-offers update --app <app-id> <offer-id> --title "Spring 2"

Đối số	Mô tả
offer-id	ID ưu đãi (UUID)

Cờ	Bắt buộc	Mô tả
--app	Có	App ID (UUID)
--title	Không	Tên ưu đãi
--type	Không	Loại ưu đãi: promotional hoặc win_back. Để chuyển ưu đãi sang win_back, hãy xóa phần Google Play bằng --clear-android-offer-id
--ios-offer-id	Không	App Store offer ID mới
--android-offer-id	Không	Google Play offer ID mới
--clear-ios-offer-id	Không	Xóa phần App Store của ưu đãi
--clear-android-offer-id	Không	Xóa phần Google Play của ưu đãi

Cần có ít nhất một flag ngoài --app. Các trường không được chỉ định sẽ giữ nguyên giá trị hiện tại. Mỗi ưu đãi phải có ít nhất một store offer ID, vì vậy lệnh sẽ thất bại nếu thao tác sẽ xóa cái cuối cùng.

Không thể cập nhật ưu đãi giới thiệu. Ưu đãi thuộc cửa hàng khác ngoài App Store hoặc Google Play cũng không thể cập nhật từ CLI: hãy chỉnh sửa trên Adapty Dashboard.

Để xóa một ưu đãi, hãy sử dụng Adapty Dashboard. CLI không có lệnh xóa.

Tiếp theo

• Tham khảo lệnh — tất cả các chủ đề CLI, cờ toàn cục và cờ phân trang.