Revenue

Revenue tracking lets you attribute purchases to links and campaigns, monitor metrics like ARPU and LTV, and view breakdowns by product and platform — all from the Grovs dashboard.

Revenue tracking is currently in beta. There may be minor discrepancies in currency conversion rates while processing is being fine-tuned.

Setup

1. Enable revenue tracking in the dashboard

1. Open the Grovs dashboard
2. Go to your project's Settings
3. Under Revenue Tracking, click Enable

Revenue data will only be collected while this setting is active.

2. Configure Google Play Real-Time Notifications

Option A: Automatic setup (recommended)

The Grovs dashboard provides a script that automates the entire Google Cloud Platform configuration — including service account creation, API enablement, and Pub/Sub setup.

1. In the Grovs dashboard, go to Developers → Android Setup → Revenue
2. Click Download Script to download grovs_android_gcloud_setup.sh
3. Open Google Cloud Shell
4. Upload the script: click the ⋮ (three dots) menu in the Cloud Shell toolbar → Upload → select the downloaded file
5. Run the script:

   Bash

   Copy

   chmod +x grovs_android_gcloud_setup.sh
   ./grovs_android_gcloud_setup.sh

6. The script will show your available Google Cloud projects — select one or create a new one
7. When the script completes, it outputs the service account email and a play-api-key.json file — you'll need both in the steps below

Option B: Manual setup

If you prefer to configure Google Cloud yourself:

1. In the Google Cloud Console, create a Pub/Sub topic for your app
2. Create a service account with access to the Android Publisher API
3. Download the service account's JSON key file

3. Complete the connection

These steps apply regardless of whether you used the automatic script or manual setup.

Upload the key to Grovs

1. In the Grovs dashboard under Developers → Android Setup → Revenue, upload the JSON key file (play-api-key.json from the script, or the key you created manually)

Invite the service account to Google Play Console

1. In the Google Play Console, go to Users and permissions
2. Click Invite new users and enter the service account email shown in the Grovs dashboard (or printed by the setup script)
3. Grant the following permissions (all three are required for revenue tracking):
   • View app information and download bulk reports (read-only)
   • View financial data, orders, and cancellation survey responses
   • Manage orders and subscriptions
4. Click Invite user and confirm

Enable Real-Time Developer Notifications

1. In the Google Play Console, go to your app → Monetization setup → Google Play Billing → Real-time developer notifications
2. Paste the Notifications endpoint URL shown in the Grovs dashboard
3. Enable the following notification types:
   • Subscription notifications — required for tracking recurring purchases
   • Voided purchase notifications — required for tracking refunds and chargebacks
   • One-time product notifications — required if your app sells one-time (non-subscription) products
4. Send a test notification to verify the connection

Logging purchases

The SDK provides two methods depending on whether you use Google Play Billing or a custom payment flow.

Google Play purchases

For purchases made through Google Play Billing, pass the purchase object's originalJson:

// After a successful purchase via Google Play Billing Library
billingClient.launchBillingFlow(activity, billingFlowParams)
 
// In your PurchasesUpdatedListener
override fun onPurchasesUpdated(billingResult: BillingResult, purchases: List<Purchase>?) {
    if (billingResult.responseCode == BillingClient.BillingResponseCode.OK && purchases != null) {
        for (purchase in purchases) {
            Grovs.logInAppPurchase(purchase.originalJson)
        }
    }
}

The SDK automatically extracts the product ID, purchase token, price, and currency from the purchase JSON. Duplicate transactions are filtered — you can safely call this method without worrying about double-counting.

Custom purchases

For purchases processed through your own server, Stripe, or any non-Play Store payment system:

Grovs.logCustomPurchase(
    type = PaymentEventType.BUY,
    priceInCents = 999,       // $9.99
    currency = "USD",
    productId = "premium_monthly"
)

Parameters:

Tracking cancellations and refunds

Use the CANCELLATION and REFUND event types to keep revenue data accurate:

// Log a cancellation
Grovs.logCustomPurchase(
    type = PaymentEventType.CANCELLATION,
    priceInCents = 999,
    currency = "USD",
    productId = "premium_monthly"
)
 
// Log a refund
Grovs.logCustomPurchase(
    type = PaymentEventType.REFUND,
    priceInCents = 999,
    currency = "USD",
    productId = "premium_monthly"
)

For Google Play purchases, cancellations and refunds are detected automatically when you configure Google Play Real-Time Notifications.

Dashboard metrics

Once revenue tracking is enabled and events are flowing in, the dashboard shows:

• Total Revenue — aggregate revenue with currency conversion
• ARPU — average revenue per user
• ARPPU — average revenue per paying user
• LTV — lifetime value per product
• Units Sold — total purchases
• First-time vs. Repeat Purchases — new vs. returning customers
• Cancellations — cancelled transactions

All metrics can be filtered by date range, platform, and product.