Inkrementelle Berichte

Die neue Search Ads 360 Reporting API ist jetzt verfügbar. Die neue API bietet mehr Flexibilität, um benutzerdefinierte Berichte zu erstellen und die Daten in Ihre Berichtsanwendungen und -prozesse zu integrieren. Weitere Informationen zur Migration zur neuen Search Ads 360 Reporting API und zu ihrer Verwendung

Anstatt jedes Mal, wenn Sie einen Bericht anfordern, einen Dump aller Daten zu erhalten, können Sie regelmäßig nur die Daten anfordern, die sich seit dem letzten Bericht geändert haben. Diese inkrementellen Berichte sind wahrscheinlich deutlich kleiner als ein vollständiger Bericht.

Wenn Sie inkrementelle Berichte anfordern, beachten Sie Folgendes:

  • Es empfiehlt sich trotzdem, gelegentlich einen vollständigen Bericht anzufordern, für den Fall, dass inkrementelle Änderungen verloren gehen. Wenn Sie beispielsweise wöchentliche inkrementelle Berichte im Januar anfordern, sollten Sie Ende Februar einen vollständigen Bericht für Januar anfordern, um sicherzustellen, dass Sie alle Januardaten erhalten.
  • Da es nicht immer möglich ist, festzustellen, ob sich einige Entitäten geändert haben, enthält ein inkrementeller Bericht eine Entität, falls Search Ads 360 auch verdacht, dass die Entität geändert wurde. Dies bedeutet, dass inkrementelle Berichte Daten enthalten können, die sich nicht geändert haben.

Gib eine der folgenden Reports.request.timeRange -Properties an, um einen inkrementellen Bericht anzufordern:

changedMetricsSinceTimestamp=timestamp

Fordert Messwerte an, die sich seit dem angegebenen Zeitstempel geändert haben. Da Messwerte mit einem täglichen Detaillierungsgrad gespeichert werden und sich nur über einen Tag hinweg ändern können, müssen solche Anfragen nach Tag segmentiert werden (die Spalte date muss vorhanden sein). Ein keyword-Bericht mit den Spalten clicks, actions und date würde beispielsweise eine Zeile für jedes Keyword und jedes Datum zurückgeben, bei dem sich die aufgezeichnete Anzahl von Klicks oder Aktionen seit dem angegebenen Zeitstempel geändert hat.

Der Zeitstempel darf nicht früher als acht Tage vor dem Zeitpunkt der Anfrage liegen. Damit alle sich ändernden Messwerte erfasst werden, sollten Sie mindestens alle 7 Tage eine changedMetricsSinceTimestamp-Anfrage senden und für jedes Datum einen vollständigen Bericht erstellen, sobald sich die Messwerte eingegrenzt haben. Es ist sicherer, mindestens 7 Tage zu warten. Ein Beispiel dafür ist, täglich zwei Berichte zu erstellen: einen inkrementellen Bericht für Messwerte, die sich in den letzten 36 Stunden geändert haben, und einen vollständigen Bericht für Messwerte, die vor 8 Tagen aufgetreten sind.

changedAttributesSinceTimestamp=timestamp

Fordert Attribute an, die sich seit dem angegebenen Zeitstempel geändert haben. Eine changedAttributesSinceTimestamp-Anfrage kann nur Attributspalten (keine Messwert- oder Segmentspalten) enthalten und funktioniert nicht bei Rohereignisberichten wie conversion-Berichten. Ein campaign-Bericht mit den Spalten dailyBudget und campaignStartDate würde beispielsweise eine Zeile für jede Kampagne zurückgeben, deren Tagesbudget oder Startdatum sich seit dem angegebenen Zeitstempel geändert haben.

Änderungen an übergeordneten Attributen werden in changedAttributesSinceTimestamp-Berichten nicht erfasst. Beispielsweise kann ein Keyword die Gebotsstrategie von der übergeordneten Anzeigengruppe übernehmen. Auch wenn der Anzeigengruppe eine neue Gebotsstrategie zugewiesen ist, erscheint dieses Keyword möglicherweise nicht im Bericht. Attributspalten, deren Wert von übergeordneten Entitäten abhängt (und sich daher ändern können, ohne von changedAttributesSinceTimestamp-Berichten übernommen zu werden), haben normalerweise das Präfix „effektiv“, z. B. effectiveLabelIds oder effectiveBidStartegy.