Command Dispatcher that routes Tealium Prism tracking events to the Firebase Analytics iOS SDK — events, user properties, consent settings, and more.

Important: Firebase Analytics only supports a single shared instance. Only one firebaseDispatcher can be active at a time in your app.

1. In Xcode, select File > Add Package Dependencies.
2. Enter the repository URL: https://github.com/Tealium/tealium-prism-ios-firebase-dispatcher
3. Configure the version rules. Up to Next Major is recommended.
4. Select TealiumPrismFirebase and add it to your app target.

Or add it manually to Package.swift:

.package(url: "https://github.com/Tealium/tealium-prism-ios-firebase-dispatcher.git", from: "0.1.0")

Add the following line to your Podfile:

pod 'TealiumPrismFirebase'

Place GoogleService-Info.plist in the app target root. The Firebase Dispatcher calls FirebaseApp.configure() automatically on first use. If you need custom initialization order (e.g. for Crashlytics), call FirebaseApp.configure() manually — add import FirebaseCore to your app entry point and call it before Tealium.create(config:). The dispatcher will detect the existing FirebaseApp and skip its own initialization.

To run the example project, clone the repo and open Example/Example.xcodeproj in Xcode. Add a real GoogleService-Info.plist and run the Example scheme.

The example app demonstrates:

• Automatic and manual Firebase initialization approaches
• Every Firebase command with real-world use cases
• Purchase events with items and custom parameters
• User ID and user property management
• Consent settings (grant/deny all)
• On-device conversion measurement with plaintext and hashed credentials

Register the Firebase Dispatcher when initializing Tealium Prism:

import TealiumPrismCore
import TealiumPrismFirebase

let config = TealiumConfig(
    account: "my_account",
    profile: "my_profile",
    environment: "prod",
    modules: [
        Modules.collect(),
        Modules.firebaseDispatcher(),
    ],
    settingsFile: "TealiumSettings"
)
let tealium = Tealium.create(config: config)

The Firebase Dispatcher can be configured via a local JSON settings file, remote settings, or programmatically.

If a setting is omitted, Firebase uses its own default value.

Note: JSON log_level strings map 1:1 onto FirebaseLoggerLevel cases (e.g. "min" → .min, "debug" → .debug). The reverse is not one-to-one: Firebase defines .min and .error with the same underlying value, as it does .max and .debug, so setLogLevel(.min) persists as "error" and setLogLevel(.max) as "debug". The effect on Firebase is identical.

Configure the module in your TealiumSettings.json file:

{
    "modules": {
        "FirebaseDispatcher": {
            "module_type": "FirebaseDispatcher",
            "configuration": {
                "session_timeout_seconds": 1800,
                "analytics_collection_enabled": true,
                "log_level": "debug"
            }
        }
    }
}

Use FirebaseSettingsBuilder to enforce settings that cannot be overridden remotely:

Modules.firebaseDispatcher(forcingSettings: { builder in
    builder
        .setSessionTimeout(30.minutes)
        .setAnalyticsEnabled(true)
        .setLogLevel(.min)
})

Note: Programmatic settings always take precedence over local and remote settings. Only use them for values that must never be changed remotely.

FirebaseSettingsBuilder extends DispatcherSettingsBuilder<FirebaseMappings> and provides these methods:

The Firebase Dispatcher routes dispatch data to Firebase using the Tealium Prism Mappings system, and each command has its own guide covering the JSON and programmatic mapping configuration, payload shapes, and error behaviour. Start with Mappings for the concepts shared by all commands — command_name binding, destinations, and the JSON mapping schema.

The same guides are published alongside the generated API reference at tealium.github.io/tealium-prism-ios-firebase-dispatcher.

See the Example app's TealiumSettings.json for a complete configuration covering all commands.

Generated documentation for the public API is published at tealium.github.io/tealium-prism-ios-firebase-dispatcher.

Build it locally with:

bundle install
./scripts/docs.sh

Output lands in _site.

TealiumPrismFirebase is available under a commercial license. See the LICENSE file for more info.