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.

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

2. Configure platform notifications

• Android: set up Google Play Real-Time Developer Notifications. See the Android Revenue guide for details.
• iOS: configure App Store Server Notifications in App Store Connect. See the iOS Revenue guide for the URLs to set.

Logging purchases

Platform store purchases

logInAppPurchase takes an object with one platform-specific field. Each platform ignores the other's field:

• iOS: transactionId, the StoreKit 2 transaction ID as a decimal string.
• Android: originalJson, the Google Play Billing purchase's originalJson string.

import { Platform } from 'react-native';
import Grovs from 'react-native-grovs-wrapper';
 
try {
    const success = await Grovs.logInAppPurchase(
        Platform.OS === 'ios'
            ? { transactionId: transaction.id }        // StoreKit 2 transaction ID
            : { originalJson: purchase.originalJson }   // Play Billing purchase JSON
    );
    console.log('Purchase tracked:', success);
} catch (error) {
    console.error('Error tracking purchase:', error);
}

The wrapper validates the input before calling native and rejects with an error if the field for the current platform is missing, or if transactionId is not a numeric string on iOS. What the resolved boolean means differs per platform:

• On iOS, false means the native SDK did not accept the purchase: the ID could not be parsed as a 64-bit integer, or the device runs iOS 14 or earlier (StoreKit 2 needs iOS 15). Only the ID is sent; product, price, and currency are resolved on the backend, and an ID already logged on the device is skipped.
• On Android, the call resolves true as soon as the JSON has been handed to the native SDK. It does not confirm that the backend accepted the purchase. The SDK reads the product ID and purchase token from the JSON, the backend verifies it and fills in price and currency, and de-duplicates on the purchase token.

Log each purchase once, right after it completes.

Custom purchases

For purchases processed through Stripe, PayPal, or any non-store payment system:

try {
    const success = await Grovs.logCustomPurchase(
        'buy',              // type: 'buy' | 'cancel' | 'refund'
        999,                // priceInCents: $9.99
        'USD',              // currency code
        'premium_monthly',  // product identifier
    );
    console.log('Custom purchase tracked:', success);
} catch (error) {
    console.error('Error:', error);
}

Parameters:

The promise resolves true once the purchase has been handed to the native SDK, which stores it and sends it when authenticated.

Tracking cancellations and refunds

// Log a cancellation
await Grovs.logCustomPurchase('cancel', 999, 'USD', 'premium_monthly');
 
// Log a refund
await Grovs.logCustomPurchase('refund', 999, 'USD', 'premium_monthly');

For App Store and Google Play purchases, cancellations and refunds are detected automatically when you configure platform server notifications.