Passer au contenu principal
GET
Obtenez en direct les performances Google Ads, une ligne par jour, pour les campagnes, groupes d’annonces ou annonces que vous avez créés via Ayrshare.
  • Les chiffres sont lus chez Google au moment de l’appel, et non depuis une copie nocturne.
  • Tous les montants sont dans la devise du compte publicitaire, renvoyée dans currency sur chaque ligne.
  • Google omet les jours sans activité : une période peut donc renvoyer moins de lignes qu’elle ne compte de jours.
  • Google ajuste le coût et les conversions d’une journée pendant quelques jours après sa fin : les jours récents peuvent donc changer d’une lecture à l’autre.
  • Pour une campagne Performance Max, utilisez level=campaign avec l’ID de la campagne. Une campagne Performance Max n’a pas d’annonces propres : level=ad ne renvoie donc aucune ligne.

Paramètres d’en-tête

Paramètres de requête

string
requis
Ce sur quoi porte chaque ligne : campaign (le campaignId renvoyé par la création), adSet (l’adGroupId renvoyé par la création) ou ad (l’adId renvoyé par la création).
string
requis
ID de campagnes, de groupes d’annonces ou d’annonces séparés par des virgules, jusqu’à 50. Ils doivent tous appartenir au même compte publicitaire.
string
L’ID client Google Ads à 10 chiffres, avec ou sans tirets (123-456-7890).Les rapports par annonce et par groupe d’annonces lisent le compte publicitaire que vous indiquez ici. Sans lui, un rapport par annonce recherche dans tous les comptes publicitaires que votre association Google Ads atteint, jusqu’à 25, et un rapport par groupe d’annonces ne fonctionne que si votre association atteint un seul compte publicitaire. Indiquez le compte lorsque votre association atteint plus de 25 comptes publicitaires, ou plus d’un pour un rapport par groupe d’annonces. Sinon, la requête renvoie code: 101.
string
Indicateurs à renvoyer, séparés par des virgules. Omettez-le pour les obtenir tous. Consultez Indicateurs.
string
défaut:"il y a 30 jours"
Premier jour, au format YYYY-MM-DD. Google conserve les chiffres quotidiens pendant 37 mois ; une startDate plus ancienne renvoie code: 101.
string
défaut:"aujourd'hui"
Dernier jour, au format YYYY-MM-DD.

Indicateurs

actions et conversionValue restent à 0 tant que le suivi des conversions n’est pas configuré dans votre compte Google Ads. reach n’est pas disponible, car Google ne fournit pas de couverture unique pour le Réseau de Recherche, et les breakdowns ne sont pas disponibles sur Google. Demander l’un ou l’autre renvoie code: 101.

Pagination

Toutes les lignes sont renvoyées dans une seule réponse : nextCursor vaut donc toujours null.

Erreurs