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 de manière interactive à l'aide du langage de requête Google Ads (GAQL). Que vous soyez novice ou expérimenté avec GAQL, l'outil de création 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 des 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.
  • Moins d'erreurs : en fournissant une interface structurée et des menus déroulants d'options valides, il permet d'éviter les erreurs de syntaxe et de frappe, ce qui garantit la validité de la requête générée.
  • 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 au validateur de 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 permettant d'assembler visuellement des 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 figurera dans la clause FROM. Les ressources représentent des entités dans Google Ads, telles que campaign, ad_group ou keyword_view. Le générateur liste toutes les ressources disponibles.
  2. Choisir 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 (pouvant être jointes de manière implicite). 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 éventuelles erreurs et filtre les combinaisons de champs incompatibles.
  3. Appliquer des filtres : vous pouvez ajouter des conditions de clause WHERE pour filtrer les résultats. Il vous aide à choisir les champs, les opérateurs et les valeurs, en veillant à ce que la syntaxe soit correcte.
  4. Trier les résultats : spécifiez l'ordre de tri à l'aide de la clause ORDER BY.
  5. Définir des limites : ajoutez une clause LIMIT pour contrôler le nombre de résultats renvoyés.
  6. Valider : l'outil vous guide vers des combinaisons de champs valides, mais il fournit également un lien vers l'API Explorer pour vous permettre de tester votre requête par rapport aux données de votre compte. Il existe également un [outil de validation des requêtes](link to page) distinct dans lequel vous pouvez coller et vérifier manuellement les requêtes GAQL écrites.
  7. Exporter : 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 s'assure que les champs, segments et métriques sélectionnés sont compatibles et peuvent être utilisés ensemble dans une même requête, en faisant référence aux métadonnées sous-jacentes de l'API Google Ads.

Premiers pas

Il existe deux façons d'accéder au Générateur de requêtes. Vous pouvez soit consulter une page spécifique de la documentation de référence sur les rapports, soit explorer les données à partir de la page de présentation de l'outil de création de requêtes.

À partir de la documentation de référence sur les rapports

  1. Commencez par consulter 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 M'aider à créer une requête pour accéder au générateur de requêtes de cette ressource spécifique.

Depuis la page d'aperçu du générateur de requêtes

Accédez à la section Query Builder (Outil de requête) de la documentation de référence sur les rapports et sélectionnez la ressource que vous souhaitez explorer.

Intégration à 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 le validateur de 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 sera automatiquement renseignée dans le corps de la requête. Vous pourrez ensuite la tester en l'exécutant sur les 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, le validateur de 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 aura déjà la syntaxe correcte. Toutefois, si vous connaissez la ressource que vous interrogez, le validateur de requêtes vous permettra de saisir rapidement une requête et de vérifier sa validité. Pour en savoir plus sur cet outil, consultez Validateur de requêtes.