The Customer Data Platform for Developers

Website · Documentation · Community Slack

---

Integrating RudderStack iOS SDK with Facebook App Events

This repository contains the resources and assets required to integrate the RudderStack iOS SDK with Facebook App Events.

For more information on configuring Facebook App Events as a destination in RudderStack and the supported events and their mappings, refer to the Facebook App Events documentation.

Important: This device mode integration is supported for Facebook App Events v13.0.0 and above.

Step 1: Integrate the SDK with Facebook App Events

1. Add Facebook App Events as a destination in the RudderStack dashboard.
2. RudderFacebookAppEvents is available through CocoaPods. To install it, add the following line to your Podfile:

pod 'RudderFacebookAppEvents', '~> 1.2.0'

3. Run the pod install command.

Step 2: Import the SDK

Swift

import RudderFacebookAppEvents

Objective C

@import RudderFacebookAppEvents;

Step 3: Initialize the RudderStack client (RSClient)

Place the following in your AppDelegate under the didFinishLaunchingWithOptions method.

Swift

let config: RSConfig = RSConfig(writeKey: WRITE_KEY)
            .dataPlaneURL(DATA_PLANE_URL)       
             
RSClient.sharedInstance().configure(with: config)
RSClient.sharedInstance().addDestination(RudderFacebookAppEventsDestination())

Objective C

RSConfig *config = [[RSConfig alloc] initWithWriteKey:WRITE_KEY];
[config dataPlaneURL:DATA_PLANE_URL];

[[RSClient sharedInstance] configureWith:config];
[[RSClient sharedInstance] addDestination:[[RudderFacebookAppEventsDestination alloc] init]];

Step 4: Send events

Follow the steps listed in the RudderStack iOS SDK repo to start sending events to Facebook App Events.

About RudderStack

RudderStack is the customer data platform for developers. With RudderStack, you can build and deploy efficient pipelines that collect customer data from every app, website, and SaaS platform, then activate your data in your warehouse, business, and marketing tools.

Start building a better, warehouse-first CDP that delivers complete, unified data to every part of your customer data stack. Sign up for RudderStack Cloud today.

Contact us

For queries on configuring or using this integration, start a conversation in our Slack community.