Flow ve paywall'ları göster - Unity

Flow ve paywall'ları göster
✦
Flow'lar Flow & Paywall Builder ile oluşturulur — cihazda natif olarak render edilir, WebView gerekmez
✦
Eski Paywall Builder paywall'ları Eski Paywall Builder ile oluşturulmuş tüm içerik

Bir flow veya eski Paywall Builder’da bir paywall oluşturduysanız, bunu kullanıcıya göstermek için mobil uygulama kodunuzda render etme konusunda endişelenmenize gerek yoktur. Bu tür bir flow veya paywall, içinde ne gösterileceğini ve nasıl gösterileceğini zaten içerir.

Warning

Bu kılavuz, Adapty tarafından render edilen flow’lar ve paywall’lar için geçerlidir. Özel paywall’lar ve Observer modu için süreç farklıdır.

Aşağıda kullanılan view nesnesini elde etmek için Flow ve paywall’ları alma sayfasına bakın.

Bir flow veya paywall görüntülemek için CreateFlowView metoduyla oluşturulan view üzerinde view.Present() metodunu kullanın. Varsayılan olarak, kapatılan bir view yok edilir. Flow’u tekrar görüntülemek için CreateFlowView’ı bir kez daha çağırarak yeni bir view örneği oluşturun ya da kapatırken view’ı koruyun.

Warning

Yok edilmiş bir view’ı yeniden kullanmak hataya yol açar.

view.Present((error) => {
    // handle the error
});
Tip

Adapty SDK’nın bir mobil uygulamaya nasıl entegre edildiğini gerçek dünyadan bir örnekle görmek ister misiniz? Paywall gösterme, satın alma yapma ve diğer temel işlevler dahil olmak üzere tam kurulumu sergileyen örnek uygulamalarımıza göz atın.

Görünümü tekrar sunmak için saklayın

Info

Saklanan görünümler SDK 4.3.0 sürümünden itibaren kullanılabilir.

view.Dismiss() görünümü bellekten kaldırır. Bunun yerine görünümü saklamak için destroy parametresine false değerini geçin:

view.Dismiss(false, (error) => {
    // handle the error
});

Bu görünümü tekrar sunduğunuzda kullanıcı, flow’un o ana kadar oluşturduğu durumuyla birlikte kaldığı ekrana döner. Görünüm Id’sini koruduğundan, olayları aynı view.Id ile dinleyicinize ulaşmaya devam eder.

Tuttuğunuz bir view, siz serbest bırakana kadar bellekte kalır. Artık ihtiyacınız olmadığında view.Destroy() çağrısını yapın:

view.Destroy((error) => {
    // handle the error
});

Destroy(), view hâlâ ekrandaysa önce onu kapatır. Oluşturup hiç göstermediğiniz bir view’ı ya da iOS’ta kullanıcının aşağı kaydırarak kapattığı sayfa sayfası (page-sheet) view’ını da serbest bırakır. Normal bir Dismiss() çağrısından sonra kullanmayın: o view zaten serbest bırakılmıştır ve çağrı başarısız olur.

Kullanıcı Close butonuna dokunduğunda görünümü açık tutmak için Close action handler’ınızda destroy: false ile kapatın. FlowViewDidPerformAction metodu uygulamanızdaki her flow ve paywall için çalıştığından, yalnızca yeniden göstermeyi planladığınız görünümü tutmak için view.Id değerini karşılaştırın. Görünümü oluştururken bir alana kaydedin; böylece sonradan karşılaştırabilir ve yeniden gösterebilirsiniz:

private AdaptyUIFlowView keptView;

void CreateKeptView(AdaptyFlow flow) {
    AdaptyUI.CreateFlowView(flow, new AdaptyUICreateFlowViewParameters(), (view, error) => {
        if (error != null) {
            // handle the error
            return;
        }
        keptView = view;
    });
}

public void FlowViewDidPerformAction(
    AdaptyUIFlowView view,
    AdaptyUIUserAction action
) {
    switch (action.Type) {
        case AdaptyUIUserActionType.Close:
            view.Dismiss(view.Id != keptView?.Id, null);
            break;
        default:
            // handle other events
            break;
    }
}

Sakladığınız view’ı elinizde tutun: flow veya paywall’ı yeniden göstermek ve Destroy() ile serbest bırakmak için buna ihtiyacınız olacak. keptView.Destroy() çağrısından sonra keptView’ı null olarak ayarlayın; böylece yukarıdaki karşılaştırma, serbest bırakılmış bir view ile eşleşmez. Diğer tüm view.Dismiss() çağrıları da view’ı serbest bırakır; buna FlowViewDidReceiveError içindeki çağrı da dahildir. Bir view hatası sonrasında CreateFlowView ile yeni bir view oluşturun.

Diyalog göster

Android’de bir flow veya paywall gösterilirken, yerel uyarı diyalogları yerine bu yöntemi kullanın. Android’de normal uyarılar flow görünümünün arkasında kalır ve kullanıcılar tarafından görülemez. Bu yöntem, tüm platformlarda diyaloğun flow’un üzerinde düzgün şekilde gösterilmesini sağlar.

var dialog = new AdaptyUIDialogConfiguration()
    .SetTitle("Close this screen?")
    .SetContent("You will lose access to exclusive offers.")
    .SetDefaultActionTitle("Stay")
    .SetSecondaryActionTitle("Close");

AdaptyUI.ShowDialog(view, dialog, (action, error) => {
    if (error == null) {
        if (action == AdaptyUIDialogActionType.Secondary) {
            // User confirmed - close the flow
            view.Dismiss((error) => {
                // handle the error
            });
        }
        // If primary - do nothing, user stays
    }
});

iOS sunum stilini yapılandırma

Present() metoduna iosPresentationStyle parametresini geçirerek flow veya paywallın iOS’ta nasıl sunulacağını yapılandırın. Parametre, AdaptyUIIOSPresentationStyle.FullScreen (varsayılan) veya AdaptyUIIOSPresentationStyle.PageSheet değerlerini kabul eder.

view.Present(AdaptyUIIOSPresentationStyle.PageSheet, (error) => {
    // handle the error
});

Kullanıcı, sayfa sayfasını kapatmak için aşağı kaydırabilir. Görünüm, Dismiss() çağrısı yapılmadan bellekte kalır: tekrar sunun ya da SDK 4.3.0 ve sonrasında Destroy() ile serbest bırakın.

Paywall Builder kullanarak bir paywall özelleştirdiyseniz, bunu kullanıcıya göstermek için mobil uygulama kodunuzda ayrıca render etmeniz gerekmez. Bu tür bir paywall, hem paywall içinde neyin gösterileceğini hem de nasıl gösterileceğini içerir.

Warning

Bu kılavuz, Adapty SDK 3.3.0 veya sonrasını gerektiren eski Paywall Builder’ı kapsamaktadır.

Özel paywallları sunmak için bkz. Özel paywallları sunma.

Bir paywall görüntülemek için, CreatePaywallView yöntemiyle oluşturulan view üzerinde view.Present() metodunu kullanın. Her view yalnızca bir kez kullanılabilir. Paywall’ı tekrar görüntülemeniz gerekirse, yeni bir view örneği oluşturmak için CreatePaywallView metodunu bir kez daha çağırın.

Warning

Aynı view’ı yeniden oluşturmadan tekrar kullanmak AdaptyUIError.viewAlreadyPresented hatasına yol açabilir.

view.Present((error) => {
  // handle the error
});
Tip

Adapty SDK’nın bir mobil uygulamaya nasıl entegre edildiğini gerçek dünyadan bir örnekle görmek ister misiniz? Paywall gösterme, satın alma yapma ve diğer temel işlevler dahil olmak üzere tam kurulumu sergileyen örnek uygulamalarımıza göz atın.

Diyalog gösterme

Android’de bir paywall görünümü sunulduğunda, yerel uyarı iletişim kutuları yerine bu metodu kullanın. Android’de normal uyarılar paywall görünümünün arkasında kalarak kullanıcılara görünmez hale gelir. Bu metod, tüm platformlarda iletişim kutusunun paywall’ın üzerinde düzgün şekilde gösterilmesini sağlar.

var dialog = new AdaptyUIDialogConfiguration()
    .SetTitle("Close paywall?")
    .SetContent("You will lose access to exclusive offers.")
    .SetDefaultActionTitle("Stay")
    .SetSecondaryActionTitle("Close");

AdaptyUI.ShowDialog(view, dialog, (action, error) => {
    if (error == null) {
        if (action == AdaptyUIDialogActionType.Secondary) {
            // User confirmed - close the paywall
            view.Dismiss();
        }
        // If primary - do nothing, user stays
    }
});

iOS sunum stilini yapılandırma

Present() metoduna iosPresentationStyle parametresini geçirerek paywallın iOS’ta nasıl sunulacağını yapılandırın. Parametre, AdaptyUIIOSPresentationStyle.FullScreen (varsayılan) veya AdaptyUIIOSPresentationStyle.PageSheet değerlerini kabul eder.

view.Present(AdaptyUIIOSPresentationStyle.PageSheet, (error) => {
    // handle the error
});