Google Ads

Google Ads est un connecteur : il relie une application MeDo à un compte Google Ads, afin que l'application puisse lister les clients accessibles, lire des rapports de performance, rechercher une campagne, et créer des brouillons en pause confirmés, ou mettre des campagnes en pause et les activer. Tout ce que l'application voit provient du compte que vous avez connecté.

#Ce que vous pouvez construire

• Un tableau de bord de performance. Listez les clients accessibles du propriétaire et affichez les métriques client, campagne, annonce ou mot-clé pour une fenêtre de dates explicite.
• Un sélecteur de compte manager. Listez les comptes enfants sous un manager (MCC) et ouvrez des rapports sur un compte client — pas sur le manager lui-même.
• Une page de relecture de campagne. Recherchez une campagne par ID ou nom exact, puis mettez-la en pause ou activez-la après confirmation.
• Un espace de lancement. Prévisualisez une campagne Search en pause avec un budget quotidien, un groupe d'annonces, un texte d'annonce, un lieu ou une action de conversion, puis ne la créez qu'après confirmation.

Google Ads convient lorsque l'application a besoin des vrais comptes publicitaires du propriétaire. Ce n'est pas un outil de création de compte, un moteur d'enchères, ni un endroit où chaque visiteur se connecte avec son propre compte Ads — voir Limites.

#Exemples de construction

Copiez l'un de ces textes dans la zone de saisie. Le premier est le point de départ le plus simple et déjà utile.

Use @Google Ads to build a private website console that lists my accessible customers, then shows an account report for a selected customer and date range.

Use @Google Ads to build a private manager console that lists sub-accounts under my MCC and shows a campaign report for one client account.

Use @Google Ads to build a private campaign review page where I look up one campaign by ID or name and pause or enable it only after I confirm.

Use @Google Ads to build a private launch workspace that creates a paused Search campaign with a daily budget on my client account after I confirm the name and amount.

La formulation compte : dites pour qui est l'outil et ce qu'il doit faire. « Une console Ads privée pour le propriétaire du compte » produit une application différente de « une page qui liste des campagnes ».

#Préparer et connecter

Vous avez besoin d'un compte Google qui peut déjà ouvrir les comptes Ads que l'application doit utiliser. Aucune clé API, aucun projet Google Cloud, aucune configuration de facturation. MeDo ne peut pas créer un nouveau compte Ads, rattacher la facturation, ni terminer la vérification annonceur à votre place.

1. Ouvrez Skills & Connectors dans la barre latérale et recherchez Google Ads.
2. Ouvrez la carte Google Ads et cliquez sur Connect.
3. Connectez-vous au compte Google et autorisez l'accès demandé par MeDo. Le parcours peut aussi demander un Customer ID — utilisez l'ID manager (MCC) si vous en avez un, sinon l'ID du compte client.
4. Le bouton passe à Connected. C'est l'état de succès ; vous n'avez rien à recopier dans l'application.

Si vous commencez à construire avant de connecter, MeDo le détecte et affiche un bouton de connexion Google Ads sous sa réponse. Vous pouvez connecter depuis là. Si aucun bouton n'apparaît, utilisez la carte du connecteur décrite ci-dessus.

#Utilisation dans votre application

• L'application utilise le compte Google Ads connecté du propriétaire, pas le compte Ads de chaque visiteur. Chaque visiteur qui atteint une vue de compte ou de rapport voit la même connexion. Placez ces pages derrière la propre connexion de votre application, et limitez-les aux personnes qui doivent y avoir accès. Une page intitulée « privée » n'est pas un contrôle d'accès à elle seule.
• Les rapports et les écritures appartiennent à un compte client. Un ID manager (MCC) sert à lister les enfants. Demander un ID manager pour les dépenses, les clics ou les changements de campagne échoue. Copiez l'ID client renvoyé par le connecteur ; n'inventez pas d'ID.
• La liste des clients accessibles n'est pas l'arbre MCC complet. Elle montre les comptes que l'utilisateur Google peut ouvrir directement. Pour choisir un enfant sous un manager, listez d'abord les sous-comptes.
• Les rapports exigent une fenêtre de dates explicite. Des lignes de mots-clés ou d'annonces vides signifient généralement que ce compte n'a aucun objet dans la plage, pas que la connexion a échoué.
• Les écritures sont d'abord confirmées, et elles ne sont pas réessayées. MeDo prévisualise le client, le nom, le budget, le statut, le texte d'annonce ou le lieu et attend une confirmation explicite. Si le résultat est inconnu, relisez le compte avant de créer un autre objet. Une nouvelle tentative peut ajouter une seconde campagne, un second budget, une seconde annonce ou une seconde action de conversion.
• Les nouvelles campagnes Search, groupes d'annonces et annonces Search responsives démarrent en pause. Activer une campagne est une étape de confirmation séparée.
• Les notes propres à l'application restent dans l'application. Checklists de lancement, statuts de relecture et commentaires appartiennent aux tables de votre application, avec pour clé un vrai ID de client, campagne, budget ou groupe d'annonces. Ce ne sont pas des champs Google Ads.

#Limites et dépannage

« Connexion requise » s'affiche dans l'application. La connexion Google Ads appartient au propriétaire de l'application. Demandez-lui d'ouvrir la carte du connecteur et de cliquer sur Connect, puis de recharger.

Un rapport ou une écriture indique que la demande visait un manager. Passez à un ID client issu de la liste des sous-comptes. N'envoyez pas de rapports ni de changements de campagne au MCC.

Le résultat d'une écriture est inconnu. Ne cliquez pas à nouveau. Recherchez d'abord la campagne ou la conversion par nom ou ID.

Les visiteurs voient des données Ads alors qu'ils ne devraient pas. La connexion est partagée. Ajoutez une connexion et des restrictions côté serveur à l'application ; voir Gérer l'accès et les rôles.

#Voir aussi

• Catalogue de connecteurs — les autres connecteurs et leur usage.
• Skills et Connecteurs — comment les Skills sont appelés, tarifés et limités.
• Gérer la connexion et les utilisateurs — donnez à une application ses propres comptes avant d'exposer des données connectées.