iOS SDK

image-20241107-055037.png

The full technical documentation lives here: iOS SDK Overview

This page is just a high-level overview to be used as a starting point; then follow through to the Developer Guide for integration details, APIs, and platform-specific setup.

The Zeta iOS SDK connects your iOS or iPadOS app to the Zeta Marketing Platform (ZMP). It provides a single integration for user identity, behavioral tracking, and message delivery across push, in-app messaging, and app inbox—all orchestrated from ZMP.

This documentation covers iOS SDK 1.0.0. Supported platforms: iOS / iPadOS 13.0+, Swift 5.10 (Swift 6 compatible), Xcode 15.3+.

What the iOS SDK provides

  • ZetaCore — Core SDK for configuration, user identity, event tracking, push tokens, in-app messages, and app inbox (required; add to your app target).

  • ZetaNotificationService — Rich push rendering and delivery tracking (optional; add only to a Notification Service Extension target).

  • Identity & events — Identify users, update contacts and properties, track location, and send auto-tracked and custom events.

  • Messaging channels — Push (APNs), in-app messaging, and a persistent app inbox your UI can query and display.


Use the following articles for the canonical, up-to-date iOS documentation. They are grouped in the order of a typical integration journey.

Set up and initialize

Topic

What you’ll find

Developer Guide

Overview

What the iOS SDK provides, requirements, modules, sizes, and the full integration journey.

iOS SDK Overview

Installation

Add ZetaKit via Swift Package Manager, CocoaPods, or prebuilt XCFrameworks; register your app with ZMP.

Installation

Getting started

Initialize with ZTConfig, configure region and environment, and manage opt-in / opt-out.

Getting started

Integrate core features

Topic

What you’ll find

Developer Guide

Contact management

Identify users, update email/phone contacts and custom properties, UCLID, location, and event tracking.

Contact management

Add messaging channels

Topic

What you’ll find

Developer Guide

Push notifications

APNs setup, device tokens, click attribution, deeplinks, rich media, and the Notification Service Extension.

Push notifications

In-app messaging

Foreground SDK-rendered messages, lifecycle delegates, campaign setup, and in-app email collection.

In-app messaging

App inbox

Fetch and query inbox messages, status updates, CTA handling, and building your own inbox UI (since 1.0.0).

App inbox

Prepare for release

Topic

What you’ll find

Developer Guide

API reference

Feature-grouped index of every public type the SDK exposes.

API reference

Changelog

API-level Added / Changed / Deprecated / Removed notes for each release.

Changelog

Data & privacy

PrivacyInfo.xcprivacy, ATT, GDPR/CCPA, offline queueing, and secrets handling.

Data & privacy

Versioning & support

SemVer policy, supported iOS/Xcode/Swift window, deprecation policy, and support channels.

Versioning & support

Advanced topics

Logging (ZTLogger), Swift 6 readiness, push troubleshooting, and testing & QA checklists.

Advanced topics