iOS Application Pixel Integration

To set up Bloomreach pixels in your native iOS application, follow the steps below:

1. Add the SDK dependency package

The first step is to add the dependency package that contains the Bloomreach pixels for the iOS client library.
To add the dependency, follow these steps:

1. Click on “Add Packages” from the File menu of Xcode.

2. Paste the framework's GitHub URL in the search box: https://github.com/bloomreach/discovery-ios-sdk

3. Click on discovery-ios-sdk, select the main branch, and add the package to the appropriate project.

2. Initialization

To initialize the Discovery Pixel SDK in your app, first import the discovery_ios_sdk module in your UIApplicationDelegate:

import discovery_ios_sdk

Then initialize the Discovery SDK in your app delegate's application(_:didFinishLaunchingWithOptions:) method as shown:

class AppDelegate: NSObject, UIApplicationDelegate {
  func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey : Any]? = nil) -> Bool {
    let brPixel = BrPixel(
        accountId: "<ACCOUND_ID>",
        uuid: “<13_digit_random_number>”,
        visitorType: VisitorType.NEW_USER,
        baseUrl: "http://bloomique.com/")

        PixelTracker.shared.intialise(brPixel: brPixel)       
    
        return true
  }
}

If you are using SwiftUI, use the UIApplicationDelegateAdaptor property wrapper to tell SwiftUI it should use your AppDelegate class for the application delegate.

@main
struct MyApp: App {
    @UIApplicationDelegateAdaptor(AppDelegate.self) var appDelegate

    var body: some Scene {
        WindowGroup {
            ContentView()
        }
    }
}

Make sure to replace all the placeholder values for the parameter values in the snippet above.


Here is a reference of all the different parameters you can set based on your requirements:

📘

The value of any of the above parameters can be modified later in the code, even after initialization. It can be done by using the following line:

PixelTracker.shared.brPixel.<FIELD_NAME> = <VALUE>

3. Triggering Pixels

Refer to the following guides to Trigger specific pixels in your Android Application:

• Page View Pixels

• Event Pixels

• Widget Pixels

4. Pixel validation

You can test the integration of the Pixel SDK using the Pixel validator built inside the SDK. No additional integration is needed.
The Pixel validator only works in debug mode. The response from Pixel validation will be printed in Logs of xCode, as below: