Swift SDK Integration

This SDK is developed in Swift and supports integration with Swift Package Manager (SPM). For new projects, we recommend integrating the Netmera Swift SDK to optimize functionality and streamline development.

Onboarding Checklist: Swift

Below is the Onboarding Checklist for Swift and Flutter. Follow each item in the list to ensure all essential steps in your Netmera onboarding process are completed successfully.

How to Integrate Netmera Swift SDK: A Complete Video Guide

Step 1: Create an Apple Push Notification Certificate

To enable push notifications, Netmera uses APNS (Apple Push Notification Service). Follow these steps to create and upload the required certificate:

1. Log in to developer.apple.com with your Apple Developer account.

2. Generate an Apple Push Notification Certificate for your app.

3. Export the certificate using Keychain Access on your Mac.

4. Upload the exported certificate to the Netmera panel by navigating to Developer > Push Backends > iOS in the left menu.

Creating an APNS .p8 Certificate (Recommended)

Creating an APNS .p12 Certificate

Step 2: Integrate SDK into Your Project

You can integrate the Netmera SDK into your project using either Cocoapods or Swift Package Manager (SPM). Follow the instructions for your chosen method.

Option 1: Integrating with Cocoapods

1. Open your project's Podfile and add the relevant lines for the Netmera features you need:

pod "NetmeraAnalytic" // to use Netmera analytic features
pod "NetmeraAnalyticAutotracking" // to use auto tracking features
pod "NetmeraNotification" // to use Netmera push notification features
pod "NetmeraAdvertisingId" // to use Netmera advertising identifier features
pod "NetmeraLocation" // to use Netmera location features
pod "NetmeraGeofence" // to use Netmera geofence features
pod "NetmeraNotificationInbox" // to use Netmera push inbox features

1. Run pod install command in your terminal.

pod install

Option 2: Integrating with Swift Package Manager (SPM)

1. Open Project Settings and navigate to Package Dependencies. Click the "+" button to add a new dependency.

1. Enter the following repository URL in the search bar. The package details will load automatically.

https://github.com/Netmera/swift-sdk

1. Click "Add Package" to complete the integration.

Step 3: Setup Netmera

Import the Netmera Framework

In your AppDelegate.swift file, import the necessary Netmera modules based on the features you plan to use:

import NetmeraAnalytic
import NetmeraNotification
import NetmeraLocation
import NetmeraNotificationInbox
import NetmeraAdvertisingId

Initialize Netmera

1. Configure with Netmera Plist

1. Add the Netmera-Config.plist file to your project.

2. Replace the placeholders ({API_KEY}, {AppGroupName}, etc.) in the following code snippet with your actual values:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>sdk_params</key>
    <dict>
        <key>app_group_name</key>
        <string>{AppGroupName}</string>
        <key>use_ui_scene</key>
        <false/>
        <key>api_key</key>
        <string>{API_KEY}</string>
        <key>custom_events</key>
        <array>
            <string>{YourCustomEvent}</string>
        </array>
    </dict>
    <key>location_max_active_region</key>
    <string></string>
    <key>in_app_message_settings</key>
    <dict>
        <key>TextColor</key>
        <string>{hexcolor. For ex-&gt; 16777215}</string>
        <key>TitleColor</key>
        <string>{hexcolor. For ex-&gt; 16777215}</string>
        <key>BackgroundColor</key>
        <string>{hexcolor. For ex-&gt; 16777215}</string>
        <key>CancelButtonBackgroundColor</key>
        <string>{hexcolor. For ex-&gt; 16777215}</string>
        <key>TitleFont</key>
        <string>{font family name. ex -&gt; ariel}</string>
        <key>TextFont</key>
        <string>{font family name. ex -&gt; ariel}</string>
        <key>CancelButtonRadius</key>
        <string>{10 sd px}</string>
        <key>ShadowOpacity</key>
        <string>{0-1}</string>
        <key>BottomPaddingRatio</key>
        <string>{between 0.01 - 1}</string>
        <key>CancelButtonImage</key>
        <string>{imagename}</string>
    </dict>
    <key>blacklist_screen_names</key>
    <array/>
</dict>
</plist>

Additional Configuration for On-Premises Customers

If you are using Netmera in an on-premises environment, include the following in your Netmera-Config.plist:

<key>base_url</key>
<string>{BaseURL}</string

2. Initialize Netmera

Call the Netmera initialization method in your application(_:didFinishLaunchingWithOptions:) method:

Netmera.initialize()  
Netmera.setLogLevel(.debug) // Options: .debug, .info, .error, .fault  
// Use .debug mode to view detailed Netmera logs

Step 4: Request Push Notification Authorization

1. Add NetmeraNotification to Your Podfile

To enable push notifications, add the following line to your Podfile and install it for your app target:

pod "NetmeraNotification"

Run the following command in your terminal to install:

pod install

2. Request Push Notification Authorization

Request push notification permission from the user by calling the following method in an appropriate place in your code:

Netmera.requestPushNotificationAuthorization(for: [.alert, .badge, .sound])

Step 5: Enable Push Notifications

1. Enable Push Notifications in Xcode

To enable push notifications for your app, follow these steps:

• Open your Xcode project.

• Navigate to Signing & Capabilities.

• Under Capability, select Push Notifications.

2. Implement UNUserNotificationCenterDelegate Methods

In your AppDelegate, you need to implement the necessary methods for handling push notifications. Add the following code to your didFinishLaunchingWithOptions method:

// Set the delegate for the notification center
UNUserNotificationCenter.current().delegate = self

Then, implement the following delegate methods to handle the push notifications:

// Handle notification when the app is in the foreground
func userNotificationCenter(_ center: UNUserNotificationCenter, willPresent notification: UNNotification, withCompletionHandler completionHandler: @escaping (UNNotificationPresentationOptions) -> Void) {
    //
}

// Handle user interaction with notifications
func userNotificationCenter(_ center: UNUserNotificationCenter, didReceive response: UNNotificationResponse, withCompletionHandler completionHandler: @escaping () -> Void) {
    //
}

Configuring Multiple Environments

If you want to configure multiple environments for your app (e.g., testing and production), follow the steps below:

Step 1: Copy Netmera-Config.plist Files

1. Copy the Netmera-Config.plist file for the development environment into the Dev directory.

2. Copy the Netmera-Config.plist file for the production environment into the Prod directory.

3. When adding these files to your Xcode project, uncheck Copy items if needed and ensure that no targets are selected under Add to targets.

Step 2: Add Run Script Phase

1. In Xcode, select your app target.

2. Go to the Build Phases tab and add a New Run Script Phase.

3. Name the new phase something like "Setup Netmera Environment Netmera-Config.plist".

4. Position this phase before the Copy Bundle Resources step.

Step 3: Implement Shell Script for Config File Selection

In the new Run Script Phase, implement the following shell script to copy the correct Netmera-Config.plist based on the build configuration (Debug or Release):

The following script checks if the development and production versions of Netmera-Config.plist exist in their respective directories, and based on the build configuration (Debug or Release), it will copy the correct configuration file into the app bundle.

# Name of the resource we're selectively copying
NETMERA_CONFIG_PLIST=Netmera-Config.plist

# Get references to dev and prod versions of the Netmera-Config.plist
# NOTE: These should only live on the file system and should NOT be part of the target (since we'll be adding them to the target manually)
NETMERA_CONFIG_DEV=${PROJECT_DIR}/${TARGET_NAME}/NetmeraConfig/Dev/${NETMERA_CONFIG_PLIST}
NETMERA_CONFIG_PROD=${PROJECT_DIR}/${TARGET_NAME}/NetmeraConfig/Prod/${NETMERA_CONFIG_PLIST}

# Make sure the dev version of Netmera-Config.plist exists
echo "Looking for ${NETMERA_CONFIG_PLIST} in ${NETMERA_CONFIG_DEV}"
if [ ! -f $NETMERA_CONFIG_DEV ]
then
    echo "No Development Netmera-Config.plist found. Please ensure it's in the proper directory."
    exit 1
fi

# Make sure the prod version of Netmera-Config.plist exists
echo "Looking for ${NETMERA_CONFIG_PLIST} in ${NETMERA_CONFIG_PROD}"
if [ ! -f $NETMERA_CONFIG_PROD ]
then
    echo "No Production Netmera-Config.plist found. Please ensure it's in the proper directory."
    exit 1
fi

# Get a reference to the destination location for the Netmera-Config.plist
PLIST_DESTINATION=${BUILT_PRODUCTS_DIR}/${PRODUCT_NAME}.app
echo "Will copy ${NETMERA_CONFIG_PLIST} to final destination: ${PLIST_DESTINATION}"

# Copy over the prod Netmera-Config.plist for Release builds
if [ "${CONFIGURATION}" == "Release" ]
then
    echo "Using ${NETMERA_CONFIG_PROD}"
    cp "${NETMERA_CONFIG_PROD}" "${PLIST_DESTINATION}"
else
    echo "Using ${NETMERA_CONFIG_DEV}"
    cp "${NETMERA_CONFIG_DEV}" "${PLIST_DESTINATION}"
fi

Swift SDK Integration Complete 🎉

The Swift SDK integration is complete, and your devices are now ready to receive the following types of push notifications from the Netmera Dashboard:

1. Standard Push Notifications

2. Interactive Push Notifications

3. Widgets

4. Push Notifications with Deeplinks