Ouvrir le Studio

Google Ads Campaigns

Le node d'entrée Google Ads Campaigns permet à l'utilisateur qui lance le workflow de sélectionner un customer Google Ads et une ou plusieurs campagnes au runtime.

input output google ads campaigns node on the workflow canvas

À quoi sert le node Google Ads Campaigns ?

Le node d’entrée Google Ads Campaigns permet à la personne qui lance le workflow de sélectionner un customer Google Ads et une ou plusieurs campagnes au moment de l’exécution. Plutôt que de coder en dur le customer ID et les campaign IDs dans les settings du node Google Ads, ce node crée un sélecteur runtime — l’utilisateur choisit le compte et les campagnes à interroger à chaque lancement du workflow.

Cas d’usage typiques :

  • Construire des workflows de reporting Google Ads réutilisables où chaque utilisateur cible son propre sous-compte MCC.
  • Lancer la même analyse sur plusieurs campagnes sans dupliquer le workflow.
  • Permettre aux membres de l’équipe de générer des rapports sur leurs propres comptes et campagnes via un seul workflow partagé.
  • Mapper customer IDs et campaign IDs depuis des colonnes CSV pour exécuter un lot de rapports en une fois.

Configuration rapide

Suivez ces étapes pour ajouter et configurer le node Google Ads Campaigns dans votre workflow :

Ajouter le node au canevas

Ouvrez la bibliothèque de nodes (Node Library), naviguez dans Input/Output > Integrations, puis glissez-déposez le node Google Ads Campaigns sur votre espace de travail.

Connecter au node Google Ads

Connectez les trois sorties (customer_id, campaign_ids, integration_id) aux input handles correspondants d’un node Google Ads Campaign Reports. Sur ce node tool, activez le toggle Use variables for customer ID and campaign IDs (et optionnellement Use a variable for integration) afin que le tool lise ses valeurs depuis les inputs connectés.

Paramétrer les settings du node

Ouvrez les paramètres du node. Activez Allow Multiple si l’utilisateur doit pouvoir sélectionner plusieurs campagnes. Activez optionnellement Fixed integration pour verrouiller l’intégration Google Ads au niveau du workflow.

Vérifier l’UI runtime

Lancez le workflow. Dans l’onglet App, l’utilisateur voit un sélecteur d’intégration Google Ads, puis un dropdown de customer, puis soit un picker de campagne unique, soit un picker multi-campagnes selon le réglage Allow Multiple.

Paramètres de configuration

google ads campaigns node settings panel

Le node n’a aucun champ texte obligatoire — c’est la sélection runtime (customer + campagne) qui remplit ses sorties. Les settings ne contrôlent que le comportement de l’UI runtime.

Champs requis

Name string required default: Google Ads Campaigns

Nom du node — Sert à identifier cette entrée sur le canevas et dans l’onglet App. Renommez-le (ex. “Campagnes source”) quand vous avez plusieurs entrées Google Ads dans le même workflow.

Description string required default: Select Google Ads campaigns at runtime

Description du node — Une courte phrase affichée à côté du sélecteur runtime expliquant ce que l’utilisateur sélectionne.

Champs optionnels

required boolean default: true

Sélection requise — Si activé, l’utilisateur doit obligatoirement compléter la sélection (customer + au moins une campagne) avant de pouvoir lancer le workflow. Quand désactivé, les nodes en aval doivent gérer le cas où aucune valeur n’est fournie.

allow_multiple boolean default: false

Allow Multiple — Si activé, le picker runtime devient un multi-select et la sortie campaign_ids est une liste de campaign IDs séparés par des virgules. Sinon, une seule campagne par exécution.

integration_id string

Intégration fixe — Quand renseignée dans les settings du node, l’intégration Google Ads est verrouillée au niveau du workflow et l’utilisateur ne peut plus la changer au runtime. Requis quand vous mappez customer/campagne depuis des colonnes CSV en mode batch (le runner a besoin d’une intégration explicite pour authentifier l’appel API).

Info

Single-run vs Batch : en single-run, l’utilisateur sélectionne un customer + une (ou plusieurs) campagne(s) via des dropdowns en cascade. En batch, customer et campagnes peuvent être fixés pour toutes les lignes OU mappés depuis deux colonnes CSV (une pour le customer ID, une pour le ou les campaign IDs).

Que renvoie le node ?

Le node expose trois sorties string qui se connectent au node Google Ads Campaign Reports.

Comment récupérer l’output ?

Dans Draft & Goal vous n’avez pas besoin de chercher un nom de variable complexe généré par le système. Pour exploiter le résultat :

  1. Tirez un lien depuis chaque handle de sortie du node Google Ads Campaigns (customer_id, campaign_ids, integration_id).
  2. Connectez chacun à l’entrée correspondante du node Google Ads Campaign Reports.
  3. Activez Use variables for customer ID and campaign IDs sur le node receveur pour qu’il lise depuis les inputs connectés au lieu de ses propres settings.
customer_id string

Le customer ID Google Ads (sans tirets) sélectionné par l’utilisateur, ex. 1234567890.

campaign_ids string

L’ID de campagne sélectionné, ou une liste de campaign IDs séparés par des virgules quand Allow Multiple est activé, ex. 111222333 ou 111222333,444555666.

integration_id string

L’ID de l’intégration Google Ads choisie par l’utilisateur, ou l’intégration fixée dans les settings du node.

Exemples d’utilisation

Cas 1 : rapport sur une campagne à l’exécution

L’utilisateur choisit une intégration, un customer et une seule campagne. Le node Google Ads Campaign Reports produit un rapport JSON pour cette campagne.

Configuration :

  • Allow Multiple = false
  • required = true
  • Fixed integration = (vide — l’utilisateur choisit au runtime)

Forme du workflow :

[Google Ads Campaigns input]  →  [Google Ads Campaign Reports]  →  [LLM Insights]

Cas 2 : rapport multi-campagnes en mode batch

Un CSV contient une ligne par paire (customer, campagne). À l’étape 3 (Mapping), vous mappez la colonne Customer ID et la colonne Campaign IDs vers le node d’entrée. Chaque ligne déclenche un appel Google Ads Campaign Reports sur le customer + campagne(s) correspondants.

Configuration :

  • Allow Multiple = true
  • Fixed integration = <une intégration Google Ads spécifique> (requis en mode batch)

Mapping :

  • Colonne CSV customer_id → sortie node customer_id
  • Colonne CSV campaign_ids → sortie node campaign_ids (séparés par virgules si plusieurs IDs par ligne)

Problèmes courants

L'utilisateur voit le dropdown 'Select a customer' mais il est vide

Cause : L’intégration Google Ads choisie par l’utilisateur n’a accès à aucun customer.

Solution : Vérifiez les scopes OAuth et que le propriétaire de l’intégration a bien accès à au moins un MCC ou sous-compte Google Ads.

La liste des campagnes reste vide après le choix d'un customer

Cause : Le customer sélectionné n’a aucune campagne correspondant au filtre API.

Solution : Choisissez un autre customer, ou vérifiez directement dans l’UI Google Ads que le compte a des campagnes actives.

Erreur de validation 'Customer ID is required' au lancement d'un run

Cause : L’utilisateur a choisi un customer mais n’a pas choisi de campagne. Les deux sont requis — la valeur du formulaire n’est complète qu’une fois au moins une campagne sélectionnée.

Solution : Sélectionnez au moins une campagne, ou désactivez Required dans les settings du node si les nodes en aval savent gérer une valeur manquante.

Le run batch échoue à s'authentifier auprès de Google Ads

Cause : Aucune intégration fixe définie sur le node d’entrée alors qu’on tourne en mode CSV/batch. Sans elle, le runner ne peut pas déterminer à quel compte Google Ads appartient le customer ID lu dans la colonne.

Solution : Ouvrez les settings du node, activez Fixed integration et sélectionnez l’intégration Google Ads à utiliser pour tout le batch.

Bonnes pratiques et pièges à éviter

Tip

Quand Allow Multiple est actif, le node Google Ads Campaign Reports en aval traite la liste séparée par virgules comme plusieurs campagnes et produit un rapport par campagne en un seul appel — gardez le mapping de sortie de ce node tel quel.

Warning

En mode CSV / batch, vous devez définir une intégration fixe dans les settings du node d’entrée. Sans ça, le runner n’a aucun moyen de déterminer à quel compte Google Ads appartient le customer ID lu dans la colonne, et le run échouera à s’authentifier.

Comment s’intègre-t-il dans un workflow ?

Le node Google Ads Campaigns sert de point d’entrée runtime qui alimente le tool Google Ads Campaign Reports — il transforme un rapport codé en dur en un rapport paramétré contrôlé par l’utilisateur.

graph LR
    Input[Google Ads Campaigns input] --> Reports[Google Ads Campaign Reports]
    Reports --> LLM[LLM Insights]
    LLM --> Output[Sheets / Slides / Email]

Nodes complémentaires