search

Purchasely / Purchasely-Firebase-Extension

Apache License 2.0
5 stars 1 forks source link

readme

Run In-App Purchases & Subscriptions with Purchasely

Author: Purchasely (https://www.purchasely.com) Contributorsr:

Description: Use this extension to keep track of your mobile apps' users' In-App Purchases & Subscriptions easily & seamlessly with Purchasely via Firebase Authentication & Firebase Firestore. This extension requires you to separately setup (or have already setup) your Purchasely project.

Details: Use this extension to keep track of your mobile apps' users' In-App Purchases & Subscriptions easily & seamlessly with Purchasely via Firebase Authentication & Firebase Firestore. This extension requires you to separately setup (or have already setup) your Purchasely project.

This extension stores your In-App Purchases & Subscriptions using Cloud Firestore and adds Custom Claims for your users' subscriptions using Firebase Authentication for convenient access control in your application.

Recommended usage

This extension is meant for both native & hybrid mobile applications In-App Purchases & Subscriptions using the app stores' In-App Purchases APIs. Currently supported app stores are the Apple App Store, Googe Play Store, Huawei App Gallery & Amazon App Store.

Demonstration apps

You can find examples of iOS & Android apps showcasing a Purchasely implementation using this Firebase Extension in the Purchasely/Purchasely-DemoFirebase GitHub repository.

Updating from 1.0.0

To update the extension, please go to your Firebase Console > Extensions > Run In-App Purchases & Subscriptions with Purchasely. If you are currently using purchasely/purchasely-in-app-purchases@1.0.0, the console should display an update message, and allow you to update the Extension, and walk you through the wizard.

Please note that during the extension's update, the extension might be unavailable, and you may not be able to receive and process webhook events from Purchasely for a few minutes. As our backend retries these events, this will resolve on it's own.

Once the extension is up to date, you may migrate your webhook to the latest (V3) version in the Purchasely Console.

Setting up the extension

To setup the extension, visit https://console.firebase.google.com/project/_/extensions/install?ref=purchasely/purchasely-in-app-purchases

Additional setup

Before installing this extension, set up the following Firebase services in your Firebase project:

Then, if you haven't already, in the Purchasely Console:

Setting up the webhook URL in the Purchasely Console

Once the extension has been installed, you will need to get the extension's Cloud Function's URL and set it up in your Purchasely Console as the webhook URL. The URL will only be available after the extension has finished being installed in your Firebase Console. This can take a few minutes.

Billing

This extension uses the following Firebase services which may have associated charges:

This extension also uses the following third-party services:

You are responsible for any costs associated with your use of these services.

Note from Firebase

To install this extension, your Firebase project must be on the Blaze (pay-as-you-go) plan. You will only be charged for the resources you use. Most Firebase services offer a free tier for low-volume use. Learn more about Firebase billing.

Starting August 17 2020, you will be billed a small amount (typically less than $0.10) when you install or reconfigure this extension. See the Cloud Functions for Firebase billing FAQ for a detailed explanation.

Configuration Parameters:

Cloud Functions:

Access Required:

This extension will operate with the following project IAM roles:

Using the extension

If you haven't already, you will need to setup your Purchasely App and your In-App Purchases in each app store your app is available on. To do so, you can follow the following guide: Quick Start - Console Configuration

Sign-up users with Firebase Authentication (optional)

The quickest way to sign-up new users is by using the Firebase Authentication SDK for your platform. Follow the steps outlined in the official docs. When configuring the extension you can choose to keep Firebase Authentication user's custom claims (https://firebase.google.com/docs/auth/admin/custom-claims) updated with their in-app subscriptions. If set to 'ENABLED' (default), upon receiving events the extension considers the Purchasely Event's user.vendor_id property to match the user's Firebase Authentication UID and updates the user's custom claims. If set to 'DISABLED', the extension will NOT update your users' Firebase Authentication custom claims

List your user's active subscriptions

Users' subscriptions are normal collections and docs in your Cloud Firestore and can be queried as such:

Javascript:

db.collection('${param:PURCHASELY_SUBSCRIPTIONS_COLLECTION}')
  .where('is_subscribed', '==', true)
  .whereField('user.vendor_id', '==', '$CURRENT_USER_FIRESTORE_AUTHENTICATION_ID')
  .get()
  .then(function (querySnapshot) {
    querySnapshot.forEach(async function (doc) {
      console.log(doc.id, ' => ', doc.data());
    });
  });

Swift:

firestore.collection('${param:PURCHASELY_SUBSCRIPTIONS_COLLECTION}')
  .whereField('is_subscribed', '==', true)
  .whereField('user.vendor_id', '==', '$CURRENT_USER_FIRESTORE_AUTHENTICATION_ID')
  .get()
  .then(function (querySnapshot) {
    querySnapshot.forEach(async function (doc) {
      console.log(doc.id, ' => ', doc.data());
    });
  });

Kotlin:

Firebase.firestore.collection(PURCHASELY_SUBSCRIPTIONS_COLLECTION)
      .whereEqualTo("user.vendor_id", USER_FIRESTORE_AUTHENTICATION_ID)
      .whereEqualTo("is_subscribed", true)
      .addSnapshotListener { value, error ->
          val subscriptions = value?.documents?.map { it.data }
                                    ?.filter { it?.get("is_subscribed") == true }

          val isSubscribed = subscriptions?.isEmpty()?.not() ?: false
      }

List your user's consumables

Users' consumables are normal collections and docs in your Cloud Firestore and can be queried as such:

Javascript:

db.collection('${param:PURCHASELY_CONSUMABLES_COLLECTION}')
  .whereField('user.vendor_id', '==', '$CURRENT_USER_FIRESTORE_AUTHENTICATION_ID')
  .get()
  .then(function (querySnapshot) {
    querySnapshot.forEach(async function (doc) {
      console.log(doc.id, ' => ', doc.data());
    });
  });

Swift:

firestore.collection('${param:PURCHASELY_CONSUMABLES_COLLECTION}')
  .whereField('user.vendor_id', '==', '$CURRENT_USER_FIRESTORE_AUTHENTICATION_ID')
  .get()
  .then(function (querySnapshot) {
    querySnapshot.forEach(async function (doc) {
      console.log(doc.id, ' => ', doc.data());
    });
  });

Kotlin:

Firebase.firestore.collection(PURCHASELY_CONSUMABLES_COLLECTION)
      .whereEqualTo("user.vendor_id", USER_FIRESTORE_AUTHENTICATION_ID)
      .addSnapshotListener { value, error ->
          val consumables = value?.documents?.map { it.data }
      }

List your user's non-consumables

Users' non-consumables are normal collections and docs in your Cloud Firestore and can be queried as such:

Javascript:

db.collection('${param:PURCHASELY_NON_CONSUMABLES_COLLECTION}')
  .whereField('user.vendor_id', '==', '$CURRENT_USER_FIRESTORE_AUTHENTICATION_ID')
  .get()
  .then(function (querySnapshot) {
    querySnapshot.forEach(async function (doc) {
      console.log(doc.id, ' => ', doc.data());
    });
  });

Swift:

firestore.collection('${param:PURCHASELY_NON_CONSUMABLES_COLLECTION}')
  .whereField('user.vendor_id', '==', '$CURRENT_USER_FIRESTORE_AUTHENTICATION_ID')
  .get()
  .then(function (querySnapshot) {
    querySnapshot.forEach(async function (doc) {
      console.log(doc.id, ' => ', doc.data());
    });
  });

Kotlin:

Firebase.firestore.collection(PURCHASELY_NON_CONSUMABLES_COLLECTION)
      .whereEqualTo("user.vendor_id", USER_FIRESTORE_AUTHENTICATION_ID)
      .addSnapshotListener { value, error ->
          val nonConsumables = value?.documents?.map { it.data }
      }

Monitoring

As a best practice, you can monitor the activity of your installed extension, including checks on its health, usage, and logs.

Access the Purchasely Console to manage all aspects of your Purchasely Project

Enjoy and please submit any feedback and feature requests on GitHub