Avant de commencer
- Utilisez un compte Google qui a accès à votre MCC, ou directement aux comptes Google Ads de vos clients.
- Côté Google Ads, les comptes clients doivent être associés à votre MCC (demande envoyée depuis le MCC, acceptée par le client).
- Vous êtes admin ou membre de l'agence dans Kapitaine.
Connecter votre compte Google
Ouvrez Intégrations. Sur la carte Google Ads, cliquez sur + Ajouter une connexion.
Laissez l'onglet Connexion Google et lancez la connexion : vous êtes redirigé vers Google.
Choisissez le compte Google qui a accès à votre MCC, vérifiez l'accès demandé et acceptez.
De retour dans Kapitaine, ouvrez Comptes → sur la connexion. La colonne Compte administrateur (MCC) indique par quel MCC chaque compte est accessible.
Cochez les comptes à suivre et cliquez sur Rattacher la sélection au client. Voir créer un client.
Kapitaine parcourt tous les niveaux de votre MCC, sous-comptes administrateurs compris. Les comptes administrateurs eux-mêmes ne sont pas proposés : seuls les comptes qui diffusent des annonces le sont. Si un compte est accessible à la fois directement et via un MCC, l'accès direct est utilisé.
Option : utiliser le projet Google Cloud de votre agence
Les admins peuvent déclarer leur propre projet Google Cloud dans la section Applications de l'agence de la page Intégrations. L'écran de consentement, le niveau d'accès à l'API Google Ads et les quotas sont alors à votre nom.
Dans la console Google Cloud, créez un projet et activez « Google Ads API » (et « Google Drive API » si vous importez des créas depuis Drive).
Configurez un écran de consentement de type « Externe ».
Créez un « ID client OAuth » de type « Application Web » et collez comme URI de redirection celle affichée par Kapitaine (bouton de copie dans le formulaire).
Dans Kapitaine, renseignez ID client (il se termine par
.apps.googleusercontent.com) et Secret client, puis Enregistrer l'application.Sur la carte Google Ads, onglet App de l'agence, cliquez sur Connexion Google via cette application.
Le secret client est chiffré au repos et n'est jamais réaffiché.
L'accès demandé et son usage
https://www.googleapis.com/auth/adwords- Accès à l'API Google Ads. Google ne propose pas de permission en lecture seule pour cette API ; Kapitaine ne fait que des lectures : liste des comptes accessibles et de la hiérarchie du MCC, campagnes, groupes d'annonces, groupes d'assets Performance Max, annonces et leur statut d'approbation, statistiques quotidiennes (coût, impressions, clics, conversions par action de conversion) et actions de conversion actives.
openid, emailLecture seule- Afficher, sur la connexion, l'adresse du compte Google utilisé, pour que votre équipe sache quel compte a donné l'accès.
Ce que fait Kapitaine
- Lire les comptes, campagnes et statistiques des comptes rattachés
- Calculer dépense, leads et CPL pour les tableaux de bord, alertes et rapports
Ce qu'il ne fait jamais
- Créer, modifier ou supprimer des campagnes, annonces, mots-clés ou enchères
- Toucher à la facturation de vos comptes Google Ads
Synchronisation et révocation
Au rattachement, jusqu'à 24 mois d'historique sont importés, puis les chiffres sont mis à jour toutes les heures et chaque nuit. Les jetons sont chiffrés (AES-256-GCM) et rafraîchis automatiquement.
Pour couper l'accès : un admin supprime la connexion dans Intégrations (les comptes sont archivés, l'historique conservé, le jeton révoqué auprès de Google), ou vous retirez l'accès sur myaccount.google.com/permissions.