Skip to content

iOS SDK: Test your integration

  1. On Apps and SDK, select your app. Connection check shows Waiting for first upload once the app has an upload key.
  2. Build and run your app with the SDK on an iPhone or simulator (iOS 17 or higher).
  3. Make sure your code calls Ad80.setConsent(true) (after your consent flow).
  4. Open a screen that shows an ad and leave the ad fully visible for a few seconds.
  5. 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.

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.

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 Ad80
import 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)
EventMeaning
initializedThe 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.
adMobUnavailableAd80.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).
OutcomeMeaning
CAPTUREDThe ad was captured.
SKIPPED_NO_CONSENT, SKIPPED_DISABLED, SKIPPED_BACKGROUNDNo consent, SDK disabled, or the app is in the background.
SKIPPED_NOT_VISIBLE, SKIPPED_PARTIALLY_VISIBLE, SKIPPED_OCCLUDEDThe ad is hidden, clipped, or covered by another view or window.
SKIPPED_NO_WINDOW_FOCUSThe view’s scene is not foregroundActive (app switcher, Notification Centre, an incoming-call banner). Retried when the scene is active.
SKIPPED_VISIBILITY_UNVERIFIEDA transform, a raised layer, an animation or unstable geometry: the SDK could not prove the ad is visible.
SKIPPED_NOT_LAID_OUTEmpty bounds, or single-colour or transparent pixels: the ad is not rendered yet.
SKIPPED_UNCHANGED, SKIPPED_RATE_LIMITEDNothing new to capture (same creative within 24 hours), or captures are being throttled.
ATTRIBUTION_PENDINGWaiting briefly for the network attribution.
DISCARDED_GEOMETRY_CHANGEDThe view moved or resized during capture; normal while scrolling.
SKIPPED_NOT_SETTLEDBanner or native: no stable frame yet. Full-screen: the show ended before a usable picture was available.
FAILED_CAPTUREThe renderer returned no image. Report it with the device and iOS version.
UNSUPPORTED_LAYER_CONTENTThe capture holds content the method cannot read, shown as transparent pixels (video on a real device). No image is uploaded.
UNSUPPORTED_SECURE_CONTENTReserved; not emitted by SDK 1.0.0.
REJECTED_TOO_LARGE, REJECTED_SIZE_MISMATCHThe image was over the size limit, or its size differs from the view’s.
SKIPPED_FULLSCREEN_NOT_TRACKEDA Google full-screen ad was presented without a matching Ad80.trackFullScreenAd call. A diagnostic only; never an image.
SKIPPED_FULLSCREEN_AMBIGUOUSThe tracked show could not be tied to exactly one ad (two ads tracked or shown at once). No image.
SKIPPED_FULLSCREEN_DISABLEDFull-screen capture is switched off in the remote configuration.