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.
- 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.
- 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.
- 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 :
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 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 sont des événements standard.
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 iOS, Android, React Native, Flutter, et Unity 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ètre | Type | Description |
|---|---|---|
event | String | Toujours “CUSTOM_APP_EVENTS”. |
app_user_id | String | Le Customer User ID de l’utilisateur. |
advertiser_id | String | IDFA (iOS) ou Advertising ID (Android). |
advertiser_tracking_enabled | Integer | 1 si le suivi est activé (ATT autorisé), 0 sinon. |
application_tracking_enabled | Integer | Toujours 1. |
custom_events | String | Chaîne JSON encodée contenant les objets d’événements (voir ci-dessous). |
extinfo | String | Chaîne JSON encodée contenant les informations sur l’application/l’appareil (ex. : version, OS, locale). |
anon_id | String | Facebook Anonymous ID (si disponible). |
Le paramètre custom_events est un tableau d’objets encodé en JSON, contenant :
| Paramètre | Type | Description |
|---|---|---|
_eventName | String | Le nom de l’événement Meta Ads (ex. : “Subscribe”). |
_logTime | Long | Horodatage de l’événement en secondes. |
_valueToSum | Float | Montant des revenus. |
fb_content_id | String | L’identifiant du produit dans le store. |
fb_currency | String | Code devise (ex. : “USD”). |
fb_order_id | String | Identifiant de transaction original. |
fb_transaction_id | String | Identifiant de transaction original. |
fb_content_type | String | Toujours “in_app”. |
fb_num_items | Integer | Toujours 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.