⚡

SWOT ADS ENGINE Edge KV

Cloudflare Pages & KV Ad Server for Android

Edge Connected

Serving Ads:

ACTIVE

/ads/global.json

Demo Datasets

Document Actions

0 Ads • scope: global

0 selected

Live Android Device Simulator

Interactive Feed

20:40

Swot App

📰

Daily Updates 10m ago

Swipe down to test your served ads inside this simulated Android app feed.

⚡

Local Discoveries Just now

Personalized recommendations and community announcements appear here.

Live preview matches your Android app's UI rendering

Create New Ad

Adding ad to current scope

Select Ad Format

Banner

Standard Card

Photo

Visual Showcase

Video

MP4 Stream

Ad ID

Badge Text

Rating (0.0 - 5.0)

Title

Subtitle

Description

Media URL (Image or MP4 Video)

•

Action URL (Link or Deep Link)

Action Button Label

Sponsor Tag

Location Info

Allow Dismiss (x)

Add New City Scope

Create a dedicated ad payload for any city. The Android app can fetch ads by requesting /ads/<city>.json.

City Name

Raw JSON Document Editor

Directly inspect, edit, or copy the exact JSON payload

Ready

Android App Integration Hub

Everything needed to consume this JSON inside your Android application

Android Fetch Endpoint

https://.../ads/global.json

⚡ Tip: Cache-Control, ETag, and CORS (Access-Control-Allow-Origin: *) are pre-configured automatically.

Kotlin Data Classes (Retrofit / Moshi / Gson)

data class AdsResponse(
    val scope: String? = null,
    val city: String? = null,
    val enabled: Boolean = true,
    val ads: List<AdItem> = emptyList()
)

data class AdItem(
    val id: String,
    val type: String, // "banner", "photo", "video"
    val title: String,
    val subtitle: String? = null,
    val description: String? = null,
    val mediaUrl: String,
    val actionUrl: String,
    val actionLabel: String,
    val sponsorTag: String? = null,
    val badgeText: String? = null,
    val isDismissible: Boolean = true,
    val locationInfo: String? = null,
    val rating: Double? = null
)

Retrofit API Interface

interface AdsApiService {
    @GET("ads/global.json")
    suspend fun getGlobalAds(): AdsResponse

    @GET("ads/{city}.json")
    suspend fun getCityAds(@Path("city") city: String): AdsResponse
}

Cloudflare Pages & Auth

Admin Secret Token (ADMIN_TOKEN)

If not configured in your Cloudflare Pages dashboard, leave empty to allow unrestricted access.

Cloudflare Pages Setup:

1. Bind KV namespace as ADS_KV in Settings > Functions.

2. (Optional) Set secret ADMIN_TOKEN in Settings > Environment variables.