GrowthCat iOS Ads SDK

public enum AdFormat: String {
    case banner        // inline strip
    case interstitial  // full-screen (image / video / rewarded / app store — server decides)

    public var isFullScreen: Bool { self == .interstitial }
}

import SwiftUI
import GrowthCat

@main
struct MyApp: App {
    init() {
        GrowthCat.initialize(
            apiKey: "gc_live_your_key_here",
            logsEnabled: true   // set false in production
        )
    }

    var body: some Scene {
        WindowGroup { ContentView() }
    }
}

// Check if ads are enabled at all
if GrowthCat.shared.sdkBootstrap?.adsConfig.adsEnabled == true {
    prefetchAdCatalogs()
    showAdEntryPoints()
}

// Read the full ads config
if let adsConfig = GrowthCat.shared.sdkBootstrap?.adsConfig {
    print("Ads enabled: \(adsConfig.adsEnabled)")
    print("Cache TTL: \(adsConfig.adCacheTTLSeconds)s")
    print("Max offline events: \(adsConfig.maxOfflineAdEvents)")
}

Task {
    let config = try await GrowthCat.shared.refreshSDKConfig()
    print("Ads enabled: \(GrowthCat.shared.sdkBootstrap?.adsConfig.adsEnabled ?? false)")
}

import SwiftUI
import GrowthCat

struct HomeView: View {
    var body: some View {
        VStack {
            // Your content
            Spacer()

            // Banner anchored to the bottom
            GrowthCatAdBannerView(
                placementKey: "home_banner",       // must match a key in your dashboard
                appUserID: "user_123",             // your app's user identifier
                sessionID: GrowthCat.makeSessionID(),
                minHeight: 60                      // default 60 pt
            )
        }
    }
}

GrowthCatAdBannerView(
    placementKey: "home_banner",
    appUserID: currentUser.id,
    minHeight: 60
) {
    // Called after the click event fires.
    // The SDK handles destination_type "url" and "app_store_app" automatically.
    print("Banner tapped")
}

import SwiftUI
import GrowthCat

struct LevelCompleteView: View {
    @State private var showInterstitial = false

    var body: some View {
        VStack {
            Text("Level Complete!")
            Button("Continue") {
                showInterstitial = true
            }
        }
        .overlay(
            GrowthCatAdView(
                placementKey: "level_complete_interstitial",
                appUserID: "user_123",
                isPresented: $showInterstitial,
                onDismiss: { showInterstitial = false }
            )
        )
    }
}

import SwiftUI
import GrowthCat

struct CoinStoreView: View {
    @State private var showRewardedAd = false
    @State private var coins: Int = 0

    var body: some View {
        VStack(spacing: 24) {
            Text("You have \(coins) coins")
                .font(.title)

            Button("Watch ad to earn 50 coins") {
                showRewardedAd = true
            }
            .buttonStyle(.borderedProminent)
        }
        .overlay(
            GrowthCatAdView(
                placementKey: "rewarded_coins",
                appUserID: "user_123",            // REQUIRED for rewarded ads
                isPresented: $showRewardedAd,
                onReward: { response in
                    // Only called when reward_validated == true from the server.
                    // response.reward contains { name: "Coins", amount: 50 }
                    coins += Int(response.reward?.amount ?? 0)
                    showRewardedAd = false
                },
                onDismiss: {
                    showRewardedAd = false
                }
            )
        )
    }
}

GrowthCatAdView(
    placementKey: "app_store_promo",
    appUserID: "user_123",
    isPresented: $showAppStoreAd,
    onDismiss: { showAppStoreAd = false }
)

do {
    let response = try await GrowthCat.shared.validateAdReward(
        for: ad,
        appUserID: "user_123",       // required
        sessionID: currentSessionID,
        viewedSeconds: 30,           // actual elapsed seconds the user viewed
        completed: true              // true if video played to end
    )

    if response.rewardValidated {
        let reward = response.reward
        print("Reward: \(reward?.amount ?? 0) \(reward?.name ?? "")")
        grantReward()
    }
} catch {
    // Network unavailable or server error — do NOT grant the reward.
    // The user must watch the ad again when online.
    print("Reward validation failed: \(error)")
}

Task {
    await GrowthCat.shared.flushAdEvents()
}

GET /v1/sdk/apps/:appId/ads/catalog?placement_key=home_banner

{
  "placement_key": "home_banner",
  "cache_ttl_seconds": 300,
  "media_cache_ttl_seconds": 604800,
  "ads": [
    {
      "creative": {
        "id": "uuid",
        "creative_type": "video",
        "public_asset_url": "https://media.example.com/ads/...",
        "asset_cache": {
          "cacheable": true,
          "ttl_seconds": 604800,
          "strategy": "prefetch"
        }
      }
    }
  ]
}

import SwiftUI
import GrowthCat

@main
struct MyApp: App {
    @Environment(\.scenePhase) private var scenePhase

    var body: some Scene {
        WindowGroup { ContentView() }
            .onChange(of: scenePhase) { _, newPhase in
                if newPhase == .active {
                    GrowthCat.shared.prefetchAdCatalogs(placementKeys: [
                        "home_banner",
                        "level_complete_interstitial",
                        "rewarded_coins"
                    ])
                }
            }
    }
}

.onChange(of: scenePhase) { _, newPhase in
    if newPhase == .background {
        Task { await GrowthCat.shared.flushAdEvents() }
    }
}

func applicationDidEnterBackground(_ application: UIApplication) {
    let task = application.beginBackgroundTask(withName: "GrowthCatFlush")
    Task {
        await GrowthCat.shared.flushAdEvents()
        application.endBackgroundTask(task)
    }
}

do {
    let ad = try await GrowthCat.shared.loadAd(placementKey: "home_banner")
    // ad == nil → no fill. ad != nil → ready to show.
} catch GrowthCatError.unauthorized {
    // SDK key is wrong. Check your dashboard configuration.
} catch GrowthCatError.network {
    // No connectivity. The catalog cache will be used if still valid.
} catch GrowthCatError.rateLimited(let retryAfter) {
    // Respect the retry-after interval before attempting again.
    print("Retry after \(retryAfter ?? 60)s")
} catch {
    print("Unexpected error: \(error)")
}