English 中文TürkçeРусскийFrançaisTiếng ViệtEspañol日本語

iOS SDK'da flow'lara veri aktarma

Özel etiket, uygulamanızdan gelen bir değere sahip özel bir değişkendir. Bir değişkenin ayarlarında Value comes from outside the app seçeneğini belirledikten sonra uygulamanız bu değeri Adapty SDK aracılığıyla ayarlayabilir. Örneğin, bir metin öğesi “Coins:” ve bir özel etiket içeriyorsa, uygulamanız bu etiket için “120” değerini aktardığında kullanıcılar “Coins: 120” şeklinde görür.

Başlamadan önce

Adapty SDK v4 veya daha yenisine ihtiyacınız var. v4’ten önceki sürümler flow’ları görüntülemez.

Flow’a özel etiketler ekle

Uygulamanızın değerlerini bir flow’da göstermek için builder’da özel etiketler oluşturun:

  1. Uygulamanızın ilettiği her değer için özel bir etiket oluşturun.

    Ad, açıklama, String değer türü ve başlangıç değeri içeren değişken oluşturma formu

  2. Her etiketi bir metin öğesine ekleyin.

  3. Her etiketin grubu dahil tam adını not edin. Uygulamanızın kodu her değeri bu ad altında iletir. Örneğin, user grubu içinde streak adlı bir etiket varsa, etiketin tam adı user.streak olur.

    Değişken ekle açılır menüsünün özel sekmesi; user grubundaki streak etiketi gösteriliyor

Özel etiket değerlerini aktarma

getFlowConfiguration metodunun tagResolver parametresine, uygulamanızın değerlerini [String: String] sözlüğü olarak aktarın:

  • Her anahtar, user.streak gibi özel bir etiketin tam adıdır.
  • Her değer, kullanıcıların etiket yerine gördüğü metindir.
  • Her değer, “1250.0” değil “1,250” gibi okunabilir bir formatta olmalıdır. Adapty bu değerleri biçimlendirmez veya çevirmez.
let customTags = [
    "username": "DragonSlayer42",
    "coins": "1,250",
]

do {
    let flowConfiguration = try await AdaptyUI.getFlowConfiguration(
        forFlow: flow,
        tagResolver: customTags
    )
    // present the flow
} catch {
    // handle the error
}

SwiftUI .flow modifier ve AdaptyFlowView ile UIKit flow controller, özel etiket değerleri için herhangi bir parametre almaz. Bu bileşenler, verdiğiniz flow yapılandırmasındaki değerleri gösterir.

Özel etiketlerinizi test etmek için, değerlerini ayarlayan kodu ekledikten sonra uygulamanızda flow’u açın. Builder canvas ve cihazlarda önizleme yalnızca Başlangıç değerlerini gösterir: Adapty mobil uygulaması özel etiket değerlerini ayarlamaz.

Uygulamanız eski Paywall Builder paywallları için zaten özel etiket değerleri ayarlıyorsa, flow’lardaki özel etiketlerin nasıl farklılaştığını inceleyin.

Kullanıcılar değer olmadığında ne görür

Kullanıcılar, aşağıdaki durumlarda özel etiketin Başlangıç değerini yedek olarak görür:

  • Uygulamanız etikete herhangi bir değer geçmez.
  • Kullanıcı, değeri geçen sürüme uygulamayı güncellememiştir.
  • Uygulama kodunuzdaki ad, büyük/küçük harf dahil etiketin tam adıyla eşleşmez.
  • Aynı metin öğesindeki başka bir özel etiketin değeri yoktur. Bu durumda o metin öğesindeki tüm özel etiketler Başlangıç değerini gösterir.

Etiketin yerine hiçbir şey göstermek için boş bir dize geçin. Adapty boş dizeyi bir değer olarak kabul eder; dolayısıyla yedek değer görünmez.

Örnek: onboarding yanıtlarından VKİ gösterme

Bir flow kullanıcılardan yanıtlar toplayabilir; özel bir tag ise uygulamanızdaki bir değeri gösterebilir. Kullanıcılara, uygulamanızın yanıtlarından hesapladığı bir skoru, önerilen bir planı veya bir sağlık metriğini göstermek için ikisini birleştirebilirsiniz:

  1. Bir flow yanıtları toplar ve uygulamanıza gönderir.
  2. Uygulamanız sonucu hesaplar.
  3. Uygulamanız sonucu bir sonraki flow’a özel tag değeri olarak iletir.

Bu örnekte bir onboarding flow’u kullanıcının kilosunu ve boyunu toplar. Kullanıcı onboarding flow’unu son ekranından kapattığında uygulamanız vücut kitle indeksini (VKİ) hesaplar. Ardından VKİ’yi gösteren bir paywall flow’u açar.

Flow’ları ayarlayın

  1. İki flow oluşturun: kullanıcının kilosunu ve boyunu toplayan bir onboarding flow’u ve BMI’sini gösteren bir paywall flow’u.

  2. Onboarding flow’una iki Number (Sayı) girişi ekleyin:

    • Kilogram cinsinden ağırlık için Element ID weight olan bir girişi.
    • Santimetre cinsinden boy için Element ID height olan bir girişi.

    Her iki girişin Format ayarını da Integer olarak belirleyin. Bir girişi, kullanıcının yazdığı gibi değerini metin olarak gönderir; örnek kod “70.5” ile “70,5” değerlerini aynı şekilde okumaz. Tam sayılarda ondalık ayraç olmadığından kod, bunları her yerel ayarda aynı şekilde okur.

  3. Uygulamanızın her iki değeri de aldığından emin olmak için onboarding flow’unu hiç girişi olmayan bir ekranla bitirin. O ekrana Close flow eylemi olan bir düğme ekleyin. Girişler, odağı kaybettiklerinde veya kullanıcı başka bir ekrana geçtiğinde değerlerini gönderir. Close flow eylemi bunları göndermez. Örnek kod, yalnızca kullanıcı son ekrana ulaştıysa paywall’ı açar.

  4. Paywall flow’unda bmi adında bir özel etiket oluşturun. Initial value alanına bir tire (—) girin. Uygulamanız BMI değeri iletmezse kullanıcılar bu tireyi görür.

  5. Paywall flow’una “Your BMI:” yazan bir metin öğesi ekleyin. Bu kelimelerin ardından bmi özel etiketini ekleyin.

  6. Onboarding flow’unu onboarding gibi bir placement’a ekleyin. Paywall flow’unu ise bmi_paywall ID’sine sahip bir placement’a ekleyin. Pass the BMI to the paywall bölümündeki kod, paywall’ı bu ID ile çeker.

BMI’yi paywall’a aktarın

Onboarding flow’unun flow_user_input etkinliklerinden ağırlık ve boy bilgilerini toplayın; bunun nasıl yapıldığını Flow’lardan veri işleme bölümünde bulabilirsiniz. Kullanıcının son ekrana ulaştığını anlamak için is_last_screen değeri true olan bir flow_screen_showed etkinliğini izleyin; bkz. Flow ekran görüntülemelerini takip etme. Kullanıcı o ekranın ardından onboarding flow’unu kapattığında BMI’yi hesaplayın. Ardından paywall’ın flow yapılandırmasını çekin ve bmi özel etiketi için BMI değerini aktarın.

Aşağıdaki kod UIKit içindir. AdaptyFlowControllerDelegate metodlarını tek bir view controller üzerinde uygular; bu view controller, hem onboarding flow’unun controller’ının hem de paywall controller’ının delegate’idir. View controller aynı zamanda delegate’in satın alma ve geri yükleme metodlarını da uygulamalıdır; bu örnek onları dışarıda bırakmıştır. Bunları görmek için UIKit’te flow ve paywall sunma sayfasına gidin.

private var bodyAnswers: [String: String] = [:]
private var reachedLastScreen = false

func flowController(
    _ controller: AdaptyFlowController,
    didReceiveAnalyticEvent name: String,
    params: [String: any Sendable]
) {
    if name == "flow_screen_showed", params["is_last_screen"] as? Bool == true {
        reachedLastScreen = true
        return
    }
    guard name == "flow_user_input",
          let elementId = params["element_id"] as? String,
          let value = params["value"] as? String
    else { return }

    bodyAnswers[elementId] = value
}

func flowControllerDidDisappear(_ controller: AdaptyFlowController) {
    // This delegate receives events from both flows. Reset `bodyAnswers` and
    // `reachedLastScreen` whenever a flow disappears, so that the paywall
    // doesn't open again when the user closes it.
    let answers = bodyAnswers
    let finished = reachedLastScreen
    bodyAnswers.removeAll()
    reachedLastScreen = false

    // Number inputs send their values as strings.
    guard finished,
          let weight = answers["weight"].flatMap({ Double($0) }),
          let height = answers["height"].flatMap({ Double($0) }),
          height > 0
    else { return }

    let heightInMeters = height / 100
    let bmi = weight / (heightInMeters * heightInMeters)

    Task {
        await showBMIPaywall(bmi: bmi.formatted(.number.precision(.fractionLength(1))))
    }
}

func showBMIPaywall(bmi: String) async {
    do {
        let flow = try await Adapty.getFlow(placementId: "bmi_paywall")
        let flowConfiguration = try await AdaptyUI.getFlowConfiguration(
            forFlow: flow,
            tagResolver: ["bmi": bmi]
        )
        let flowController = try AdaptyUI.flowController(
            with: flowConfiguration,
            delegate: self
        )
        present(flowController, animated: true)
    } catch {
        // handle the error
    }
}

formatted, kullanıcının yerel ayarına göre ondalık ayırıcı kullanır: İngilizce’de “22.7”, Almanca’da “22,7”.

SwiftUI’da, delegate metotları yerine onboarding flow’unun .flow modifier’ının closure’larını kullanın:

  • didReceiveAnalyticEvent: Ağırlığı ve boyu toplayın ve son ekranın flow_screen_showed eventini izleyin.
  • didDisappear: Kullanıcı son ekrana ulaştıysa BMI’yı hesaplayın. Ardından paywall’ın flow yapılandırmasını çekin ve bmi custom tag’i için BMI değerini geçirin. Bu yapılandırmayı ikinci bir .flow modifier ile gösterin.

BMI’ı kullanıcı profiline kaydedin

Kullanıcılara BMI’larına göre farklı flow’lar göstermek için bunu profillerinin bir özel özelliği olarak kaydedin. Adapty Kontrol Paneli’nde bmi anahtarıyla bir Number özel özelliği oluşturun. Ardından her flow’u bu özellikten oluşturulan bir kitle için gösterin.

updateProfile metodunu flowControllerDidDisappear içinde, bmi’ı hesaplayan satırın hemen ardından çağırın. Bir segment’in BMI’ı bir eşik değeriyle karşılaştırabilmesi için biçimlendirilmiş string yerine Double değeri iletin:

do {
    let params = try AdaptyProfileParameters.Builder()
        .with(customAttribute: bmi, forKey: "bmi")
        .build()
    try await Adapty.updateProfile(params: params)
} catch {
    // handle the error
}