Zum Hauptinhalt springen
GET
Rufen Sie die Live-Performance von Google Ads ab, eine Zeile pro Tag, für die Kampagnen, Anzeigengruppen oder Anzeigen, die Sie über Ayrshare erstellt haben.
  • Die Zahlen werden beim Aufruf von Google gelesen, nicht aus einer nächtlichen Kopie.
  • Alle Geldbeträge sind in der Währung des Werbekontos angegeben, die in jeder Zeile in currency zurückgegeben wird.
  • Google lässt Tage ohne Aktivität weg, daher kann ein Zeitraum weniger Zeilen zurückgeben, als er Tage hat.
  • Google passt die Kosten und Conversions eines Tages noch einige Tage nach seinem Ende an, daher können sich die letzten Tage zwischen zwei Abfragen ändern.
  • Verwenden Sie für eine Performance Max-Kampagne level=campaign mit der Kampagnen-ID. Eine Performance Max-Kampagne hat keine eigenen Anzeigen, daher gibt level=ad keine Zeilen zurück.

Header-Parameter

Query-Parameter

string
erforderlich
Worauf sich jede Zeile bezieht: campaign (die campaignId aus der Erstellung), adSet (die adGroupId aus der Erstellung) oder ad (die adId aus der Erstellung).
string
erforderlich
Kommagetrennte Kampagnen-, Anzeigengruppen- oder Anzeigen-IDs, bis zu 50. Sie müssen alle zu einem Werbekonto gehören.
string
Die 10-stellige Google Ads-Kundennummer, mit oder ohne Bindestriche (123-456-7890).Berichte zu Anzeigen und Anzeigengruppen lesen das Werbekonto, das Sie hier angeben. Ohne diese Angabe durchsucht ein Anzeigenbericht alle Werbekonten, die Ihre Google Ads-Verknüpfung erreicht, bis zu 25, und ein Anzeigengruppenbericht funktioniert nur, wenn Ihre Verknüpfung genau ein Werbekonto erreicht. Geben Sie das Konto an, wenn Ihre Verknüpfung mehr als 25 Werbekonten erreicht, oder bei einem Anzeigengruppenbericht mehr als eines. Andernfalls gibt die Anfrage code: 101 zurück.
string
Kommagetrennte Kennzahlen, die zurückgegeben werden sollen. Lassen Sie den Parameter weg, um alle zu erhalten. Siehe Kennzahlen.
string
Standard:"vor 30 Tagen"
Erster Tag im Format YYYY-MM-DD. Google speichert Tageswerte 37 Monate lang; ein älteres startDate gibt code: 101 zurück.
string
Standard:"heute"
Letzter Tag im Format YYYY-MM-DD.

Kennzahlen

actions und conversionValue bleiben 0, bis in Ihrem Google Ads-Konto Conversion-Tracking eingerichtet ist. reach ist nicht verfügbar, da Google für die Suche keine eindeutige Reichweite meldet, und breakdowns sind bei Google nicht verfügbar. Eine Anfrage nach einem der beiden gibt code: 101 zurück.

Paginierung

Alle Zeilen werden in einer Antwort zurückgegeben, daher ist nextCursor immer null.

Fehler