Back to home

Documentation

Integration Guide

Everything you need to add AdVerify SDK to your Android app — from admin panel setup to MT Manager integration.

What is AdVerify?

AdVerify is a self-hosted ad serving + PIN verification SDK for Android apps. Each user must verify a unique PIN (tied to their device) before the app is unlocked. PINs are generated through your link shortener — users complete an action to earn a PIN that only works on their device.

Complete Flow

1

Admin Setup

Create API key, add ads, configure PIN with your link shortener URL.

2

Patch Your APK

Add adverify.dex into your APK via MT Manager and add 3 lines of smali.

3

User Opens App

SDK calls init with the device's Android ID. Server checks if this device is verified.

4

PIN Dialog Appears

Device not verified → SDK shows a PIN dialog with a "Get PIN" button.

5

User Gets PIN

Taps Get PIN → browser opens your link shortener → user completes action → gets unique 6-digit PIN.

6

PIN Verified

User enters PIN in app → SDK verifies → device unlocked. Admin controls if PIN never expires or expires after X hours.

7

Ads Start Showing

Ads are fetched and displayed. Impressions and clicks tracked automatically.

Architecture

┌──────────────────┐        proxy         ┌──────────────────┐
│  Admin Panel      │ ──────────────────▸ │  Backend Server   │
│  (Next.js)        │                     │  (Express + DB)   │
└──────────────────┘                      └──────────────────┘
                                                   │
                          ┌────────────────────────┤
                          ▼                        ▼
                   ┌─────────────┐       ┌─────────────────┐
                   │ Android App  │       │ Link Shortener   │
                   │ (SDK inside) │       │ (Your existing)  │
                   └─────────────┘       └─────────────────┘