Flow eylemlerine yanıt verme - React Native

Adapty Flow Builder veya Paywall Builder kullanarak flow’lar veya paywall’lar oluşturuyorsanız, butonları doğru şekilde ayarlamanız çok önemlidir:

Flow/paywall builder’da bir buton ekleyin ve ona ya mevcut bir eylem atayın ya da özel bir eylem ID’si oluşturun.
Atadığınız her eylemi yönetmek için uygulamanızda kod yazın.

Bu rehber, özel ve mevcut eylemleri kodunuzda nasıl yöneteceğinizi gösterir.

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

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.

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

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.

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şleyicilerini 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, butonları doğru şekilde ayarlamanız çok önemlidir:

Paywall builder’da bir buton ekleyin ve ona ya mevcut bir eylem atayın ya da özel bir eylem ID’si oluşturun.
Atadığınız her eylemi yönetmek için uygulamanızda kod yazın.

Bu rehber, özel ve mevcut eylemleri kodunuzda nasıl yöneteceğinizi gösterir.

Yalnızca satın almalar, geri yüklemeler, paywall kapatma işlemleri ve URL açma otomatik olarak yönetilir. Diğer tüm buton eylemleri, uygulama kodunda uygun yanıt uygulamasını 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.

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

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.

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
        }
    },
});