The AEP Content Analytics mobile extension tracks content and experience interactions in iOS apps. It batches events for efficiency, persists them to disk to survive crashes, and can optionally send data to an ML featurization service.

Requires AEPCore, AEPServices, and AEPEdge extensions to send data to the Adobe Experience Platform Edge Network.

See the Adobe Experience Platform Content Analytics docs for more.

• Xcode 15 (or newer)
• Swift 5.1 (or newer)

These are currently the supported installation options:

# Podfile
use_frameworks!

# for app development, include all the following pods
target 'YOUR_TARGET_NAME' do
    pod 'AEPCore'
    pod 'AEPEdge'
    pod 'AEPEdgeIdentity'
    pod 'AEPContentAnalytics'
end

Replace YOUR_TARGET_NAME then run:

pod install

In Xcode, go to File > Add Packages... and enter:

https://github.com/adobe/aca-mobile-sdk-ios-extension.git

Select your desired version when prompted.

Alternatively, if your project has a Package.swift file, you can add AEPContentAnalytics directly to your dependencies:

dependencies: [
    .package(url: "https://github.com/adobe/aca-mobile-sdk-ios-extension.git", .upToNextMajor(from: "5.0.0"))
],
targets: [
    .target(name: "YourTarget",
            dependencies: ["AEPContentAnalytics"],
            path: "your/path")
]

To generate an AEPContentAnalytics.xcframework, run the following command:

$ make archive

This generates the xcframework under the build folder. Drag and drop all the .xcframeworks to your app target in Xcode.

First time setup:

make pod-install

Update dependencies later:

make pod-update

make open

make test

• Getting Started - Installation and basic setup
• API Reference - Complete API documentation
• Experience Tracking Guide - 🔥 Required reading for experience tracking
• Advanced Configuration - Batching, privacy, performance
• Troubleshooting - Common issues and solutions
• Crash Recovery - Persistent queuing and crash recovery

A demo application is available in the ContentAnalyticsDemoApp directory, integrated into the main workspace for easy testing and development.

Contributions are welcome! Please read CODE_OF_CONDUCT.md for details on our community standards, and follow standard GitHub flow for pull requests.

This project is licensed under the Apache License, Version 2.0. See LICENSE for more information.

Copyright 2025 Adobe. All rights reserved.