Installation

Module	Contents	Required
QartveloAds	API client, config cache, rendering, event delivery, banner view	Yes
QartveloAdsAdMob	Fallback adapter for Google Mobile Ads (Google-Mobile-Ads-SDK 12.x)	Optional

Requirements

• iOS 13 or later, Xcode 16 or later, Swift 5.9
• QartveloAds has no third-party dependencies. Only QartveloAdsAdMob depends on Google Mobile Ads, as a normal dependency, so you control its exact version.

Add the package

Swift Package Manager is the recommended installation method. Xcode downloads the SDK, resolves its dependencies and manages version updates automatically.

Swift Package Manager

1. In Xcode, choose File > Add Package Dependencies.
2. Paste this repository URL:

https://github.com/Qartvelo-com/ads

3. Choose Up to Next Minor Version, starting from 0.6.1 (0.6.1..<0.7.0).
4. Click Add Package, select QartveloAds, and choose your app target.
5. Also select QartveloAdsAdMob if you want the AdMob fallback.

You can now use import QartveloAds. For later updates, choose File > Packages > Update to Latest Package Versions. The version rule keeps updates within the 0.6 series.

In a Package.swift:

Package.swift

dependencies: [
    .package(url: "https://github.com/Qartvelo-com/ads", .upToNextMinor(from: "0.6.1")),
],
targets: [
    .target(name: "MyApp", dependencies: [
        .product(name: "QartveloAds", package: "ads"),
        .product(name: "QartveloAdsAdMob", package: "ads"), // optional
    ]),
]

CocoaPods

Install directly from the published Git tag. The native pods are not currently published to CocoaPods trunk, so use the Git source below rather than a trunk-only version declaration.

Podfile

platform :ios, '13.0'
use_frameworks! :linkage => :static

target 'MyApp' do
  pod 'QartveloAds', :git => 'https://github.com/Qartvelo-com/ads.git', :tag => '0.6.1'
  pod 'QartveloAdsAdMob', :git => 'https://github.com/Qartvelo-com/ads.git', :tag => '0.6.1' # optional
end

Run pod install, then open the generated .xcworkspace in Xcode.

For SDK development from a checkout, use Add Local and select its ios folder. The repository root manifest exposes the same products for installation by URL.

Register the AdMob adapter

With QartveloAdsAdMob, register the adapter once, before initialize:

import QartveloAds
import QartveloAdsAdMob

QartveloAds.registerFallbackAdapter(QartveloAdMobFallbackAdapter())

Without the adapter the SDK works normally and reports qartveloAdNoAdAvailable when Qartvelo Ads has no ad.

Note

The adapter can also be found automatically when the app links with -ObjC (CocoaPods adds it), but registering it explicitly always works, also with Swift Package Manager.

Info.plist

Qartvelo Ads needs nothing in Info.plist, and it never uses the advertising identifier (IDFA), so there is no App Tracking Transparency prompt for Qartvelo Ads.

If you include the AdMob adapter, Google requires your own AdMob app ID, or the Google Mobile Ads SDK stops the app at start-up:

Info.plist

<key>GADApplicationIdentifier</key>
<string>ca-app-pub-XXXXXXXXXXXXXXXX~YYYYYYYYYY</string>

For development you can use Google’s sample app ID ca-app-pub-3940256099942544~1458002511. Google also asks for its SKAdNetworkItems list; see Google’s iOS quick start.

Privacy manifest

QartveloAds ships a PrivacyInfo.xcprivacy: no tracking, no tracking domains, “advertising data” (the ads shown and tapped) not linked to the user, and the required-reason APIs it uses (UserDefaults for the cached configuration, system uptime for timeouts, file timestamps for the creative cache). Xcode merges it into your app’s privacy report.

Register the app

In the publisher dashboard, add the app with platform iOS and its bundle ID (for example ge.example.Game). If your Android app uses the same ID as its applicationId, choose Android and iOS instead: both apps then share one app key and one set of placements. An app key only works for the platforms and the ID it was registered with, so an Android app with a different ID is a separate app in the dashboard.

Local backend (optional)

If you run your own Qartvelo Ads backend for development, the iOS Simulator reaches your Mac at http://localhost:8000/. Set options.baseURL and allow plain HTTP for that host in debug builds only (NSAppTransportSecurity > NSExceptionDomains > localhost > NSExceptionAllowsInsecureHTTPLoads). Production always uses HTTPS (https://ads.qartvelo.com/, the default).

Next: Initialization.