Avant de commencer
- Vous êtes admin ou membre de l'agence dans Kapitaine.
- Votre compte Facebook a accès au Business Manager de l'agence et aux comptes publicitaires des clients (comptes détenus par l'agence ou partagés par les clients).
- Pour créer des publicités, votre accès aux comptes doit permettre de gérer les campagnes, et à la Page Facebook de chaque annonceur.
Méthode 1 : connexion avec Facebook
Dans le menu, ouvrez Intégrations. Sur la carte Meta Ads, cliquez sur + Ajouter une connexion.
Laissez l'onglet Connexion Facebook et lancez la connexion. Vous êtes redirigé vers Facebook.
Sur Facebook, choisissez le Business Manager et les comptes publicitaires à autoriser, vérifiez les permissions demandées, puis validez.
De retour dans Kapitaine, la connexion apparaît avec le badge OAuth. La liste des comptes accessibles se charge en arrière-plan (Vérification des accès en cours…).
Cliquez sur Comptes →, cochez les comptes à suivre, puis Rattacher la sélection au client. Voir créer un client et rattacher ses comptes.
L'autorisation obtenue par cette méthode dure environ 60 jours. Kapitaine la renouvelle automatiquement avant son échéance ; les administrateurs sont prévenus 7 jours puis 1 jour avant l'expiration si le renouvellement n'a pas eu lieu.
Méthode 2 : token d'utilisateur système
Un utilisateur système est un compte technique de votre Business Manager, indépendant des personnes. Son token n'expire pas : c'est la méthode la plus stable pour une agence.
Dans le Business Manager : Paramètres de l'entreprise, puis Utilisateurs système, ajoutez un utilisateur de rôle « Admin ».
Avec Attribuer des éléments, donnez-lui le contrôle total des comptes publicitaires (et des Pages) de vos clients.
Avec Générer un token, choisissez votre application Meta et cochez
ads_management,ads_readetbusiness_management.Dans Kapitaine, onglet Token système : collez le token dans Token système, donnez éventuellement un Nom de la connexion et l'ID du Business Manager (facultatif, il permet de lister aussi les comptes détenus et partagés par vos clients).
Cliquez sur Vérifier le token et lister les comptes.
Le token est chiffré dès réception ; il n'est jamais réaffiché ni écrit dans les journaux.
Les permissions demandées et leur usage
Lors de la connexion avec Facebook, Kapitaine demande les permissions suivantes. Chacune sert une fonction précise du produit ; aucune donnée n'est revendue ni utilisée à d'autres fins que le service rendu à votre agence.
ads_readLecture seule- Lire les comptes publicitaires, campagnes, ensembles, publicités et créas, leurs statistiques quotidiennes (dépense, impressions, clics, actions), leur statut de diffusion et d'examen, et les conversions personnalisées. Ces données alimentent les tableaux de bord, les alertes et les rapports mensuels.
ads_management- Créer des publicités à votre demande, toujours au statut « en pause » (envoi des images et vidéos, création de la créa puis de la publicité), générer des aperçus, puis activer, mettre en pause, renommer ou dupliquer des publicités quand un utilisateur le confirme. Également utilisée pour révoquer l'accès à la déconnexion.
business_management- Lister les Business Manager auxquels vous avez accès et les comptes publicitaires qu'ils détiennent ou que vos clients leur ont partagés, pour que vous choisissiez les comptes à suivre.
pages_show_list- Associer les publicités créées à la Page Facebook de l'annonceur, qui est l'identité sous laquelle la publicité est diffusée. Kapitaine ne publie aucun contenu organique sur les Pages.
pages_read_engagement- Utilisée avec la précédente pour que la Page choisie puisse servir d'identité aux publicités créées. Kapitaine ne lit ni les publications, ni les commentaires, ni les messages des Pages.
Ce que fait Kapitaine
- Lire les statistiques et la structure des comptes rattachés à un client
- Créer des publicités en pause dans des ensembles existants, sur votre demande
- Activer ou mettre en pause une publicité après confirmation d'un utilisateur
Ce qu'il ne fait jamais
- Activer une publicité sans confirmation
- Modifier budgets, enchères ou audiences de vos ensembles
- Publier ou lire du contenu organique sur vos Pages
Ce qui se passe après la connexion
- Les comptes non rattachés à un client ne sont ni synchronisés ni surveillés (badge Non rattaché · non suivi).
- Au rattachement, Kapitaine importe jusqu'à 24 mois d'historique de statistiques, par tranches mensuelles.
- Ensuite, les chiffres sont mis à jour toutes les heures (les 3 derniers jours sont réécrits pour intégrer les conversions tardives), et chaque nuit sur 30 jours. Les statuts de diffusion sont relus toutes les 30 minutes.
- Les écrans lisent cette copie synchronisée : aucun appel à Meta n'est fait au chargement d'une page.
Si un token expire ou qu'une permission est retirée, le compte passe en erreur, une alerte est créée et la page Santé des connexions affiche le message d'origine de Meta avec un bouton Renouveler.
Déconnecter Meta Ads
Un admin peut supprimer une connexion depuis Intégrations (icône corbeille). Les comptes rattachés sont archivés, leur historique est conservé, l'accès est révoqué auprès de Meta et les jetons sont effacés.
Vous pouvez aussi retirer l'accès depuis Facebook : Paramètres et confidentialité, puis Paramètres, puis Applications et sites web (selon la version, dans l'Espace Comptes), puis sélectionnez Kapitaine et Supprimer. Pour un utilisateur système, un administrateur du Business Manager peut retirer l'application ou régénérer le token. Pour demander la suppression des données obtenues via Meta, voir la page Suppression des données.