iOS SDK: Test your integration
The dashboard’s connection check
Section titled “The dashboard’s connection check”- On Apps and SDK, select your app. Connection check shows Waiting for first upload once the app has an upload key.
- Build and run your app with the SDK on an iPhone or simulator (iOS 17 or higher).
- Make sure your code calls
Ad80.setConsent(true)(after your consent flow). - Open a screen that shows an ad and leave the ad fully visible for a few seconds.
- The page checks every few seconds. When the first upload arrives it shows Receiving ads and Last upload …. The ad appears under Creatives soon after.
Google’s test ad units work: the SDK captures test ads like any other ad.
Debug logs
Section titled “Debug logs”The SDK defines no log tag or subsystem on iOS, so there is nothing to filter in the Xcode console. Use the diagnostics listener below: it reports everything the SDK does.
You can test in the simulator and on a real device. On a real device, video areas inside ads can be unreadable, see
UNSUPPORTED_LAYER_CONTENT below.
Diagnostics listener
Section titled “Diagnostics listener”Ad80.addDiagnosticsListener reports what the SDK does: initialization, discovery, capture outcomes, queueing and
upload results. Events arrive on an SDK background thread; return quickly. Diagnostics are informational, not proof
that an ad was stored.
import Ad80import Ad80Core
final class Ad80Log: Ad80DiagnosticsListener { // Called serially on an SDK queue, never on the main thread. Return quickly. func onEvent(_ event: Ad80Event) { switch event { case .configInvalid(let reason): print("AD80 config invalid: \(reason)") case .disabled(let reason): print("AD80 disabled: \(reason)") case .capture(let placementId, let outcome): print("AD80 capture \(placementId): \(outcome.rawValue)") case .uploadResult(_, _, let httpStatus, let willRetry): print("AD80 upload HTTP \(httpStatus.map(String.init) ?? "none"), retry=\(willRetry)") default: print("AD80 \(event)") } }}
let ad80Log = Ad80Log()Ad80.addDiagnosticsListener(ad80Log) // the SDK holds the listener strongly until you remove it// Later, for example when a debug screen goes away:Ad80.removeDiagnosticsListener(ad80Log)Events
Section titled “Events”| Event | Meaning |
|---|---|
initialized | The SDK started. |
configInvalid(reason:) | The Info.plist entries are missing or wrong (missing publisher key, missing endpoint, malformed endpoint, cleartext endpoint must be loopback, unsupported endpoint scheme). The SDK stays inert. |
adMobUnavailable | Ad80.start was called without the Google Mobile Ads integration; only registered views are observed. Reported once per process. |
disabled(reason:) | LOCAL (setEnabled(false)), REMOTE (remote configuration), INFO_PLIST (AD80Enabled is false) or CONSENT_REVOKED. |
discovered(placementId:source:) | An ad view was found, registered, or tracked as a full-screen ad (source is ADMOB_DISCOVERED, EXPLICIT or FULLSCREEN_TRACKED). |
discoveryTruncated(nodesVisited:) | A very large view tree was only partly searched. |
placementRemoved(placementId:) | An ad view went away. |
capture(placementId:outcome:) | The result of one capture attempt (see below). |
observationQueued(...) | An observation was queued, with its placement, content hash, network id, trigger and whether it carries the image. |
uploadResult(batchId:attempt:httpStatus:willRetry:) | The result of an upload attempt. httpStatus is nil after a network error. |
queueDropped(count:) | Queued observations were dropped (queue full or retries used up). |
Capture outcomes
Section titled “Capture outcomes”| Outcome | Meaning |
|---|---|
CAPTURED | The ad was captured. |
SKIPPED_NO_CONSENT, SKIPPED_DISABLED, SKIPPED_BACKGROUND | No consent, SDK disabled, or the app is in the background. |
SKIPPED_NOT_VISIBLE, SKIPPED_PARTIALLY_VISIBLE, SKIPPED_OCCLUDED | The ad is hidden, clipped, or covered by another view or window. |
SKIPPED_NO_WINDOW_FOCUS | The view’s scene is not foregroundActive (app switcher, Notification Centre, an incoming-call banner). Retried when the scene is active. |
SKIPPED_VISIBILITY_UNVERIFIED | A transform, a raised layer, an animation or unstable geometry: the SDK could not prove the ad is visible. |
SKIPPED_NOT_LAID_OUT | Empty bounds, or single-colour or transparent pixels: the ad is not rendered yet. |
SKIPPED_UNCHANGED, SKIPPED_RATE_LIMITED | Nothing new to capture (same creative within 24 hours), or captures are being throttled. |
ATTRIBUTION_PENDING | Waiting briefly for the network attribution. |
DISCARDED_GEOMETRY_CHANGED | The view moved or resized during capture; normal while scrolling. |
SKIPPED_NOT_SETTLED | Banner or native: no stable frame yet. Full-screen: the show ended before a usable picture was available. |
FAILED_CAPTURE | The renderer returned no image. Report it with the device and iOS version. |
UNSUPPORTED_LAYER_CONTENT | The capture holds content the method cannot read, shown as transparent pixels (video on a real device). No image is uploaded. |
UNSUPPORTED_SECURE_CONTENT | Reserved; not emitted by SDK 1.0.0. |
REJECTED_TOO_LARGE, REJECTED_SIZE_MISMATCH | The image was over the size limit, or its size differs from the view’s. |
SKIPPED_FULLSCREEN_NOT_TRACKED | A Google full-screen ad was presented without a matching Ad80.trackFullScreenAd call. A diagnostic only; never an image. |
SKIPPED_FULLSCREEN_AMBIGUOUS | The tracked show could not be tied to exactly one ad (two ads tracked or shown at once). No image. |
SKIPPED_FULLSCREEN_DISABLED | Full-screen capture is switched off in the remote configuration. |