Intégration Meta Ads

Assistance d'un développeur requise

Vous aurez besoin de l’aide de votre équipe de développement pour configurer l’intégration. Veuillez partager ce guide avec eux.

L’intégration Meta Ads vous permet de synchroniser les audiences Pushwoosh avec vos comptes publicitaires Meta. Utilisez-la pour cibler ou exclure des utilisateurs dans des campagnes publicitaires et ajouter des publicités payantes comme un autre canal dans votre parcours client.

Cas d’utilisation

Utilisez cette intégration pour :

• cibler les utilisateurs à forte valeur dans plusieurs canaux pour augmenter les achats ou l’engagement
• recibler les utilisateurs qui sont moins réactifs sur d’autres canaux
• créer des audiences de suppression pour que les clients fidèles ne reçoivent pas de publicités inutiles

Prérequis

Avant de connecter Meta Ads, assurez-vous que :

• Vous avez le rôle Admin dans votre compte Pushwoosh. Consultez Gérer l’accès et les permissions des utilisateurs pour savoir comment fonctionnent les rôles et les permissions.
• Vous avez un Facebook Business Manager configuré pour gérer les actifs Facebook de votre marque, y compris les comptes publicitaires, les pages et les applications.
• Vous avez un Compte publicitaire Facebook actif lié à votre Business Manager.
• L’administrateur de votre Facebook Business Manager vous a accordé les permissions Gérer les campagnes ou Gérer les comptes publicitaires pour les comptes publicitaires que vous prévoyez d’utiliser avec Pushwoosh.
• Vous avez accepté les termes et conditions du compte publicitaire pour ces comptes.
• Vous avez accepté les Conditions des Audiences Personnalisées de Facebook pour les comptes publicitaires Facebook que vous prévoyez d’utiliser avec Pushwoosh.

Configurer Meta Ads dans Pushwoosh

1. Dans Pushwoosh, allez dans Settings > 3rd party integrations.

2. Dans la carte Meta Ads, cliquez sur Login page.

3. Connectez-vous à votre compte Meta, puis cliquez sur Continue.

4. Sélectionnez les comptes publicitaires que vous souhaitez connecter.

5. Examinez les permissions demandées pour l’accès au compte publicitaire et à l’entreprise.

6. Cliquez sur Save. Meta affiche alors une confirmation que votre compte est connecté.

Examiner le statut de la connexion

Après la configuration, vous serez redirigé vers la page Meta Ads dans Pushwoosh.

Le tableau des comptes publicitaires liste chaque compte connecté avec :

• Nom du compte publicitaire
• Compte professionnel
• ID

Ouvrez les trois points à la fin d’une ligne et choisissez Remove ad account pour supprimer ce compte publicitaire de la liste dans Pushwoosh.

Gérer les comptes publicitaires connectés

Sur la page Meta Ads, cliquez sur Manage accounts pour ouvrir la boîte de dialogue. Utilisez le bouton à bascule sur chaque ligne pour inclure ou exclure ce compte publicitaire de l’intégration. Cliquez sur Apply pour enregistrer les modifications ou sur Cancel pour fermer sans enregistrer.

Pour ajuster la vue de la liste :

• Activez ou désactivez Show only connected pour limiter les lignes qui apparaissent.
• Saisissez dans Search by name or id… pour trouver des comptes dans la liste.

Mapper les tags du projet aux champs Meta

Le mappage des propriétés utilisateur vous permet d’indiquer à Pushwoosh quels attributs utilisateur Meta doivent mettre à jour quels champs Tag name dans votre projet. De cette façon, lorsque les données proviennent de Meta, elles sont enregistrées là où vous vous y attendez.

Note

Pour la synchronisation d’audience, Pushwoosh envoie toujours un identifiant par utilisateur depuis Email, Phone number, ou MADID, en fonction de ce qui existe sur le profil. Configurez le mappage lorsque vous souhaitez que Meta reçoive des attributs utilisateur supplémentaires au-delà des identifiants ci-dessus.

1. Sur la page Meta Ads, cliquez sur Map user data.

2. Pour chaque Facebook field dans la colonne de gauche, choisissez un Tag name dans votre projet à partir du contrôle de droite. Mappez uniquement les lignes dont vous avez besoin.

Champs mappés automatiquement

Pushwoosh mappe ces champs automatiquement. Vous ne les définissez pas dans Map project tags to Meta fields :

• Email
• Numéro de téléphone
• MADID

3. Cliquez sur Save pour appliquer le mappage ou sur Cancel pour fermer sans enregistrer.

Activer la collecte de MADID dans le SDK

Meta Ads fait correspondre les utilisateurs à l’aide d’identifiants d’appareil (MADID) collectés via le SDK mobile. Le SDK Pushwoosh ne collecte pas automatiquement les identifiants publicitaires (GAID sur Android, IDFA sur iOS). Les deux plateformes exigent le consentement explicite de l’utilisateur avant que l’identifiant puisse être lu. Dans votre application, demandez le consentement de l’utilisateur, lisez l’identifiant lorsque cela est autorisé et transmettez la valeur au SDK.

Android

1. Ajouter la dépendance

implementation 'com.google.android.gms:play-services-ads-identifier:...'

2. Déclarer la permission AD_ID (requise pour targetSdk ≥ 33)

Ajoutez ceci à votre AndroidManifest.xml :

<uses-permission android:name="com.google.android.gms.permission.AD_ID"/>

Attention

Sans cette permission sur Android 13+, AdvertisingIdClient.getAdvertisingIdInfo() renvoie silencieusement un UUID nul (00000000-0000-0000-0000-000000000000). Le SDK Pushwoosh normalise cela en null, donc aucun MADID n’est envoyé au serveur et la correspondance d’audience Meta ne fonctionnera pas.

3. Récupérer le GAID et le transmettre au SDK

getAdvertisingIdInfo doit être appelé sur un thread d’arrière-plan :

String gaid = AdvertisingIdClient.getAdvertisingIdInfo(context).getId();

Pushwoosh.getInstance().setAdvertisingId(gaid);

Pour effacer la valeur stockée sur le backend, passez null ou une chaîne vide :

Pushwoosh.getInstance().setAdvertisingId(null);

Notes de comportement :

• Si la valeur n’a pas changé depuis le dernier appel réussi, aucune requête réseau n’est effectuée.
• Si la requête réseau échoue, réessayez au prochain lancement de l’application.
• L’appel est ignoré lorsque Pushwoosh.stopCommunication() est actif.
• L’UUID nul (00000000-0000-0000-0000-000000000000) est traité de la même manière que null — le MADID stocké est effacé sur le backend.

iOS

1. Ajouter la description d’utilisation à Info.plist

Apple exige cette clé avant d’afficher la boîte de dialogue de permission ATT :

<key>NSUserTrackingUsageDescription</key>
<string>We use your advertising identifier to show you relevant ads.</string>

2. Déclarer le domaine de suivi dans votre manifeste de confidentialité

Si votre application utilise l’IDFA pour le suivi, Apple vous demande de lister les domaines qui reçoivent des données de suivi dans votre manifeste de confidentialité (PrivacyInfo.xcprivacy). Consultez TN3182 pour les exigences complètes.

Définissez NSPrivacyTracking sur true et ajoutez le domaine de suivi Pushwoosh à NSPrivacyTrackingDomains :

<key>NSPrivacyTracking</key>
<true/>
<key>NSPrivacyTrackingDomains</key>
<array>
    <string>tracking.svc-nue.pushwoosh.com</string>
</array>

Note

Si l’utilisateur n’a pas accordé la permission ATT, iOS bloque les requêtes réseau vers tous les domaines listés dans NSPrivacyTrackingDomains. Le MADID ne sera pas envoyé, peu importe ce que fait votre code.

3. Demander l’autorisation de suivi et transmettre l’IDFA au SDK

ATTrackingManager nécessite iOS 14 ou une version ultérieure. Si votre cible de déploiement est inférieure à iOS 14, enveloppez l’appel dans une vérification de disponibilité.

Le SDK Pushwoosh n’appelle pas ATTrackingManager. Demandez l’autorisation de suivi dans votre application, puis transmettez le résultat au SDK :

import AppTrackingTransparency
import AdSupport

if #available(iOS 14, *) {
    ATTrackingManager.requestTrackingAuthorization { status in
        let idfa = status == .authorized
            ? ASIdentifierManager.shared().advertisingIdentifier.uuidString
            : nil
        Pushwoosh.configure.setAdvertisingId(idfa)
    }
}

Pour effacer la valeur stockée sur le backend, passez nil ou une chaîne vide :

Pushwoosh.configure.setAdvertisingId(nil)

Notes de comportement :

• Si la valeur n’a pas changé depuis le dernier appel réussi, aucune requête réseau n’est effectuée.
• Si la requête réseau échoue, appelez à nouveau setAdvertisingId au prochain lancement de l’application.
• L’appel est ignoré lorsque Pushwoosh_ALLOW_SERVER_COMMUNICATION est désactivé.
• L’UUID nul (00000000-0000-0000-0000-000000000000) est traité de la même manière que nil ou une chaîne vide — le MADID stocké est effacé sur le backend.

Appelez requestTrackingAuthorization depuis le flux principal de l’interface utilisateur de votre application. Apple recommande de le faire après avoir affiché votre propre écran explicatif, et non immédiatement au lancement.

Comment ça marche

Une fois que vous appelez setAdvertisingId, le SDK envoie la valeur au point de terminaison de suivi Pushwoosh en tant que champ madid avec le code de l’application et l’ID matériel de l’appareil. Pushwoosh utilise cet identifiant pour faire correspondre vos enregistrements d’appareils avec les audiences Meta Ads pour la synchronisation.

Synchroniser les audiences dans les journeys

Le point Audience sync dans le Journey Builder lie votre journey à une Audience Personnalisée Meta. Chaque fois qu’un utilisateur atteint ce point, Pushwoosh demande à Meta de l’ajouter à l’audience ou de l’en retirer.

Par exemple, vous pouvez l’utiliser pour cesser de montrer une publicité de webinaire aux utilisateurs qui se sont déjà inscrits, afin de ne pas gaspiller de budget publicitaire sur des personnes qui n’ont plus besoin de la voir.

Pour configurer la synchronisation d’audience :

1. Ouvrez le Journey Builder.

2. Ajoutez une Entrée basée sur l’audience. Dans Audience source, choisissez un segment ou une liste Pushwoosh qui définit qui entre dans ce journey. Par exemple, un segment Utilisateurs avec le tag webinar_registered défini sur true. Seuls ces utilisateurs parcourront le journey et atteindront Audience sync.

3. Ajoutez le point Audience sync.

4. Sous How to sync users info to Meta audience, choisissez une option :

   • Ajouter des utilisateurs à l’audience. Ajoute chaque utilisateur qui atteint cette étape à l’audience Meta que vous sélectionnez. Par exemple, utilisez ceci pour commencer à montrer une publicité aux utilisateurs qui se sont inscrits mais n’ont pas encore participé.
   • Retirer des utilisateurs de l’audience. Retire chaque utilisateur qui atteint cette étape de cette audience Meta. Dans cet exemple, sélectionnez cette option pour cesser de montrer la publicité du webinaire aux utilisateurs qui se sont déjà inscrits.

5. Dans Meta Ads account, sélectionnez le compte publicitaire connecté.

6. Dans Audience, sélectionnez l’audience Meta, par exemple Webinar.

7. Cliquez sur Apply pour enregistrer le point ou sur Cancel pour fermer sans enregistrer.

8. Terminez la configuration du journey, puis lancez-le.

Lorsque ces utilisateurs atteignent Audience sync, ils sont retirés de l’audience Webinar dans Meta, de sorte qu’ils ne voient plus la publicité du webinaire là-bas.

Comportement et gestion des erreurs

Le traitement du Journey dépend de la disponibilité du compte Meta et de l’audience :

• Meta ne met à jour l’audience que s’il peut faire correspondre l’utilisateur à partir des données fournies par Pushwoosh. Si Meta ne peut pas faire correspondre l’utilisateur, l’audience ne change pas pour cet utilisateur, et il continue dans le journey.
• Si un profil atteint le point Audience sync alors que le compte publicitaire connecté est déconnecté, le journey s’arrête pour ce profil et Pushwoosh envoie des notifications système et par e-mail.
• Si une audience sélectionnée n’est pas trouvée dans Meta et que l’API renvoie une erreur, le journey s’arrête pour ce profil et Pushwoosh envoie des notifications système et par e-mail.

Statistiques de synchronisation d’audience

Après le lancement, ouvrez les statistiques de l’étape Audience sync pour voir le volume d’entrées, les ajouts et les retraits, et les profils ignorés. Pour plus de détails sur les métriques, consultez Audience sync dans les Statistiques du Customer Journey.