Paywall Builder'da özel etiketler

Özel etiketler, farklı senaryolar için ayrı paywalllar oluşturmanıza gerek kalmamasını sağlar. Kullanıcı verilerine göre dinamik olarak uyarlanan tek bir paywall hayal edin. Örneğin, genel bir “Merhaba!” yerine kullanıcıları kişisel olarak “Merhaba, John!” veya “Merhaba, Ann!” şeklinde selamlayabilirsiniz.

Özel etiketleri kullanabileceğiniz bazı senaryolar şunlardır:

Paywall’da kullanıcının adını veya e-postasını göstermek.
Satışları artırmak için haftanın günü göstermek (örneğin, “İyi Perşembeler”).
Sattığınız ürünlerle ilgili kişiselleştirilmiş bilgiler eklemek (bir fitness programının adı veya bir VoIP uygulamasındaki telefon numarası gibi).

Özel etiketler, çeşitli durumlara uyum sağlayan esnek bir paywall oluşturmanıza yardımcı olarak uygulamanızın arayüzünü daha kişisel ve ilgi çekici hale getirir.

Her özel etiket içeren satır için yedek metin eklemeyi unutmayın.

Bazı durumlarda uygulamanız bir özel etiketi neyle değiştireceğini bilemeyebilir; özellikle kullanıcılar AdaptyUI SDK’nın eski bir sürümünü kullanıyorsa bu durum ortaya çıkabilir. Bunu önlemek için, bilinmeyen özel etiketler içeren satırların yerine geçecek bir yedek metin ekleyin. Aksi takdirde kullanıcılar etiketlerin kod olarak görüntülendiğini görebilir (<USERNAME/>).

Paywall’a özel etiket nasıl eklenir

Paywall Builder’daki herhangi bir metin satırına bir veya birden fazla özel etiket ekleyebilirsiniz.

Özel etiket eklemek için:

Özel etiketi <CUSTOM_TAG/> biçiminde girin ya da metin satırına bir açılış açısı ayracı (<) yazın. Sistem, etiketi doğru biçimde otomatik olarak önerecektir.

Aklınızda bulundurmanız gereken birkaç nokta:
- Adapty Paywall Builder’da özel etiketler açılı parantezlerle sarılır (<CUSTOM_TAG/>), ancak uygulamanızın kodunda doğrudan (CUSTOM_TAG) şeklinde belirtilmelidir.
- Özel etiketler büyük/küçük harf duyarlıdır.
- Özel etiketler, Adapty’de ürün bilgileri için ayrılmış Etiket Değişkenleri ile çakışamaz.

Özel etiketi ekledikten sonra mutlaka bir yedek satır girin. Bu yedek metin, uygulamanız belirli bir özel etiketi tanımadığında görünecek ve kullanıcıların etiketi kod olarak görmesinin önüne geçecektir. Yedek metin, özel etiketi içeren satırın tamamının yerini alır.

Mobil uygulamanızda özel etiketler nasıl kullanılır

Mobil uygulamanızda özel etiketleri kullanmak için bir tagResolver nesnesi oluşturun; bu, özel etiketleri paywall oluşturulurken onların yerine geçecek string değerleriyle eşleştiren bir sözlük ya da map’tir. İşte bir örnek:

let tagResolver = [
    "USERNAME": "John",
] 
  
let paywallConfiguration = try await AdaptyUI.getPaywallConfiguration(
    forPaywall: paywall,
    tagResolver: tagResolver // or any other AdaptyTagResolver protocol implementation
)

val customTags = mapOf("USERNAME" to "John")
val tagResolver = AdaptyUiTagResolver { tag -> customTags[tag] }

Map<String, String> customTags = new HashMap<>();
customTags.put("USERNAME", "John");
AdaptyUiTagResolver tagResolver = customTags::get;

val customTags = mapOf(
    "USERNAME" to "John",
    "CUSTOM_TAG_NAME" to "Walter White",
    "CUSTOM_TAG_PHONE" to "+1 234 567890"
)

val view = AdaptyUI.createPaywallView(
    paywall = paywall,
    customTags = customTags
)

final customTags = {
  'USERNAME': 'John',
};

try {
final view = await AdaptyUI().createPaywallView(
    paywall: paywall,
    customTags: customTags,
);
} on AdaptyError catch (e) {
  // handle the error
} catch (e) {
  // handle the error
}

var parameters = new AdaptyUICreateViewParameters()
  .SetCustomTags(
    new Dictionary<string, string> {
      { "CUSTOM_TAG_NAME", "John Appleseed" }
    }
  )

AdaptyUI.CreateView(paywall, parameters, (view, error) => {
  // handle the result
});

let customTags: Record<string, string> = { "USERNAME": "John" }
//and then you can pass it to createPaywallView as follows:
view = await createPaywallView(paywall, { customTags })

Bu örnekte USERNAME, Adapty kontrol panelinde <USERNAME/> olarak girdiğiniz özel bir etikettir. tagResolver, uygulamanızın bu özel etiketi dinamik olarak belirtilen değerle (örneğin John) değiştirmesini sağlar.

tagResolver’ı oluşturup doldurmayı, paywall’ınızı göstermeden hemen önce yapmanızı öneririz. Hazır olduğunda, paywall’ı göstermek için kullandığınız AdaptyUI metoduna aktarın. Paywall gösterimi hakkında daha fazla bilgiyi iOS, Android, React Native, Flutter veya Unity sayfalarında bulabilirsiniz.