Facebook Ads

With the Facebook Ads integration, you can easily check your app stats in Meta Analytics. Adapty sends events to Meta Ads Manager, helping you make similar audiences based on subscriptions to get better returns. This way, you can accurately see how much money your ads are making from subscriptions.

The integration between Adapty and Facebook Ads operates in the following way: Adapty sends all subscription events that are configured in your integration to Facebook Ads. This integration is beneficial for evaluating the effectiveness of your advertising campaigns.

How to set up Facebook Ads integration

To integrate Facebook Ads and analyze your app metrics, you can set up the integration with Meta Analytics. By sending events to Meta Ads Manager, you can create lookalike audiences based on subscription events like renewals. To configure this integration, navigate to Integrations > Facebook Ads in the Adapty Dashboard and provide the required credentials.

note

Please consider that the Facebook Ads integration works on iOS 14.5+ only for users with ATT consent.

1. To find App ID, open your app page in App Store Connect, go to the App Information page in General section, and find Apple ID in the left bottom part of the screen.
2. You need an application on Meta for Developers platform. Log in to your app and then find advanced settings. You can find the App ID in the header.

3. Disable client-side tracking in your Meta SDK configuration to prevent double counting of revenue in Meta Ads Manager. You can find this setting in your Meta Developer Console under App Settings > Advanced Settings. Set Log in-app events automatically to "No". This will ensure that revenue events are only tracked through Adapty's integration.

   To track install and usage events, you'll need to activate Meta SDK in your code. You can find implementation details in the Meta SDK documentation for your platform:

   • iOS SDK
   • Android SDK
   • Unity SDK

You can use this integration with Android apps as well. If you set up Android SDK configuration in the App Settings, setting up the Facebook App ID is enough.

Events and tags

Please note that the Facebook Ads integration specifically caters to companies using Meta for ad campaigns and optimizing them based on customer behavior. It supports Meta's standard events for optimization purposes. Consequently, modifying the event name is not available for the Meta Ads integration. Adapty effectively maps your customer events to their corresponding Meta events for accurate analysis.

Adapty event	Meta Ads event
Subscription initial purchase	Subscribe
Subscription renewed	Subscribe
Subscription cancelled	CancelSubscription
Trial started	StartTrial
Trial converted	Subscribe
Trial cancelled	CancelTrial
Non subscription purchase	fb_mobile_purchase
Billing issue detected	billing_issue_detected
Entered grace period	entered_grace_period
Auto renew off	auto_renew_off
Auto renew on	auto_renew_on
Auto renew off subscription	auto_renew_off_subscription
Auto renew on subscription	auto_renew_on_subscription

StartTrial, Subscribe, CancelSubscription are standard events.

To enable specific events, simply toggle on the ones you require. In case multiple event names are selected, Adapty will consolidate the data from all the chosen events into a single Adapty event name.

SDK configuration

warning

Because of iOS IDFA changes in iOS 14.5, if you use Meta integration, make sure you send facebookAnonymousId to Adapty via .setIntegrationIdentifier() method. It helps Meta attribute users better.

iOS (Swift)

import FacebookCore

do {
    try await Adapty.setIntegrationIdentifier(
        key: "facebook_anonymous_id", 
        value: AppEvents.shared.anonymousID
    )
} catch {
    // handle the error
}

Android (Kotlin)

Adapty.setIntegrationIdentifier(
    "facebook_anonymous_id",
    AppEventsLogger.getAnonymousAppDeviceGUID(context)
) { error ->
    if (error != null) {
        // handle the error
    }
}

Flutter (Dart)

There is no official SDK for Flutter

Unity (C#)

anonymousID is not available in the official SDK
https://github.com/facebook/facebook-sdk-for-unity/issues/676

React Native (TS)

import { adapty } from 'react-native-adapty';
import { AppEventsLogger } from 'react-native-fbsdk-next';

try {
  const anonymousId = await AppEventsLogger.getAnonymousID();

  await adapty.setIntegrationIdentifier("facebook_anonymous_id", anonymousId);
} catch (error) {
  // handle `AdaptyError`
}