Android SDK

The Android SDK (com.revenuehog:revenuehog-android) is a Kotlin library with zero runtime dependencies: it uses HttpURLConnection and org.json, which ship with the platform.

RequirementsCopy Anchor Link

• minSdk 24, compileSdk 35, Java 11.
• The INTERNET permission.
• An app in your workspace whose package name matches. RevenueHog resolves Android writes to a connected Google Play app with that package first, then to an App Store app with the same ID. See Google Play.

InstallCopy Anchor Link

The artifact is not on Maven Central yet. Publish it to your local Maven repository from a checkout of the SDK repository:

git clone https://github.com/Parra-Inc/revenue-hog-sdks
cd revenue-hog-sdks/kotlin
./gradlew :revenuehog-android:publishToMavenLocal

Then add mavenLocal() to your repositories and depend on it:

dependencies {
    implementation("com.revenuehog:revenuehog-android:0.2.0")
}

You can also include the module from source.

QuickstartCopy Anchor Link

class App : Application() {
    override fun onCreate() {
        super.onCreate()
        RevenueHog.configure(this)
    }
}

RevenueHog.identify("user_42") // after login
RevenueHog.reset()             // on logout

val listener = RevenueHog.billingListener(myListener) as PurchasesUpdatedListener
val billingClient = BillingClient.newBuilder(context)
    .setListener(listener)
    .enablePendingPurchases()
    .build()

override fun onPurchasesUpdated(result: BillingResult, purchases: List<Purchase>?) {
    purchases?.forEach { purchase ->
        RevenueHog.attributePurchase(
            purchaseToken = purchase.purchaseToken,
            productId = purchase.products.firstOrNull(),
        )
    }
}

How auth worksCopy Anchor Link

There is no API key and no attestation on Android yet (Play Integrity is planned). Requests carry no Authorization header and go through the quarantine path: RevenueHog accepts them when the package name resolves to exactly one app and labels the data unverified. See Authentication.

Play purchase tokensCopy Anchor Link

attributePurchase sends the Play purchaseToken as originalTransactionId. When the write resolves to a Google Play app, the server stores the token as the subscription's lineage key, the ID every Play event of that subscription carries, so the attribution joins the customer in the live feed. Older SDK builds that send no platform on attribute calls are still recognized: a long non-numeric ID is treated as a Play token.

API referenceCopy Anchor Link

All public calls are fire-and-forget onto a single background daemon thread named revenuehog. None throw.

All methods are @JvmStatic, so Java callers use RevenueHog.identify("user_42").

OptionsCopy Anchor Link

RevenueHog.configure(this, Options(
    baseUrl = "https://hog.internal.example",
    logLevel = LogLevel.DEBUG,
))

Paywall and PaywallSkuCopy Anchor Link

data class PaywallSku(val productId: String, val kind: String) // "subscription", "iap" or "unknown"

data class Paywall(
    val entitlement: String,
    val skus: List<PaywallSku>,
    val experimentId: String? = null,
    val variantKey: String? = null,
    val isFallback: Boolean,
) { val productIds: List<String> }

RevenueHog.paywall("pro", listOf("com.example.pro.annual", "com.example.pro.monthly")) { paywall ->
    // runs on the SDK thread: hop to main before touching views
    // query Play Billing with paywall.productIds, re-sort to that order, render
    RevenueHog.paywallShown(paywall, renderedProductIds)
}

The paywall fetch uses a 2.5 second connect and read timeout. If paywall is called before configure, onResult receives the fallback immediately.

What is storedCopy Anchor Link

Everything lives in the SharedPreferences file dev.revenuehog.sdk: user ID (rh_user_id), anonymous ID (rh_anon_id), sent purchases (rh_sent_txns), install ID (rh_install_id), paywall cache (rh_paywall_cache) and the offline queue (rh_queue, cap 100).

What is sentCopy Anchor Link

Your user ID or anonymous ID, the package name as bundleId, platform: "android", OS version (Build.VERSION.RELEASE), device model (Build.MODEL), locale and the attributes you pass. No advertising ID.

Behavior notesCopy Anchor Link

• Failed requests (network error, 429, 5xx) retry up to 3 times with backoff of 500 ms then 1 s, then queue. Other non-2xx responses are dropped.
• The SDK skips purchases already reported for the current user.
• The Android SDK does not send environment on paywall fetches, so the server treats them as Production.

TroubleshootingCopy Anchor Link

RelatedCopy Anchor Link