Générateur de requêtes Google Ads

L'outil de création de requêtes Google Ads est un outil interactif conçu pour vous aider à créer et à valider des requêtes à l'aide du langage de requête Google Ads (GAQL). Que vous soyez un nouvel utilisateur ou un utilisateur expérimenté du GAQL, le générateur de requêtes peut simplifier le processus d'extraction des données exactes dont vous avez besoin à partir de l'API Google Ads.

Avantages

  • Facilité d'utilisation : simplifie le processus d'écriture de requêtes GAQL, sans nécessiter de connaître la syntaxe spécifique ni les champs disponibles.
  • Découverte : permet d'explorer et de trouver les ressources, les champs, les segments et les métriques disponibles dans le modèle de données de l'API Google Ads.
  • Réduction des erreurs : grâce à une interface structurée et à des menus déroulants d'options valides, il permet d'éviter les erreurs de syntaxe et de frappe, et de s'assurer que la requête générée est valide.
  • Création de requêtes plus rapide : accélère le processus de développement en automatisant la génération de chaînes de requête.
  • Validation : l'outil est associé à l'explorateur d'API et à l'outil de validation des requêtes pour vérifier les requêtes par rapport aux règles de l'API avant leur exécution.

Fonctionnement

L'outil de création de requêtes Google Ads fournit une interface conviviale pour assembler visuellement les requêtes GAQL. Voici le workflow de base :

  1. Sélectionnez une ressource : commencez par choisir la ressource principale dans l' onglet "Référence" pour la version que vous souhaitez interroger. Cette ressource est placée dans la clause FROM. Les ressources représentent des entités dans Google Ads, telles que campaign, ad_group ou keyword_view. L'outil de création de requêtes liste toutes les ressources disponibles.
  2. Choisissez des champs : une fois une ressource sélectionnée, l'outil affiche tous les champs sélectionnables, y compris les attributs, les segments et les métriques associés à cette ressource et à ses ressources attribuées (qui peuvent être jointes implicitement). Vous pouvez cocher des cases pour inclure des champs dans votre clause SELECT. À mesure que vous effectuez des sélections, l'outil génère dynamiquement la chaîne de requête GAQL correspondante, affiche les erreurs et filtre les combinaisons de champs incompatibles.
  3. Appliquez des filtres : ajoutez des conditions de clause WHERE pour filtrer les résultats. L'outil de création de requêtes vous aide à choisir des champs, des opérateurs et des valeurs, en veillant à ce que la syntaxe soit correcte.
  4. Triez les résultats : spécifiez les ordres de tri à l'aide de la clause ORDER BY.
  5. Définissez des limites : ajoutez une clause LIMIT pour contrôler le nombre de résultats renvoyés.
  6. Validez : l'outil vous guide vers des combinaisons de champs valides et vous permet d'accéder à l'explorateur d'API pour tester votre requête par rapport aux données de votre compte. Il existe également un outil de validation des requêtes distinct dans lequel vous pouvez coller et vérifier manuellement les requêtes GAQL écrites.
  7. Exportez : une fois que vous êtes satisfait de votre requête, copiez et collez votre chaîne GAQL testée et syntaxiquement correcte dans vos requêtes client GoogleAdsService.Search ou SearchStream.

L'outil de création de requêtes s'assure que les champs, les segments et les métriques sélectionnés sont compatibles et peuvent être utilisés ensemble dans une seule requête, en référençant les métadonnées sous-jacentes de l'API Google Ads.

Commencer

Vous pouvez accéder au Générateur de requêtes de deux manières : en passant par une page spécifique de la documentation de référence sur les rapports ou en explorant la page de présentation du Générateur de requêtes.

Depuis la documentation de référence sur les rapports

  1. Commencez par la documentation de référence sur les rapports, puis choisissez une ressource spécifique dans la liste de toutes les ressources. Vous pouvez également accéder directement à la ressource depuis le volet de navigation de gauche.
  2. Cliquez sur Aidez-moi à créer une requête pour accéder à l'outil de création de requêtes pour cette ressource spécifique.

Depuis la page Vue d'ensemble du Générateur de requêtes

Accédez à la section Générateur de requêtes de la documentation de référence sur les rapports, puis sélectionnez la ressource que vous souhaitez explorer.

Intégration avec d'autres outils

Le générateur de requêtes est intégré à d'autres outils du kit de développement de l'API Google Ads. Vous pouvez prendre une requête créée dans le Générateur de requêtes et la tester dans l'explorateur d'API ou la valider avec l'outil de validation des requêtes.

API Explorer

Une fois votre requête créée, cliquez sur Essayer dans l'explorateur d'API pour l'ouvrir dans l'explorateur d'API. Votre requête est automatiquement renseignée dans le corps de la requête, et vous pouvez ensuite la tester en l'exécutant par rapport aux données de votre compte. Pour en savoir plus sur cet outil, consultez la page API Explorer.

Outil de validation des requêtes

Lorsque vous cliquez sur Saisir ou modifier une requête, l'outil de validation des requêtes s'ouvre. Utilisez l'outil de validation des requêtes pour valider la syntaxe de votre requête. Toute requête entièrement créée à l'aide du Générateur de requêtes a déjà la syntaxe correcte, mais si vous connaissez la ressource que vous interrogez, l'outil de validation des requêtes vous permet de saisir rapidement une requête et de vérifier sa validité. Pour en savoir plus sur cet outil, consultez la page Outil de validation des requêtes.