Swot Ads Cloud — Dynamic Ad Engine & Android API

Serving Ads:

ACTIVE

/ads/global.json

0 Ads • scope: global

Live Android Device Simulator

Interactive Feed

20:40

5G

S

Swot App

U

📰

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.

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
}

Admin Token & Cloudflare Settings

Current Admin Token (ADMIN_TOKEN)

Token is automatically attached as x-admin-token header on all API calls.

Cloudflare Pages Setup:

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

2. Set secret ADMIN_TOKEN in Settings > Environment variables.

SWOT ADS ENGINE Edge KV

SWOT ADS ENGINE

Create New Ad

Add New City Scope

Raw JSON Document Editor

Android App Integration Hub

Admin Token & Cloudflare Settings