Facebook Ads

Grâce à l’intégration Facebook Ads, vous pouvez facilement consulter les statistiques de votre application dans Meta Analytics. Adapty envoie des événements à Meta Ads Manager, vous permettant de créer des audiences similaires basées sur les abonnements pour de meilleurs rendements. Vous pouvez ainsi mesurer précisément les revenus générés par vos abonnements.

L’intégration entre Adapty et Facebook Ads fonctionne de la façon suivante : Adapty envoie à Facebook Ads tous les événements d’abonnement configurés dans votre intégration. Cette intégration est utile pour évaluer l’efficacité de vos campagnes publicitaires.

Configurer l’intégration

Connecter Adapty à Facebook Ads

Pour intégrer Facebook Ads et analyser les métriques de votre application, vous pouvez configurer l’intégration avec Meta Analytics. En envoyant des événements à Meta Ads Manager, vous pouvez créer des audiences similaires basées sur des événements d’abonnement comme les renouvellements. Pour configurer cette intégration, rendez-vous dans Integrations > Facebook Ads dans l’Adapty Dashboard et renseignez les identifiants requis.

1. Pour trouver l’App ID, ouvrez la page de votre application dans App Store Connect, rendez-vous sur la page App Information dans la section General, puis repérez Apple ID en bas à gauche de l’écran.
2. Vous avez besoin d’une application sur la plateforme Meta for Developers. Connectez-vous à votre application, puis accédez aux paramètres avancés. Vous trouverez l’App ID dans l’en-tête.

3. Désactivez le suivi côté client dans la configuration de votre SDK Meta pour éviter les doubles comptages de revenus dans Meta Ads Manager. Vous trouverez ce paramètre dans votre Meta Developer Console sous App Settings > Advanced Settings. Réglez Log in-app events automatically sur « No ». Cela garantit que les événements de revenus sont uniquement suivis via l’intégration d’Adapty.

Pour suivre les événements d’installation et d’utilisation, vous devez activer le SDK Meta dans votre code. Vous trouverez les détails d’implémentation dans la documentation du SDK Meta pour votre plateforme :

• SDK iOS
• SDK Android
• SDK Unity

Vous pouvez également utiliser cette intégration avec les applications Android. Si vous avez configuré le SDK Android dans les App Settings, il suffit de renseigner le Facebook App ID.

Configurer les événements et les tags

Adapty associe ses événements d’achat aux événements standard de Meta, que Meta peut utiliser pour optimiser ses campagnes : StartTrial, Subscribe et fb_mobile_purchase, l’événement d’achat de Meta. Subscription started, Subscription renewed, Trial started et Trial converted envoient chacun un événement Meta pour chaque nom sélectionné dans le champ de l’événement, et tous les noms sont sélectionnés par défaut. Un début d’essai, par exemple, génère trois événements Meta. Pour en envoyer moins, retirez des noms du champ.

Meta ne dispose pas d’événement standard pour les événements restants, donc Adapty les envoie en tant qu’événements personnalisés sous leurs noms Adapty. Pour utiliser votre propre nommage, modifiez le nom dans le champ de l’événement.

Trial still active et Subscription still active sont des événements synthétiques : Adapty les envoie à Meta selon un minuteur, et uniquement si l’essai ou l’abonnement est toujours en cours à l’expiration du minuteur. Ils ne portent aucun revenu, donc Meta ne les comptabilise pas dans la valeur des achats. Tous deux sont désactivés par défaut. Pour les envoyer, activez-les et définissez le délai.

Connectez votre application à Facebook Ads

Si vous suivez les étapes ci-dessus, Facebook recevra automatiquement les données d’abonnement en provenance d’Adapty.

Suite aux modifications apportées à l’IDFA dans iOS 14.5, nous vous recommandons de demander le facebookAnonymousId de l’utilisateur auprès de Facebook. Ainsi, si l’IDFA de l’utilisateur est indisponible, l’intégration continuera de fonctionner. Suivez le guide de configuration des attributs utilisateur iOS, Android, React Native, Flutter, et Unity pour définir ce paramètre.

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

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

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

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

There is no official SDK for Flutter

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

Structure des événements

Adapty envoie des événements à Facebook Ads (Meta) via l’API Graph. Chaque événement est structuré comme suit :

{
  "event": "CUSTOM_APP_EVENTS",
  "app_user_id": "user_12345",
  "advertiser_id": "00000000-0000-0000-0000-000000000000",
  "advertiser_tracking_enabled": 1,
  "application_tracking_enabled": 1,
  "custom_events": "[{\"_eventName\":\"Subscribe\",\"_logTime\":1709294400,\"fb_num_items\":1,\"fb_content_type\":\"in_app\",\"fb_content_id\":\"yearly.premium.6999\",\"fb_currency\":\"USD\",\"fb_order_id\":\"GPA.3383...\",\"fb_transaction_id\":\"GPA.3383...\",\"_valueToSum\":9.99}]",
  "extinfo": "[\"i2\",\"com.example.app\",\"1.0.0\",\"100\",\"17.0.1\",\"iPhone14,3\",\"en_US\",\"GMT+3\",\"\",0,0,0,0,0,0,\"GMT+3\"]",
  "anon_id": "facebook_anon_id_123"
}

Where:

Le paramètre custom_events est un tableau encodé en JSON comportant un objet pour chaque événement Meta auquel l’événement Adapty est associé. Seuls StartTrial, Subscribe et fb_mobile_purchase contiennent fb_content_id, fb_content_type, fb_num_items et fb_transaction_id. Chaque objet contient :

Résolution des problèmes

access_level_updated apparaît comme échoué dans le flux d’événements

access_level_updated est un événement réservé aux webhooks. Adapty ne l’envoie jamais à cette intégration. Mais Adapty enregistre un résultat pour chaque intégration activée, et un événement non pris en charge est affiché comme un échec.