Appmeasurely Documentation

Everything you need to integrate, configure and use Appmeasurely.

Quick start guide

Get up and running with Appmeasurely in under 10 minutes. Here's what you need to do:

Sign up — Create your account at appmeasurely.com/signup. Your account will be reviewed and activated within 24 hours.

Add your app — Once approved, log in and click + Add App. Enter your app name, bundle ID and platform.

Get your API key — After adding your app, copy your unique API key. You'll need this to initialize the SDK.

Install the SDK — Add 3 lines of code to your iOS or Android app. Events start flowing immediately.

Verify — Send a test event using the curl command shown in your dashboard to confirm everything is working.

Go to appmeasurely.com/signup and fill in:

Your first and last name
Company name
Work email address
Password (minimum 8 characters)
Select a plan (Free, Starter, Pro, or Enterprise)

ℹ️ All accounts require admin approval before activation. You'll receive a confirmation email when your account is approved — usually within 24 hours.

Once approved, you'll receive an email confirmation. Click the link to verify your email, then log in at appmeasurely.com/dashboard.

Adding your app

After logging in, click + Add App in the top right of the dashboard.

App name: The display name for your app (e.g. "My Awesome App")
Platform: iOS, Android, or Both
Bundle ID: Your app's unique identifier
- iOS: Found in Xcode → Target → General → Bundle Identifier (e.g. com.acme.myapp)
- Android: Found in your build.gradle file as applicationId

⚠️ Free plan allows 1 app. To add more apps, upgrade to Starter (3 apps) or Pro (10 apps).

Installing the SDK

After adding your app, you'll receive a unique API key. Use this to initialize the SDK in your app.

iOS SDK (Swift)

1. Download TrackIQ.swift from your SDK Docs page and add it to your Xcode project.

2. Initialize in your AppDelegate:

// AppDelegate.swift
import UIKit

@main
class AppDelegate: UIResponder, UIApplicationDelegate {
    func application(_ application: UIApplication,
        didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        
        Appmeasurely.shared.start(appKey: "YOUR_API_KEY")
        return true
    }
}

3. Track events anywhere in your app:

// Track a purchase
Appmeasurely.shared.logPurchase(revenue: 9.99, currency: "USD")

// Track a custom event
Appmeasurely.shared.logEvent("tutorial_complete", parameters: [
    "level": "1",
    "time_spent": "120"
])

Android SDK (Kotlin)

1. Download Appmeasurely.kt from your SDK Docs page and add it to your project.

2. Initialize in your Application class:

// MyApplication.kt
class MyApplication : Application() {
    override fun onCreate() {
        super.onCreate()
        Appmeasurely.start(this, appKey = "YOUR_API_KEY")
    }
}

3. Track events:

// Track a purchase
Appmeasurely.logPurchase(revenue = 9.99, currency = "USD")

// Track a custom event
Appmeasurely.logEvent("tutorial_complete", mapOf(
    "level" to "1",
    "time_spent" to "120"
))

React Native SDK

// App.tsx
import Appmeasurely from './appmeasurely';
import { useEffect } from 'react';

export default function App() {
  useEffect(() => {
    Appmeasurely.start('YOUR_API_KEY');
  }, []);
  
  // Track events
  const handlePurchase = () => {
    Appmeasurely.logPurchase({ revenue: 9.99, currency: 'USD' });
  };
}

Flutter SDK

// main.dart
import 'package:appmeasurely/appmeasurely.dart';

void main() async {
  await Appmeasurely.start(appKey: 'YOUR_API_KEY');
  runApp(MyApp());
}

// Track events
Appmeasurely.logEvent('tutorial_complete', values: {
  'level': '1',
  'time_spent': '120'
});

Sending events

Appmeasurely supports the following event types:

Install event: Sent automatically when SDK is first initialized
Purchase event: Use logPurchase(revenue, currency)
Custom events: Use logEvent(name, parameters)

You can also send events directly via the API:

curl -X POST https://uqvknwgcpptxnbmsubkc.supabase.co/functions/v1/events \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{"app_id":"YOUR_APP_ID","event_name":"af_install","platform":"ios","country":"US"}'

Attribution

The Attribution section in your dashboard shows where your installs are coming from. By default it shows the last 30 days. You can:

Filter by date range using the date picker in the top right
Switch between attribution models (last touch, first touch, linear)
Drill down by media source, campaign, ad set, or ad
Export attribution data as CSV

Cohort analytics

Cohort analytics groups your users by install date and tracks their behaviour over time. To use cohorts:

Go to Cohort Analysis in the left sidebar
Select a date range for your cohort
Choose a retention metric (D1, D7, D14, D30)
Filter by media source, country, or platform

ℹ️ Cohort analytics is available on Pro and Enterprise plans.

Fraud detection

Appmeasurely automatically detects and blocks:

Click flooding: Installs with CTIT under 1 second are blocked
Device farms: AI detects device farm patterns and blocks them
SDK spoofing: Cryptographic verification rejects spoofed events
Install hijacking: Last-click hijacking is detected and blocked

View fraud alerts in the Fraud Detection section of your dashboard.

Partner tracking

To add a partner and create a tracking link:

Go to Partner Management from your dashboard

Click + Add Partner and search for your partner or add a custom one

Set commission model (CPA, revenue share, or fixed fee)

Click + Create Link to generate a tracking link for that partner

Share the link with your partner — every click, install and purchase is tracked

Exporting data

You can export data from Appmeasurely in the following ways:

CSV export: Click the Export button on any dashboard page
BigQuery integration: Available on Pro and Enterprise plans
Snowflake integration: Available on Pro and Enterprise plans
API access: Query your data programmatically via our REST API

Multiple platforms

If your app is available on both iOS and Android, you can either:

Single app entry: Select "Both" when adding your app. One API key tracks both platforms.
Separate entries: Add iOS and Android as separate apps with individual API keys. Useful if you want separate reporting.

API reference

Base URL: https://uqvknwgcpptxnbmsubkc.supabase.co/functions/v1

All API requests require the x-api-key header with your app's API key.

POST /events
Content-Type: application/json
x-api-key: YOUR_API_KEY

{
  "app_id": "YOUR_APP_ID",
  "event_name": "af_purchase",
  "platform": "ios",
  "country": "US",
  "revenue": 9.99,
  "currency": "USD",
  "custom_params": {
    "level": "5"
  }
}

Webhooks

Appmeasurely can send real-time postbacks to your partner systems when events occur. To configure webhooks:

Go to Integrations in your dashboard
Click Add Webhook
Enter your endpoint URL and select which events to send
Test the webhook using the built-in test tool