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). Einkeyword
-Bericht mit den Spaltenclicks
,actions
unddate
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 wieconversion
-Berichten. Eincampaign
-Bericht mit den SpaltendailyBudget
undcampaignStartDate
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 inchangedAttributesSinceTimestamp
-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 vonchangedAttributesSinceTimestamp
-Berichten übernommen zu werden), haben normalerweise das Präfix „effektiv“, z. B.effectiveLabelIds
odereffectiveBidStartegy
.