Paywall Builder'da ürün bilgisi için etiket değişkenleri
Adapty’nin Paywall Builder’ı, ürünleriniz ve teklifleriniz için tüm metinleri özelleştirmenize olanak tanır. Birden fazla dili destekliyorsanız değişken kullanmanızı kesinlikle öneririz.
Nasıl çalışır
Ürün metinlerinize listemizden etiket değişkenleri eklediğinizde, SDK’mız etiketlerin yerine geçmek üzere uygulama mağazalarından önceden çekilmiş yerelleştirilmiş verileri kullanır. Bu sayede paywallınızdaki metin her zaman doğru dil ve bölgeye tam uyum sağlar.
Örnek: Diyelim ki hem ABD’de hem de İspanya’da kullanılabilen “Premium Abonelik” adlı bir ürününüz var. ABD’de “Premium Subscription for $4.99/month” olarak görünürken, İspanya’da “Suscripción Premium por €4.99/mes” şeklinde gösterilecektir.
Etiket değişkenleri, bu metinleri doğrudan mağazadan gelen verilere dayanarak otomatik olarak yerelleştirmenizi sağlar; böylece başlıklar ve fiyatlar her zaman doğru olur.
Bu bölüm, iOS, Android ve React Native SDK’larının 3.0 veya üzeri sürümleriyle ve Flutter ile Unity SDK’larının 3.3.0 veya üzeri sürümleriyle çalışan yeni Paywall Builder’ı açıklamaktadır. Adapty SDK v2.x veya önceki sürümlerle uyumlu eski Paywall Builder hakkında bilgi almak için bkz. Eski Paywall Builder etiket değişkenleri.
Etiket değişkenleri nasıl kullanılır
Etiket değişkenlerini yalnızca Paywall Builder’daki Product bileşeninde ürünleri ve teklifleri tanımlarken kullanabilirsiniz.
- Paywall Builder’ın sol panelinde özelleştirmek istediğiniz ürünü seçin.
- Ürünü ve tekliflerini tanımlamak için herhangi bir metin alanında aşağıdaki tablodaki değişkenleri kullanın.
- Her şeyin beklendiği gibi görüntülendiğinden emin olmak için ekranın sağ tarafındaki önizlemeyi kontrol edin.
Önizleme, değişkenlerinizin yerine gerçek değerleri kullanmaz; bunlar yalnızca SDK’mız tarafından cihazda alınır. Ancak şablon verilerini gerçek sonuçla aynı biçimde gösterir. Bu davranışı devre dışı bırakmak için önizlemenin sağ alt köşesindeki göz simgesine tıklayıp Tags preview values geçişini kapatabilirsiniz. Önizleme bundan sonra değişkenlerin gerçek değerlerini gösterir:
Değişkenlerin tam listesi
| Etiket değişkeni | Açıklama | Örnek |
|---|---|---|
<PROD_TITLE/> | Ürünün yerelleştirilmiş başlığı | Premium Subscription |
<PROD_PRICE/> | Ürünün yerelleştirilmiş fiyatı. Abonelikler için bu, bir fatura dönemi için geçerli fiyattır. | $9.99 |
<PROD_PRICE_PER_DAY/> | Abonelik fiyatının fatura dönemindeki gün sayısına bölünmüş hali. Abonelik olmayan ürünler için boş dize döndürür. | $0.33 |
<PROD_PRICE_PER_WEEK/> | Abonelik fiyatının fatura dönemindeki hafta sayısına bölünmüş hali. Abonelik olmayan ürünler için boş dize döndürür. | $2.33 |
<PROD_PRICE_PER_MONTH/> | Abonelik fiyatının fatura dönemindeki ay sayısına bölünmüş hali. Fatura dönemi bir aydan kısaysa tam bir ayı temsil edecek şekilde düzeltilir. Abonelik olmayan ürünler için boş dize döndürür. | $9.99 |
<PROD_PRICE_PER_YEAR/> | Abonelik fiyatının tam bir yıllık kullanımı temsil edecek şekilde düzenlenmiş hali. Örneğin, aylık abonelik fiyatı 12 ile çarpılırken yıllık fiyat aynı kalır. Abonelik olmayan ürünler için boş dize döndürür. | $119.88 |
<OFFER_PRICE/> | Bir teklifin (başlangıç veya promosyon) yerelleştirilmiş fiyatı. Yalnızca otomatik yenilenen abonelikler için geçerlidir; kullanıcı herhangi bir teklife uygun değilse boş dize döndürür. | $0.99 |
<OFFER_BILLING_PERIOD/> | Bir teklifin (başlangıç veya promosyon) yerelleştirilmiş fatura dönemi. Deneme ve peşin ödeme teklifleri için <OFFER_FULL_DURATION/> ile aynıdır. Yalnızca otomatik yenilenen abonelikler için geçerlidir; kullanıcı uygun değilse boş dize döndürür. | 1 week |
<OFFER_FULL_DURATION/> | Bir teklifin (başlangıç veya promosyon) yerelleştirilmiş toplam süresi. Yalnızca otomatik yenilenen abonelikler için geçerlidir; kullanıcı herhangi bir teklife uygun değilse boş dize döndürür. | 1 month |
Farklı teklif türleri için teklif etiketleri
Teklifler ve bunları Adapty’de nasıl yapılandıracağınız hakkında daha fazla bilgi edinmek için buraya bakabilirsiniz.
Teklif etiketlerini anlamak biraz karmaşık olabilir, bu yüzden bir örnekle açıklayalım. Diyelim ki üç farklı teklif seçeneği olan, haftalık $5 fiyatlı “Premium Abonelik” adlı bir aboneliğiniz var:
- Pay As You Go. İlk 3 hafta $3 (haftalık faturalandırılır), ardından $5/hafta.
- Pay Up Front. İlk 3 hafta $8 (hemen faturalandırılır), ardından $5/hafta.
- Free Trial. İlk hafta ücretsiz, ardından $5/hafta.
Bu ürün için <PROD_TITLE/> “Premium Abonelik”, <PROD_PRICE/> ise $5 olur. Ancak teklif etiketlerinin değerleri, kullanıcının uygun olduğu teklife göre şöyle değişir:
| Etiket değişkeni | Pay As You Go | Pay Upfront | Free Trial |
|---|---|---|---|
<OFFER_PRICE/> | $3 | $8 | $0 |
<OFFER_BILLING_PERIOD/> | 1 week | 3 weeks | 1 week |
<OFFER_FULL_DURATION/> | 3 weeks | 3 weeks | 1 week |
Yani “Pay As You Go” dışındaki teklif türlerinde <OFFER_BILLING_PERIOD/> ve <OFFER_FULL_DURATION/> aynı değeri alır.