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.

Veuillez noter que l’intégration Facebook Ads fonctionne sur iOS 14.5+ uniquement pour les utilisateurs ayant donné leur consentement ATT.

fd84ddf-CleanShot_2023-08-15_at_15.45.442x.webp
  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.
4b326c4-001563-August-23-4tO3JVso.webp
  1. 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 :

c4eb8eb-001565-August-23-483KKBbC.webp

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

Veuillez noter que l’intégration Facebook Ads est spécifiquement conçue pour les entreprises qui utilisent Meta pour leurs campagnes publicitaires et souhaitent les optimiser en fonction du comportement de leurs clients. Elle prend en charge les événements standard de Meta à des fins d’optimisation. Par conséquent, la modification du nom des événements n’est pas disponible pour l’intégration Meta Ads. Adapty associe efficacement vos événements clients aux événements Meta correspondants pour une analyse précise.

Événement AdaptyÉvénement Meta Ads
Subscription initial purchaseSubscribe
Subscription renewedSubscribe
Subscription cancelledCancelSubscription
Trial startedStartTrial
Trial convertedSubscribe
Trial cancelledCancelTrial
Non subscription purchasefb_mobile_purchase
Billing issue detectedbilling_issue_detected
Entered grace periodentered_grace_period
Auto renew offauto_renew_off
Auto renew onauto_renew_on
Auto renew off subscriptionauto_renew_off_subscription
Auto renew on subscriptionauto_renew_on_subscription

StartTrial, Subscribe, CancelSubscription sont des événements standard.

8a5df9d-CleanShot_2023-07-04_at_12.47.312x.webp

Pour activer des événements spécifiques, activez simplement ceux dont vous avez besoin. Si plusieurs noms d’événements sont sélectionnés, Adapty regroupera les données de tous les événements choisis sous un seul nom d’événement Adapty.

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 pour définir ce paramètre.

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:

ParamètreTypeDescription
eventStringToujours “CUSTOM_APP_EVENTS”.
app_user_idStringLe Customer User ID de l’utilisateur.
advertiser_idStringIDFA (iOS) ou Advertising ID (Android).
advertiser_tracking_enabledInteger1 si le suivi est activé (ATT autorisé), 0 sinon.
application_tracking_enabledIntegerToujours 1.
custom_eventsStringChaîne JSON encodée contenant les objets d’événements (voir ci-dessous).
extinfoStringChaîne JSON encodée contenant les informations sur l’application/l’appareil (ex. : version, OS, locale).
anon_idStringFacebook Anonymous ID (si disponible).

Le paramètre custom_events est un tableau d’objets encodé en JSON, contenant :

ParamètreTypeDescription
_eventNameStringLe nom de l’événement Meta Ads (ex. : “Subscribe”).
_logTimeLongHorodatage de l’événement en secondes.
_valueToSumFloatMontant des revenus.
fb_content_idStringL’identifiant du produit dans le store.
fb_currencyStringCode devise (ex. : “USD”).
fb_order_idStringIdentifiant de transaction original.
fb_transaction_idStringIdentifiant de transaction original.
fb_content_typeStringToujours “in_app”.
fb_num_itemsIntegerToujours 1 pour les événements d’achat.

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.