Flow ve paywall olaylarını yönetme - React Native

Bu rehber; satın almalar, geri yüklemeler, ürün seçimi ve flow render işlemleri için olay yönetimini kapsar. Ayrıca buton yönetimini de (flow’u kapatma, bağlantı açma, özel eylemler vb.) ayarlayabilirsiniz. Ayrıntılar için buton eylemlerini yönetme rehberimize bakın.

Flow Builder ile oluşturulan flow’lar ve paywall’lar, satın alma yapmak ve geri yüklemek için ekstra koda ihtiyaç duymaz. Ancak uygulamanızın yanıt verebileceği bazı olaylar üretirler. Bu olaylar; buton tıklamalarını (kapatma butonları, URL’ler, ürün seçimleri vb.) ve flow üzerinde gerçekleştirilen satın almayla ilgili eylemlere ait bildirimleri içerir. Bu olaylara nasıl yanıt vereceğinizi aşağıda öğrenin.

Mobil uygulamanızda flow ekranında gerçekleşen süreçleri kontrol etmek veya izlemek için olay işleyicilerini uygulayın:

React bileşeni için olayları, AdaptyFlowView bileşenindeki tekil olay işleyici prop’ları aracılığıyla yönetirsiniz:


function MyFlow({ flow }) {
  const onCloseButtonPress = useCallback<FlowEventHandlers['onCloseButtonPress']>(() => {}, []);
  const onProductSelected = useCallback<FlowEventHandlers['onProductSelected']>((productId) => {}, []);
  const onPurchaseStarted = useCallback<FlowEventHandlers['onPurchaseStarted']>((product) => {}, []);
  const onPurchaseCompleted = useCallback<FlowEventHandlers['onPurchaseCompleted']>((purchaseResult, product) => {}, []);
  const onPurchaseFailed = useCallback<FlowEventHandlers['onPurchaseFailed']>((error, product) => {}, []);
  const onRestoreStarted = useCallback<FlowEventHandlers['onRestoreStarted']>(() => {}, []);
  const onRestoreCompleted = useCallback<FlowEventHandlers['onRestoreCompleted']>((profile) => {}, []);
  const onRestoreFailed = useCallback<FlowEventHandlers['onRestoreFailed']>((error) => {}, []);
  const onAppeared = useCallback<FlowEventHandlers['onAppeared']>(() => {}, []);
  const onError = useCallback<FlowEventHandlers['onError']>((error) => {}, []);
  const onLoadingProductsFailed = useCallback<FlowEventHandlers['onLoadingProductsFailed']>((error) => {}, []);
  const onUrlPress = useCallback<FlowEventHandlers['onUrlPress']>((url, openIn) => {
    adapty.openWebUrl(url, openIn);
    return false;
  }, []);
  const onCustomAction = useCallback<FlowEventHandlers['onCustomAction']>((actionId) => {}, []);
  const onWebPaymentNavigationFinished = useCallback<FlowEventHandlers['onWebPaymentNavigationFinished']>(() => {}, []);

  return (
    <AdaptyFlowView
      flow={flow}
      style={styles.container}
      onCloseButtonPress={onCloseButtonPress}
      onProductSelected={onProductSelected}
      onPurchaseStarted={onPurchaseStarted}
      onPurchaseCompleted={onPurchaseCompleted}
      onPurchaseFailed={onPurchaseFailed}
      onRestoreStarted={onRestoreStarted}
      onRestoreCompleted={onRestoreCompleted}
      onRestoreFailed={onRestoreFailed}
      onAppeared={onAppeared}
      onError={onError}
      onLoadingProductsFailed={onLoadingProductsFailed}
      onUrlPress={onUrlPress}
      onCustomAction={onCustomAction}
      onWebPaymentNavigationFinished={onWebPaymentNavigationFinished}
    />
  );
}

Modal sunum için olay işleyicileri metodunu uygulayın.

setEventHandlers’ı birden fazla kez çağırmak, sağladığınız işleyicileri geçersiz kılar; bu işlemler hem varsayılan hem de daha önce ayarlanmış işleyicilerin yerini alır.


const view = await createFlowView(flow);

const unsubscribe = view.setEventHandlers({
  onCloseButtonPress() {
    return true;
  },
  onAndroidSystemBack() {
    return true;
  },
  onPurchaseCompleted(purchaseResult, product) {
    return purchaseResult.type !== 'user_cancelled';
  },
  onPurchaseStarted(product) { /***/},
  onPurchaseFailed(error, product) { /***/ },
  onRestoreCompleted(profile) { /***/ },
  onRestoreFailed(error) { /***/ },
  onProductSelected(productId) { /***/},
  onError(error) { /***/ },
  onLoadingProductsFailed(error) { /***/ },
  onUrlPress(url, openIn) {
      adapty.openWebUrl(url, openIn);
      return false; // Keep flow open
  },
  onAppeared() { /***/ },
  onDisappeared() { /***/ },
  onWebPaymentNavigationFinished() { /***/ },
});

Olay örnekleri (Genişletmek için tıklayın)

// onCloseButtonPress
{
  //Record the event
}

// onAndroidSystemBack
{
  //Record the event
}

// onUrlPress
{
  "url": "https://example.com/terms"
}

// onCustomAction
{
  "actionId": "login"
}

// onProductSelected
{
  "productId": "premium_monthly"
}

// onPurchaseStarted
{
  "product": {
    "vendorProductId": "premium_monthly",
    "localizedTitle": "Premium Monthly",
    "localizedDescription": "Premium subscription for 1 month",
    "price": {
      "amount": 9.99,
      "currencyCode": "USD",
      "currencySymbol": "$",
      "localizedString": "$9.99"
    }
  }
}

// onPurchaseCompleted - Success
{
  "purchaseResult": {
    "type": "success",
    "profile": {
      "accessLevels": {
        "premium": {
          "id": "premium",
          "isActive": true,
          "expiresAt": "2024-02-15T10:30:00Z"
        }
      }
    }
  },
  "product": {
    "vendorProductId": "premium_monthly",
    "localizedTitle": "Premium Monthly",
    "localizedDescription": "Premium subscription for 1 month",
    "price": {
      "amount": 9.99,
      "currencyCode": "USD",
      "currencySymbol": "$",
      "localizedString": "$9.99"
    }
  }
}

// onPurchaseCompleted - Cancelled
{
  "purchaseResult": {
    "type": "user_cancelled"
  },
  "product": {
    "vendorProductId": "premium_monthly",
    "localizedTitle": "Premium Monthly",
    "localizedDescription": "Premium subscription for 1 month",
    "price": {
      "amount": 9.99,
      "currencyCode": "USD",
      "currencySymbol": "$",
      "localizedString": "$9.99"
    }
  }
}

// onPurchaseFailed
{
  "error": {
    "code": "purchase_failed",
    "message": "Purchase failed due to insufficient funds",
    "details": {
      "underlyingError": "Insufficient funds in account"
    }
  },
  "product": {
    "vendorProductId": "premium_monthly",
    "localizedTitle": "Premium Monthly",
    "localizedDescription": "Premium subscription for 1 month",
    "price": {
      "amount": 9.99,
      "currencyCode": "USD",
      "currencySymbol": "$",
      "localizedString": "$9.99"
    }
  }
}

// onRestoreCompleted
{
  "profile": {
    "accessLevels": {
      "premium": {
        "id": "premium",
        "isActive": true,
        "expiresAt": "2024-02-15T10:30:00Z"
      }
    },
    "subscriptions": [
      {
        "vendorProductId": "premium_monthly",
        "isActive": true,
        "expiresAt": "2024-02-15T10:30:00Z"
      }
    ]
  }
}

// onRestoreFailed
{
  "error": {
    "code": "restore_failed",
    "message": "Purchase restoration failed",
    "details": {
      "underlyingError": "No previous purchases found"
    }
  }
}

// onError
{
  "error": {
    "code": "rendering_failed",
    "message": "Failed to render flow interface",
    "details": {
      "underlyingError": "Invalid flow configuration"
    }
  }
}

// onLoadingProductsFailed
{
  "error": {
    "code": "products_loading_failed",
    "message": "Failed to load products from the server",
    "details": {
      "underlyingError": "Network timeout"
    }
  }
}

// onAppeared
{
  //Record the event
}

// onDisappeared
{
  //Record the event
}

// onWebPaymentNavigationFinished
{
  //Record the event
}

İhtiyacınız olan olay işleyicilerini kaydedebilir, ihtiyacınız olmayanları atlayabilirsiniz. Bu durumda, kullanılmayan olay dinleyicileri oluşturulmaz. Zorunlu olay işleyicisi yoktur.

Olay işleyicileri bir boolean döndürür. true döndürülürse, görüntüleme süreci tamamlanmış sayılır; böylece flow ekranı kapanır ve bu view için olay dinleyicileri kaldırılır.

Bazı olay işleyicilerinin, gerekirse geçersiz kılabileceğiniz bir varsayılan davranışı vardır:

onCloseButtonPress: kapatma butonuna basıldığında flow’u kapatır.
onUrlPress: tıklanan URL’yi açar ve flow’u açık tutar.
onAndroidSystemBack (yalnızca modal sunum için): Back butonuna basıldığında flow’u açık tutar. Kapatmak için true döndürün.
onRestoreCompleted: başarılı bir geri yüklemeden sonra flow’u açık tutar. Kapatmak için true döndürün.
onPurchaseCompleted: bir satın alma tamamlandıktan sonra flow’u açık tutar. Kapatmak için true döndürün.
onError: render başarısız olursa flow’u kapatır.

Olay işleyicileri

Olay işleyici	Açıklama
onCustomAction	Bir kullanıcı özel bir eylem gerçekleştirdiğinde, örneğin bir özel butona tıkladığında çağrılır.
onUrlPress	Bir kullanıcı flow’unuzdaki bir URL’ye tıkladığında çağrılır.
onAndroidSystemBack	Yalnızca modal sunum: Bir kullanıcı Android sistem Back butonuna dokunduğunda çağrılır.
onCloseButtonPress	Kapatma butonu görünürken bir kullanıcı ona dokunduğunda çağrılır. Bu işleyicide flow ekranını kapatmanız önerilir.
onPurchaseCompleted	Satın alma tamamlandığında çağrılır; ister başarılı, ister kullanıcı tarafından iptal edilmiş, ister onay bekliyor olsun. Başarılı bir satın alma durumunda güncellenmiş bir `AdaptyProfile` sağlar. Kullanıcı iptalleri ve bekleyen ödemeler (örneğin ebeveyn onayı gerektiğinde), `onPurchaseFailed` değil, bu olayı tetikler.
onPurchaseStarted	Bir kullanıcı satın alma sürecini başlatmak için “Purchase” eylem butonuna dokunduğunda çağrılır.
onPurchaseFailed	Bir satın alma hatalar nedeniyle başarısız olduğunda çağrılır (örneğin ödeme kısıtlamaları, geçersiz ürünler, ağ hataları, işlem doğrulama hataları). Bunun yerine `onPurchaseCompleted`’ı tetikleyen kullanıcı iptalleri veya bekleyen ödemeler için çağrılmaz.
onRestoreStarted	Bir kullanıcı satın alma geri yükleme sürecini başlattığında çağrılır.
onRestoreCompleted	Satın alma geri yükleme başarılı olduğunda çağrılır ve güncellenmiş bir `AdaptyProfile` sağlar. Kullanıcı gerekli `accessLevel`’a sahipse ekranı kapatmanız önerilir. Nasıl kontrol edileceğini öğrenmek için Abonelik durumu konusuna bakın.
onRestoreFailed	Geri yükleme süreci başarısız olduğunda çağrılır ve `AdaptyError` sağlar.
onProductSelected	Flow view’indeki herhangi bir ürün seçildiğinde çağrılır; böylece kullanıcının satın almadan önce ne seçtiğini izleyebilirsiniz.
onError	View render’ı sırasında bir hata oluştuğunda çağrılır ve `AdaptyError` sağlar. Bu tür hatalar oluşmamalıdır; bir tanesiyle karşılaşırsanız lütfen bize bildirin.
onLoadingProductsFailed	Ürün yükleme başarısız olduğunda çağrılır ve `AdaptyError` sağlar. View oluştururken `prefetchProducts: true` ayarlamadıysanız, AdaptyUI gerekli nesneleri sunucudan kendisi getirir.
onAppeared	Flow kullanıcıya görüntülendiğinde çağrılır. iOS’ta ayrıca, bir kullanıcı bir flow içindeki web paywall butonuna dokunduğunda ve uygulama içi tarayıcıda bir web paywall açıldığında çağrılır.
onDisappeared	Yalnızca modal sunum: Flow kullanıcı tarafından kapatıldığında çağrılır. iOS’ta ayrıca, bir flow’dan uygulama içi tarayıcıda açılan bir web paywall ekrandan kaybolduğunda çağrılır.
onWebPaymentNavigationFinished	Satın alma için bir web paywall açma girişiminden sonra çağrılır; ister başarılı ister başarısız olsun.
onAnalytics	Bir flow’dan gelen özel analiz olayları için ayrılmıştır. Flow’lar bunları henüz kodunuza yaymaz, bu yüzden uygulamanıza gerek yoktur.
onRequestAppReview	Bir flow’dan gelen uygulama değerlendirme istekleri için ayrılmıştır. Flow’lar henüz uygulama değerlendirme isteği tetiklemez, bu yüzden uygulamanıza gerek yoktur.
onRequestPermission	Bir flow’dan gelen sistem izni istekleri (push bildirimleri veya kamera erişimi gibi) için ayrılmıştır. Flow’lar henüz izin isteği tetiklemez, bu yüzden uygulamanıza gerek yoktur.
onObserverPurchaseInitiated	Yalnızca gözlemci modu: Bir kullanıcı bir flow’da satın alma butonuna dokunduğunda çağrılır. Adapty satın almayı yapmaz — onu kendi satın alma kodunuzla gerçekleştirin, ardından işlemi Adapty’ye bildirin. Aşağıdaki Gözlemci modunda satın almaları yönetme bölümüne bakın.
onObserverRestoreInitiated	Yalnızca gözlemci modu: Bir kullanıcı bir flow’da geri yükleme butonuna dokunduğunda çağrılır. Adapty geri yükleme yapmaz — onu kendiniz gerçekleştirin, ardından geri yüklenen işlemleri bildirin. Aşağıdaki Gözlemci modunda satın almaları yönetme bölümüne bakın.

Gözlemci modunda satın almaları yönetme

SDK’yı Gözlemci modunda (observerMode: true) etkinleştirdiyseniz ve Adapty tarafından render edilen bir flow sunarsanız, SDK satın almaları sizin için yapmaz. Bir kullanıcı satın alma veya geri yükleme butonuna dokunduğunda, SDK bunun yerine onObserverPurchaseInitiated veya onObserverRestoreInitiated çağırır. Satın almayı veya geri yüklemeyi kendi kodunuzla gerçekleştirin, flow’un yükleme göstergesini sağlanan callback’lerle yönetin ve ardından işlemi Adapty’ye bildirin.

const unsubscribe = view.setEventHandlers({
  onObserverPurchaseInitiated(product, onStartPurchase, onFinishPurchase) {
    onStartPurchase(); // show the flow's loading indicator
    myPurchaseApi(product.vendorProductId)
      .then((transactionId) => adapty.reportTransaction(transactionId))
      .finally(() => onFinishPurchase()); // hide the loading indicator
    return false; // keep the flow open; dismiss it yourself after success
  },
  onObserverRestoreInitiated(onStartRestore, onFinishRestore) {
    onStartRestore();
    myRestoreApi()
      .finally(() => onFinishRestore());
    return false;
  },
});

Bu rehber; satın almalar, geri yüklemeler, ürün seçimi ve paywall render işlemleri için olay yönetimini kapsar. Ayrıca buton yönetimini de (paywall’ı kapatma, bağlantı açma vb.) uygulamanız gerekir. Ayrıntılar için buton eylemlerini yönetme rehberimize bakın.

Paywall Builder ile yapılandırılan paywall’lar, satın alma yapmak ve geri yüklemek için ekstra koda ihtiyaç duymaz. Ancak uygulamanızın yanıt verebileceği bazı olaylar üretirler. Bu olaylar; buton tıklamalarını (kapatma butonları, URL’ler, ürün seçimleri vb.) ve paywall üzerinde gerçekleştirilen satın almayla ilgili eylemlere ait bildirimleri içerir. Bu olaylara nasıl yanıt vereceğinizi aşağıda öğrenin.

Bu rehber yalnızca yeni Paywall Builder paywall’ları içindir; bunlar Adapty SDK v3.0 veya sonrasını gerektirir.

Mobil uygulamanızda paywall ekranında gerçekleşen süreçleri kontrol etmek veya izlemek için olay işleyicilerini uygulayın:

React bileşeni için olayları, AdaptyPaywallView bileşenindeki tekil olay işleyici prop’ları aracılığıyla yönetirsiniz:


function MyPaywall({ paywall }) {
  const onCloseButtonPress = useCallback<EventHandlers['onCloseButtonPress']>(() => {}, []);
  const onProductSelected = useCallback<EventHandlers['onProductSelected']>((productId) => {}, []);
  const onPurchaseStarted = useCallback<EventHandlers['onPurchaseStarted']>((product) => {}, []);
  const onPurchaseCompleted = useCallback<EventHandlers['onPurchaseCompleted']>((purchaseResult, product) => {}, []);
  const onPurchaseFailed = useCallback<EventHandlers['onPurchaseFailed']>((error, product) => {}, []);
  const onRestoreStarted = useCallback<EventHandlers['onRestoreStarted']>(() => {}, []);
  const onRestoreCompleted = useCallback<EventHandlers['onRestoreCompleted']>((profile) => {}, []);
  const onRestoreFailed = useCallback<EventHandlers['onRestoreFailed']>((error) => {}, []);
  const onPaywallShown = useCallback<EventHandlers['onPaywallShown']>(() => {}, []);
  const onRenderingFailed = useCallback<EventHandlers['onRenderingFailed']>((error) => {}, []);
  const onLoadingProductsFailed = useCallback<EventHandlers['onLoadingProductsFailed']>((error) => {}, []);
  const onUrlPress = useCallback<EventHandlers['onUrlPress']>((url) => {
    Linking.openURL(url);
  }, []);
  const onCustomAction = useCallback<EventHandlers['onCustomAction']>((actionId) => {}, []);
  const onWebPaymentNavigationFinished = useCallback<EventHandlers['onWebPaymentNavigationFinished']>(() => {}, []);

  return (
    <AdaptyPaywallView
      paywall={paywall}
      style={styles.container}
      onCloseButtonPress={onCloseButtonPress}
      onProductSelected={onProductSelected}
      onPurchaseStarted={onPurchaseStarted}
      onPurchaseCompleted={onPurchaseCompleted}
      onPurchaseFailed={onPurchaseFailed}
      onRestoreStarted={onRestoreStarted}
      onRestoreCompleted={onRestoreCompleted}
      onRestoreFailed={onRestoreFailed}
      onPaywallShown={onPaywallShown}
      onRenderingFailed={onRenderingFailed}
      onLoadingProductsFailed={onLoadingProductsFailed}
      onUrlPress={onUrlPress}
      onCustomAction={onCustomAction}
      onWebPaymentNavigationFinished={onWebPaymentNavigationFinished}
    />
  );
}

Modal sunum için olay işleyicileri metodunu uygulayın.

setEventHandlers’ı birden çok kez çağırmak, sağladığınız işleyicileri geçersiz kılar; söz konusu belirli olaylar için hem varsayılan hem de önceden ayarlanmış işleyicilerin yerini alır.


const view = await createPaywallView(paywall);

const unsubscribe = view.setEventHandlers({
  onCloseButtonPress() {
    return true;
  },
  onAndroidSystemBack() {
    return true;
  },
  onPurchaseCompleted(purchaseResult, product) {
    return purchaseResult.type !== 'user_cancelled';
  },
  onPurchaseStarted(product) { /***/},
  onPurchaseFailed(error) { /***/ },
  onRestoreCompleted(profile) { /***/ },
  onRestoreFailed(error) { /***/ },
  onProductSelected(productId) { /***/},
  onRenderingFailed(error) { /***/ },
  onLoadingProductsFailed(error) { /***/ },
  onUrlPress(url) {
      Linking.openURL(url);
      return false; // Keep paywall open
  },
  onPaywallShown() { /***/ },
  onPaywallClosed() { /***/ },
  onWebPaymentNavigationFinished() { /***/ },
});

Olay örnekleri (Genişletmek için tıklayın)

// onCloseButtonPress
{
  //Record the event
}

// onAndroidSystemBack
{
  //Record the event
}

// onUrlPress
{
  "url": "https://example.com/terms"
}

// onCustomAction
{
  "actionId": "login"
}

// onProductSelected
{
  "productId": "premium_monthly"
}

// onPurchaseStarted
{
  "product": {
    "vendorProductId": "premium_monthly",
    "localizedTitle": "Premium Monthly",
    "localizedDescription": "Premium subscription for 1 month",
    "price": {
      "amount": 9.99,
      "currencyCode": "USD",
      "currencySymbol": "$",
      "localizedString": "$9.99"
    }
  }
}

// onPurchaseCompleted - Success
{
  "purchaseResult": {
    "type": "success",
    "profile": {
      "accessLevels": {
        "premium": {
          "id": "premium",
          "isActive": true,
          "expiresAt": "2024-02-15T10:30:00Z"
        }
      }
    }
  },
  "product": {
    "vendorProductId": "premium_monthly",
    "localizedTitle": "Premium Monthly",
    "localizedDescription": "Premium subscription for 1 month",
    "price": {
      "amount": 9.99,
      "currencyCode": "USD",
      "currencySymbol": "$",
      "localizedString": "$9.99"
    }
  }
}

// onPurchaseCompleted - Cancelled
{
  "purchaseResult": {
    "type": "user_cancelled"
  },
  "product": {
    "vendorProductId": "premium_monthly",
    "localizedTitle": "Premium Monthly",
    "localizedDescription": "Premium subscription for 1 month",
    "price": {
      "amount": 9.99,
      "currencyCode": "USD",
      "currencySymbol": "$",
      "localizedString": "$9.99"
    }
  }
}

// onPurchaseFailed
{
  "error": {
    "code": "purchase_failed",
    "message": "Purchase failed due to insufficient funds",
    "details": {
      "underlyingError": "Insufficient funds in account"
    }
  },
  "product": {
    "vendorProductId": "premium_monthly",
    "localizedTitle": "Premium Monthly",
    "localizedDescription": "Premium subscription for 1 month",
    "price": {
      "amount": 9.99,
      "currencyCode": "USD",
      "currencySymbol": "$",
      "localizedString": "$9.99"
    }
  }
}

// onRestoreCompleted
{
  "profile": {
    "accessLevels": {
      "premium": {
        "id": "premium",
        "isActive": true,
        "expiresAt": "2024-02-15T10:30:00Z"
      }
    },
    "subscriptions": [
      {
        "vendorProductId": "premium_monthly",
        "isActive": true,
        "expiresAt": "2024-02-15T10:30:00Z"
      }
    ]
  }
}

// onRestoreFailed
{
  "error": {
    "code": "restore_failed",
    "message": "Purchase restoration failed",
    "details": {
      "underlyingError": "No previous purchases found"
    }
  }
}

// onRenderingFailed
{
  "error": {
    "code": "rendering_failed",
    "message": "Failed to render paywall interface",
    "details": {
      "underlyingError": "Invalid paywall configuration"
    }
  }
}

// onLoadingProductsFailed
{
  "error": {
    "code": "products_loading_failed",
    "message": "Failed to load products from the server",
    "details": {
      "underlyingError": "Network timeout"
    }
  }
}

// onPaywallShown
{
  //Record the event
}

// onPaywallClosed
{
  //Record the event
}

// onWebPaymentNavigationFinished
{
  //Record the event
}

İhtiyacınız olan olay işleyicilerini kaydedebilir, ihtiyacınız olmayanları atlayabilirsiniz. Bu durumda, kullanılmayan olay dinleyicileri oluşturulmaz. Zorunlu olay işleyicisi yoktur.

Olay işleyicileri bir boolean döndürür. true döndürülürse, görüntüleme süreci tamamlanmış sayılır; böylece paywall ekranı kapanır ve bu view için olay dinleyicileri kaldırılır.

Bazı olay işleyicilerinin, gerekirse geçersiz kılabileceğiniz bir varsayılan davranışı vardır:

onCloseButtonPress: kapatma butonuna basıldığında paywall’ı kapatır.
onUrlPress: tıklanan URL’yi açar ve paywall’ı açık tutar.
onAndroidSystemBack (yalnızca modal sunum için): Back butonuna basıldığında paywall’ı kapatır.
onRestoreCompleted: başarılı geri yüklemeden sonra paywall’ı kapatır.
onPurchaseCompleted: kullanıcı iptal etmediği sürece paywall’ı kapatır.
onRenderingFailed: render başarısız olursa paywall’ı kapatır.

Olay işleyicileri

Olay işleyici	Açıklama
onCustomAction	Bir kullanıcı özel bir eylem gerçekleştirdiğinde, örneğin bir özel butona tıkladığında çağrılır.
onUrlPress	Bir kullanıcı paywall’ınızdaki bir URL’ye tıkladığında çağrılır.
onAndroidSystemBack	Yalnızca modal sunum: Bir kullanıcı Android sistem Back butonuna dokunduğunda çağrılır.
onCloseButtonPress	Kapatma butonu görünürken bir kullanıcı ona dokunduğunda çağrılır. Bu işleyicide paywall ekranını kapatmanız önerilir.
onPurchaseCompleted	Satın alma tamamlandığında çağrılır; ister başarılı, ister kullanıcı tarafından iptal edilmiş, ister onay bekliyor olsun. Başarılı bir satın alma durumunda güncellenmiş bir `AdaptyProfile` sağlar. Kullanıcı iptalleri ve bekleyen ödemeler (örneğin ebeveyn onayı gerektiğinde), `onPurchaseFailed` değil, bu olayı tetikler.
onPurchaseStarted	Bir kullanıcı satın alma sürecini başlatmak için “Purchase” eylem butonuna dokunduğunda çağrılır.
onPurchaseFailed	Bir satın alma hatalar nedeniyle başarısız olduğunda çağrılır (örneğin ödeme kısıtlamaları, geçersiz ürünler, ağ hataları, işlem doğrulama hataları). Bunun yerine `onPurchaseCompleted`’ı tetikleyen kullanıcı iptalleri veya bekleyen ödemeler için çağrılmaz.
onRestoreStarted	Bir kullanıcı satın alma geri yükleme sürecini başlattığında çağrılır.
onRestoreCompleted	Satın alma geri yükleme başarılı olduğunda çağrılır ve güncellenmiş bir `AdaptyProfile` sağlar. Kullanıcı gerekli `accessLevel`’a sahipse ekranı kapatmanız önerilir. Nasıl kontrol edileceğini öğrenmek için Abonelik durumu konusuna bakın.
onRestoreFailed	Geri yükleme süreci başarısız olduğunda çağrılır ve `AdaptyError` sağlar.
onProductSelected	Paywall view’indeki herhangi bir ürün seçildiğinde çağrılır; böylece kullanıcının satın almadan önce ne seçtiğini izleyebilirsiniz.
onRenderingFailed	View render’ı sırasında bir hata oluştuğunda çağrılır ve `AdaptyError` sağlar. Bu tür hatalar oluşmamalıdır; bir tanesiyle karşılaşırsanız lütfen bize bildirin.
onLoadingProductsFailed	Ürün yükleme başarısız olduğunda çağrılır ve `AdaptyError` sağlar. View oluştururken `prefetchProducts: true` ayarlamadıysanız, AdaptyUI gerekli nesneleri sunucudan kendisi getirir.
onPaywallShown	Paywall kullanıcıya görüntülendiğinde çağrılır. iOS’ta ayrıca, bir kullanıcı bir paywall içindeki web paywall butonuna dokunduğunda ve uygulama içi tarayıcıda bir web paywall açıldığında çağrılır.
onPaywallClosed	Yalnızca modal sunum: Paywall kullanıcı tarafından kapatıldığında çağrılır. iOS’ta ayrıca, bir paywall’dan uygulama içi tarayıcıda açılan bir web paywall ekrandan kaybolduğunda çağrılır.
onWebPaymentNavigationFinished	Satın alma için bir web paywall açma girişiminden sonra çağrılır; ister başarılı ister başarısız olsun.