Flow eylemlerine yanıt verme - React Native

Adapty Flow & Paywall Builder’da flow’lar oluşturuyorsanız, butonları doğru şekilde ayarlamak çok önemlidir:

Builder’da bir buton ekleyin ve ona önceden var olan bir eylem atayın ya da özel bir eylem ID’si oluşturun.
Atadığınız her eylemi işlemek için uygulamanıza kod yazın.

Bu kılavuz, kodunuzda özel ve önceden var olan eylemleri nasıl işleyeceğinizi gösterir.

Warning

Satın almalar, geri yüklemeler, flow/paywall kapanışları ve URL açma işlemleri otomatik olarak yönetilir. Varsayılan davranışlarını yapılandırabilir veya özel eylemler için yanıtlar uygulayabilirsiniz.

Note

SDK, push bildirimleri veya kamera erişimi gibi sistem izni istekleri için bir onRequestPermission flow işleyicisi sunar. Flow’lar bu istekleri henüz tetiklemez, bu yüzden şimdilik uygulamanıza gerek yoktur.

Flow’ları ve paywall’ları kapatma

Flow’unuzu veya paywall’ınızı kapatacak bir buton eklemek için:

Builder’da bir buton ekleyin ve ona Close eylemini atayın.
Uygulama kodunuzda, flow veya paywall’ı kapatan close eylemi için bir işleyici uygulayın.

Info

React Native SDK’da close eylemi varsayılan olarak flow veya paywall’ı kapatmayı tetikler. Ancak gerekirse bu davranışı kodunuzda geçersiz kılabilirsiniz. Örneğin, bir flow’u kapatmak başka birini açmayı tetikleyebilir.

React bileşeni için, kapatma eylemini tekil olay işleyici prop’ları aracılığıyla yönetin:


function MyPaywall({ flow }) {
  const onCloseButtonPress = useCallback<FlowEventHandlers['onCloseButtonPress']>(() => {
    // Handle close button press - navigate away or hide component
    navigation.goBack();
  }, [navigation]);

  return (
    <AdaptyFlowView
      flow={flow}
      style={styles.container}
      onCloseButtonPress={onCloseButtonPress}
    />
  );
}

Modal sunum için, kapatma işleyicisini uygulayın:


const view = await createFlowView(flow);

const unsubscribe = view.setEventHandlers({
    onCloseButtonPress() {
        return true; // allow flow or paywall closing
    }
});

Flow’lardan ve paywall’lardan URL açma

Tip

Bir grup bağlantı eklemek istiyorsanız (örneğin kullanım koşulları ve satın alma geri yükleme), builder’da bir Link öğesi ekleyin ve onu Open URL eylemine sahip butonlarla aynı şekilde yönetin.

Flow’unuzdan veya paywall’ınızdan bir bağlantı açan bir buton eklemek için (örneğin Kullanım koşulları veya Gizlilik politikası):

Builder’da bir buton ekleyin, ona Open URL eylemini atayın ve açmak istediğiniz URL’yi girin.
Uygulama kodunuzda, alınan URL’yi bir tarayıcıda açan openUrl eylemi için bir işleyici uygulayın.

Info

React Native SDK’da openUrl eylemi varsayılan olarak URL’yi açmayı tetikler. Ancak gerekirse bu davranışı kodunuzda geçersiz kılabilirsiniz.

React bileşeni için, URL açmayı olay işleyici prop’u aracılığıyla yönetin:


function MyPaywall({ flow }) {
  const onUrlPress = useCallback<FlowEventHandlers['onUrlPress']>((url) => {
    Linking.openURL(url);
  }, []);

  return (
    <AdaptyFlowView
      flow={flow}
      style={styles.container}
      onUrlPress={onUrlPress}
    />
  );
}

Modal sunum için, URL işleyicisini uygulayın:


const view = await createFlowView(flow);

const unsubscribe = view.setEventHandlers({
    onUrlPress(url) {
        Linking.openURL(url);
        return false; // Keep flow or paywall open
    },
});

Özel eylemleri yönetme

Diğer herhangi bir eylemi yöneten bir buton eklemek için:

Builder’da bir buton ekleyin, ona Custom eylemini atayın ve bir ID atayın.
Uygulama kodunuzda, oluşturduğunuz eylem ID’si için bir işleyici uygulayın.

Örneğin, başka bir abonelik teklifleri veya tek seferlik satın alma grubunuz varsa, başka bir flow veya paywall görüntüleyecek bir buton ekleyebilirsiniz:

React bileşeni için, özel eylemleri olay işleyici prop’u aracılığıyla yönetin:


function MyPaywall({ flow }) {
  const onCustomAction = useCallback<FlowEventHandlers['onCustomAction']>((actionId) => {
    if (actionId === 'openNewPaywall') {
      // Display another flow or paywall
    }
  }, []);

  return (
    <AdaptyFlowView
      flow={flow}
      style={styles.container}
      onCustomAction={onCustomAction}
    />
  );
}

Modal sunum için özel eylem işleyicileri uygulayın:

const unsubscribe = view.setEventHandlers({
    onCustomAction(actionId) {
        if (actionId === 'openNewPaywall') {
            // Display another flow or paywall
        }
    },
});

Adapty Paywall Builder kullanarak paywall’lar oluşturuyorsanız, düğmeleri doğru şekilde yapılandırmanız çok önemlidir:

Eski Paywall Builder’da bir düğme ekleyin ve ona önceden tanımlanmış bir eylem veya özel bir eylem ID’si atayın.
Atadığınız her eylemi işlemek için uygulamanıza kod yazın.

Bu kılavuz, kodunuzda özel ve önceden tanımlanmış eylemleri nasıl yöneteceğinizi gösterir.

Warning

Yalnızca satın almalar, geri yüklemeler, paywall kapatmalar ve URL açma işlemleri otomatik olarak yönetilir. Diğer tüm düğme eylemlerinin uygulama kodunda uygun yanıt uygulaması gerektirir.

Paywall’ları kapatma

Paywall’ınızı kapatacak bir buton eklemek için:

Paywall builder’da bir buton ekleyin ve ona Close eylemini atayın.
Uygulama kodunuzda, paywall’ı kapatan close eylemi için bir işleyici uygulayın.

Info

React Native SDK’da close eylemi varsayılan olarak paywall’ı kapatmayı tetikler. Ancak gerekirse bu davranışı kodunuzda geçersiz kılabilirsiniz. Örneğin, bir paywall’ı kapatmak başka birini açmayı tetikleyebilir.

React bileşeni için, kapatma eylemini tekil olay işleyici prop’ları aracılığıyla yönetin:


function MyPaywall({ paywall }) {
  const onCloseButtonPress = useCallback<EventHandlers['onCloseButtonPress']>(() => {
    // Handle close button press - navigate away or hide component
    navigation.goBack();
  }, [navigation]);

  return (
    <AdaptyPaywallView
      paywall={paywall}
      style={styles.container}
      onCloseButtonPress={onCloseButtonPress}
    />
  );
}

Modal sunum için, kapatma işleyicisini uygulayın:


const view = await createPaywallView(paywall);

const unsubscribe = view.setEventHandlers({
    onCloseButtonPress() {
        return true; // allow paywall closing
    }
});

Paywall’lardan URL açma

Tip

Bir grup bağlantı eklemek istiyorsanız (ör. kullanım koşulları ve satın alma geri yükleme), paywall builder’da bir Link öğesi ekleyin ve bunu Open URL aksiyonuna sahip butonlarla aynı şekilde yönetin.

Paywall’ınızdan bir bağlantı açacak bir buton eklemek için (ör. Kullanım Koşulları veya Gizlilik Politikası):

Paywall builder’da bir buton ekleyin, Open URL aksiyonunu atayın ve açmak istediğiniz URL’yi girin.
Uygulama kodunuzda, alınan URL’yi tarayıcıda açan openUrl aksiyonu için bir handler uygulayın.

Info

React Native SDK’da openUrl eylemi varsayılan olarak URL’yi açmayı tetikler. Ancak gerekirse bu davranışı kodunuzda geçersiz kılabilirsiniz.

React bileşeni için, URL açmayı olay işleyici prop’u aracılığıyla yönetin:


function MyPaywall({ paywall }) {
  const onUrlPress = useCallback<EventHandlers['onUrlPress']>((url) => {
    Linking.openURL(url);
  }, []);

  return (
    <AdaptyPaywallView
      paywall={paywall}
      style={styles.container}
      onUrlPress={onUrlPress}
    />
  );
}

Modal sunum için, URL işleyicisini uygulayın:


const view = await createPaywallView(paywall);

const unsubscribe = view.setEventHandlers({
    onUrlPress(url) {
        Linking.openURL(url);
        return false; // Keep paywall open
    },
});

Uygulamaya giriş yapma

Kullanıcıları uygulamanıza giriş yaptıran bir buton eklemek için:

Paywall builder’da bir buton ekleyin ve ona Login eylemini atayın.
Uygulama kodunuzda, kullanıcınızı tanımlayan login eylemi için bir işleyici uygulayın.

React bileşeni için, girişi olay işleyici prop’u aracılığıyla yönetin:


function MyPaywall({ paywall }) {
  const onCustomAction = useCallback<EventHandlers['onCustomAction']>((actionId) => {
    if (actionId === 'login') {
      navigation.navigate('Login');
    }
  }, [navigation]);

  return (
    <AdaptyPaywallView
      paywall={paywall}
      style={styles.container}
      onCustomAction={onCustomAction}
    />
  );
}

Modal sunum için, giriş işleyicisini uygulayın:


const view = await createPaywallView(paywall);

const unsubscribe = view.setEventHandlers({
    onCustomAction(actionId) {
        if (actionId === 'login') {
            navigation.navigate('Login');
        }
    }
});

Özel eylemleri yönetme

Diğer herhangi bir eylemi yöneten bir buton eklemek için:

Paywall builder’da bir buton ekleyin, ona Custom eylemini atayın ve bir ID atayın.
Uygulama kodunuzda, oluşturduğunuz eylem ID’si için bir işleyici uygulayın.

Örneğin, başka bir abonelik teklifleri veya tek seferlik satın alma grubunuz varsa, başka bir paywall görüntüleyecek bir buton ekleyebilirsiniz:

React bileşeni için, özel eylemleri olay işleyici prop’u aracılığıyla yönetin:


function MyPaywall({ paywall }) {
  const onCustomAction = useCallback<EventHandlers['onCustomAction']>((actionId) => {
    if (actionId === 'openNewPaywall') {
      // Display another paywall
    }
  }, []);

  return (
    <AdaptyPaywallView
      paywall={paywall}
      style={styles.container}
      onCustomAction={onCustomAction}
    />
  );
}

Modal sunum için, özel eylem işleyicilerini uygulayın:

const unsubscribe = view.setEventHandlers({
    onCustomAction(actionId) {
        if (actionId === 'openNewPaywall') {
            // Display another paywall
        }
    },
});