Ürünler ve ürün teklifleri komutları

Bu Adapty CLI komutları ürünleri yönetir, bunları App Store ve Google Play ürün ID’leriyle eşleştirir ve mağaza tekliflerini bunlara bağlar.

Ürünler

adapty products list

Bir uygulama için tüm ürünleri listeler.

adapty products list --app <app-id>

Bayrak	Zorunlu	Açıklama
`--app`	Evet	Uygulama kimliği (UUID)

Sayfalama bayraklarını kabul eder.

adapty products get

Belirli bir ürün hakkında ayrıntıları alır.

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

Argüman	Açıklama
`product-id`	Ürün ID (UUID)

Bayrak	Zorunlu	Açıklama
`--app`	Evet	Uygulama ID (UUID)

adapty products create

Yeni bir ürün oluşturun.

Important

Mağaza ürünü ve fiyat kimlikleri oluşturulduktan sonra değiştirilemez. Farklı mağaza kimlikleri kullanmak için yeni bir ürün oluşturun.

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

Bayrak	Gerekli	Açıklama
`--app`	Evet	Uygulama ID’si (UUID)
`--title`	Evet	Ürün başlığı
`--access-level-id`	Evet	Bu ürünün erişim sağladığı access level ID’si (UUID)
`--period`	Evet	Abonelik dönemi: `weekly`, `monthly`, `two_months`, `trimonthly`, `semiannual`, `annual`, `lifetime`
`--ios-product-id`	En az bir mağaza gerekli	App Store Connect’teki ürün ID’si
`--android-product-id`	En az bir mağaza gerekli	Google Play Console’daki ürün ID’si
`--android-base-plan-id`	`--period lifetime` kullanılmadığı sürece `--android-product-id` ile birlikte gerekli	Google Play Console’daki temel plan ID’si
`--stripe-product-id`	En az bir mağaza gerekli	Stripe’taki ürün ID’si
`--stripe-price-id`	`--stripe-product-id` ile birlikte gerekli	Stripe’taki fiyat ID’si
`--paddle-product-id`	En az bir mağaza gerekli	Paddle’daki ürün ID’si
`--paddle-price-id`	`--paddle-product-id` ile birlikte gerekli	Paddle’daki fiyat ID’si

Her ürünün en az bir mağazaya ihtiyacı vardır: --ios-product-id, --android-product-id, --stripe-product-id veya --paddle-product-id. Tek bir ürün, aynı anda birden fazla mağaza için ID taşıyabilir.

Bir ürünü Stripe veya Paddle üzerinden web’de satmak için önce ödeme sağlayıcısını Adapty’ye bağlamanız gerekir: bkz. Stripe ve Paddle. Bu mağazaların her biri için ürün ID’sini ve fiyat ID’sini birlikte geçin. Yalnızca ikisinden birini geçerseniz komut başarısız olur.

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

Yalnızca web için geçerli bir ürün oluşturabilirsiniz: Stripe veya Paddle ID’leriyle, App Store ya da Google Play ID’leri olmadan bir ürün oluşturabilirsiniz.

adapty products update

Mevcut bir ürünü güncelleyin.

Mağaza ürün ve fiyat kimlikleri oluşturulduktan sonra değiştirilemez ve bu komutta mevcut değildir. Farklı mağaza kimlikleri kullanmak için yeni bir ürün oluşturun.

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

Argüman	Açıklama
`product-id`	Ürün kimliği (UUID)

Bayrak	Gerekli	Açıklama
`--app`	Evet	Uygulama ID’si (UUID)
`--title`	Hayır	Ürün başlığı
`--access-level-id`	Hayır	Bu ürünün kilidini açtığı Access level ID’si (UUID)

Ürün teklifleri

App Store Connect veya Google Play Console’da oluşturduğunuz teklifleri bir Adapty ürününe bağlayın; böylece Adapty bunları uygulayabilir. Her teklif türünün ne işe yaradığı ve teklifin mağazada nasıl oluşturulacağı hakkında bilgi için Adapty’ye teklif ekleme sayfasına bakın.

Şu teklifleri ekleyin:

App Store promosyon teklifleri ve geri kazanma teklifleri.
Tüm Google Play teklifleri (ücretsiz denemeler dahil). Google Play’de başlangıç teklifi türü yoktur; bu nedenle deneme süresi, temel bir plan üzerindeki bir teklif olarak yer alır ve yalnızca Adapty’de bağladıktan sonra geçerli olur.

App Store başlangıç tekliflerini eklemeyin: bunlar uygun kullanıcılara otomatik olarak uygulanır.

Bir flow veya paywall’da kullanıcıların teklifi görebilmesi için o ürüne bağlı teklifin seçilmesi gerekir. Bunu bir paywall’da seçmek için Adapty kontrol panelini kullanın: bkz. Teklifi görüntüle.

adapty products list ve adapty products get komutları, offers_count alanında her ürüne kaç teklifin bağlı olduğunu gösterir. Bu sayıya yalnızca Adapty’de bağlanan teklifler dahildir; mağazalarda mevcut olan teklifler dahil değildir.

adapty product-offers list

Bir ürüne bağlı tüm teklifleri listeler.

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

Flag	Gerekli	Açıklama
`--app`	Evet	Uygulama ID’si (UUID)
`--product`	Evet	Ürün ID’si (UUID)

Tüm teklifleri tek sayfada döndürür ve sayfalama bayraklarını desteklemez.

adapty product-offers get

Belirli bir teklife ait ayrıntıları getirir.

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

Argüman	Açıklama
`offer-id`	Teklif ID’si (UUID)

Bayrak	Zorunlu	Açıklama
`--app`	Evet	Uygulama ID’si (UUID)

adapty product-offers create

Bir ürüne mağaza teklifi bağlayın.

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

Bayrak	Gerekli	Açıklama
`--app`	Evet	Uygulama ID’si (UUID)
`--product`	Evet	Ürün ID’si (UUID)
`--title`	Evet	Yalnızca Adapty kontrol panelinde görünen teklif adı
`--type`	Evet	Teklif türü: `promotional` veya `win_back`
`--ios-offer-id`	En az bir mağaza gerekli	App Store Connect’teki teklif ID’si
`--android-offer-id`	En az bir mağaza gerekli	Google Play Console’daki teklif ID’si

Geri kazanma teklifleri yalnızca App Store’a özeldir, bu nedenle --type win_back yalnızca --ios-offer-id alır. Ücretsiz deneme dahil tüm Google Play teklifleri için --type promotional kullanın.

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

Mevcut bir teklifi günceller.

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

Argüman	Açıklama
`offer-id`	Teklif ID’si (UUID)

Bayrak	Zorunlu	Açıklama
`--app`	Evet	Uygulama ID’si (UUID)
`--title`	Hayır	Teklif adı
`--type`	Hayır	Teklif türü: `promotional` veya `win_back`. Bir teklifi `win_back` olarak değiştirmek için `--clear-android-offer-id` ile Google Play tarafını da kaldırın
`--ios-offer-id`	Hayır	Yeni App Store teklif ID’si
`--android-offer-id`	Hayır	Yeni Google Play teklif ID’si
`--clear-ios-offer-id`	Hayır	Teklifin App Store tarafını kaldırır
`--clear-android-offer-id`	Hayır	Teklifin Google Play tarafını kaldırır

--app dışında en az bir bayrak gereklidir. Belirtmediğiniz alanlar mevcut değerlerini korur. Her teklif en az bir mağaza teklif ID’si içermelidir; bu nedenle son ID’yi kaldıracak bir komut başarısız olur.

Warning

Komut, teklifi okuyup bütünüyle kaydeder. Bu okuma ile kaydetme arasında birisi teklifi Adapty Kontrol Paneli’nde düzenlerse, yaptığı değişiklik üzerine yazılır.

Başlangıç teklifleri güncellenemez. App Store veya Google Play dışında bir mağaza içeren teklifler de CLI üzerinden güncellenemez; bunları Adapty Kontrol Paneli’nden düzenleyin.

Bir teklifi silmek için Adapty Kontrol Paneli’ni kullanın. CLI’ın silme komutu yoktur.

Sıradaki adımlar

Komut referansı — her CLI konusu, genel bayraklar ve sayfalandırma bayrakları.