Phản hồi hành động flow - Capacitor

Nếu bạn đang xây dựng flow hoặc paywall bằng Flow Builder hoặc Paywall Builder của Adapty, việc thiết lập các nút đúng cách là rất quan trọng:

1. Thêm một nút trong builder và gán cho nó một action có sẵn hoặc tạo một custom action ID.
2. Viết code trong app của bạn để xử lý từng action đã gán.

Hướng dẫn này trình bày cách xử lý các custom action và action có sẵn trong code của bạn.

Đóng flow và paywall

Để thêm nút đóng flow hoặc paywall:

1. Trong builder, thêm một nút và gán cho nó hành động Close.
2. Trong code của ứng dụng, triển khai một handler cho hành động close để đóng flow hoặc paywall.

const view = await createFlowView(flow);

const unsubscribe = await view.setEventHandlers({
  onCloseButtonPress() {
    return true; // allow the flow to close
  },
});

Trên Android, nút Back của hệ thống và cử chỉ vuốt để quay lại sẽ kích hoạt một sự kiện riêng là onAndroidSystemBack. Trong SDK v4, nút này không còn tự động đóng flow theo mặc định nữa. Trả về true từ handler nếu bạn muốn nút Back đóng flow:

const unsubscribe = await view.setEventHandlers({
  onAndroidSystemBack() {
    return true; // close the flow when the Back button is pressed
  },
});

Mở URL từ flow và paywall

Để thêm nút mở một liên kết từ flow hoặc paywall (ví dụ: Terms of use hoặc Privacy policy):

1. Trong builder, thêm một nút, gán cho nó hành động Open URL, và nhập URL bạn muốn mở.
2. Nếu cần, trong code ứng dụng của bạn, hãy triển khai một handler cho hành động openUrl để mở URL nhận được theo cách của riêng bạn.

const unsubscribe = await view.setEventHandlers({
  onUrlPress(url) {
    // Open the URL your own way, e.g. with the Capacitor Browser plugin
    Browser.open({ url });
    return false; // keep the flow open
  },
});

Xử lý các hành động tùy chỉnh

Để thêm nút xử lý các hành động khác:

1. Trong builder, thêm một nút, gán cho nó hành động Custom, và đặt cho nó một ID.
2. Trong code của ứng dụng, triển khai handler cho ID hành động bạn đã tạo.

Ví dụ: nếu bạn có một bộ ưu đãi gói đăng ký khác hoặc sản phẩm mua một lần, bạn có thể thêm nút để hiển thị một flow hoặc paywall khác:

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

Nếu bạn đang xây dựng paywall bằng Adapty Paywall Builder, việc thiết lập các nút bấm đúng cách là rất quan trọng:

1. Thêm nút trong Paywall Builder và gán cho nó một hành động có sẵn hoặc tạo một ID hành động tùy chỉnh.
2. Viết code trong ứng dụng của bạn để xử lý từng hành động bạn đã gán.

Hướng dẫn này chỉ cách xử lý các hành động tùy chỉnh và hành động có sẵn trong code của bạn.

Đóng paywall

Để thêm nút đóng paywall:

1. Trong Paywall Builder, thêm một nút và gán cho nó hành động Close.
2. Trong code của ứng dụng, triển khai trình xử lý cho hành động close để đóng paywall.

const view = await createPaywallView(paywall);

const unsubscribe = view.setEventHandlers({
  onCloseButtonPress() {
    console.log('User closed paywall');
    return true; // Allow the paywall to close
  }
});

Mở URL từ paywall

Để thêm nút mở liên kết từ paywall của bạn (ví dụ: Terms of use hoặc Privacy policy):

1. Trong paywall builder, thêm một nút, gán cho nó hành động Open URL, và nhập URL bạn muốn mở.
2. Trong code của ứng dụng, triển khai handler cho hành động openUrl để mở URL nhận được trong trình duyệt.

const view = await createPaywallView(paywall);

const unsubscribe = view.setEventHandlers({
  onUrlPress(url) {
    window.open(url, '_blank');
    return false; // Don't close the paywall
  },
});

Đăng nhập vào ứng dụng

Để thêm nút đăng nhập cho người dùng vào ứng dụng của bạn:

1. Trong paywall builder, thêm một nút và gán cho nó hành động Login.
2. Trong code ứng dụng của bạn, triển khai một handler cho hành động login để xác định người dùng.

const view = await createPaywallView(paywall);

const unsubscribe = view.setEventHandlers({
  onCustomAction(actionId) {
    if (actionId === 'login') {
      // Navigate to login screen
      console.log('User requested login');
    }
  }
});

Xử lý hành động tùy chỉnh

Để thêm một nút xử lý các hành động khác:

1. Trong paywall builder, thêm một nút, gán cho nó hành động Custom và đặt cho nó một ID.
2. Trong mã nguồn ứng dụng, triển khai một handler cho ID hành động bạn đã tạo.

Ví dụ: nếu bạn có một bộ ưu đãi gói đăng ký hoặc sản phẩm mua một lần khác, bạn có thể thêm một nút sẽ hiển thị một paywall khác:

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