Raporty przyrostowe
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Dostępny jest już nowy interfejs Search Ads 360 Reporting API. Nowy interfejs API daje większą swobodę tworzenia raportów niestandardowych oraz integrowania danych z aplikacjami i procesami służącymi do raportowania. Dowiedz się więcej o przechodzeniu na
nowy interfejs Search Ads 360 Reporting API i jego używaniu.
Zamiast otrzymywania zrzutu wszystkich danych za każdym razem, gdy poprosisz o wygenerowanie raportu, możesz co jakiś czas wysyłać żądania tylko tych danych, które zmieniły się od czasu ostatniego raportu. Takie raporty przyrostowe będą prawdopodobnie znacznie mniejsze niż pełny raport.
Jeśli żądasz raportów przyrostowych, pamiętaj o następujących kwestiach:
- Nadal warto co jakiś czas wysyłać prośby o pełny raport na wypadek, gdyby niektóre stopniowe zmiany zostały utracone. Jeśli na przykład w styczniu poprosisz o cotygodniowe raporty przyrostowe, pod koniec lutego musisz poprosić o pełny raport za styczeń, aby otrzymać wszystkie dane ze stycznia.
- Ponieważ Search Ads 360 nawet podejrze, że element uległ zmianie, nie zawsze można sprawdzić, czy coś się zmieniło. Raport przyrostowy będzie zawierał element. Oznacza to, że raporty przyrostowe mogą zawierać dane, które się nie zmieniły.
Aby wysłać żądanie raportu przyrostowego, określ jedną z tych właściwości Reports.request.timeRange
:
changedMetricsSinceTimestamp=timestampWskaźniki żądań, które zmieniły się od określonej sygnatury czasowej. Wskaźniki są przechowywane z podziałem na poszczególne dni i mogą się zmieniać tylko w jednym dniu, dlatego żądania należy posegmentować według dnia (musi być dostępna kolumna date). Na przykład raport keyword z kolumnami clicks, actions i date zwróci wiersz dla każdego słowa kluczowego i daty, w której zarejestrowana liczba kliknięć lub działań zmieniła się od podanej sygnatury czasowej.
Sygnatura czasowa nie może przypadać wcześniej niż 8 dni przed przesłaniem prośby. Aby rejestrować wszystkie zmieniające się wskaźniki, wysyłaj żądanie changedMetricsSinceTimestamp co najmniej raz na 7 dni i generuj pełny raport dla każdej daty po ustabilizowaniu się danych (bezpieczniejsze jest odczekać co najmniej 7 dni). Przykładowy wzorzec polega na tworzeniu 2 raportów każdego dnia: raportu przyrostowego danych, które zmieniły się w ciągu ostatnich 36 godzin, oraz pełnego raportu obejmującego dane sprzed 8 dni.
changedAttributesSinceTimestamp=timestampAtrybuty żądań, które zmieniły się od podanej sygnatury czasowej. Żądanie changedAttributesSinceTimestamp może zawierać tylko kolumny atrybutów (nie może zawierać kolumn danych ani segmentów). Nie działa w przypadku nieprzetworzonych raportów o zdarzeniach, takich jak raporty conversion. Na przykład raport campaign z kolumnami dailyBudget i campaignStartDate zwróci wiersz dla każdej kampanii, której budżet dzienny lub data rozpoczęcia uległy zmianie od podanej sygnatury czasowej.
Pamiętaj, że zmiany w atrybutach nadrzędnych nie są rejestrowane w raportach changedAttributesSinceTimestamp. Słowo kluczowe może na przykład dziedziczyć strategię ustalania stawek z nadrzędnej grupy reklam.
To słowo kluczowe może się nie pojawiać w raporcie, nawet jeśli do grupy reklam zostanie przypisana nowa strategia ustalania stawek. Kolumny atrybutów, których wartości zależą od encji nadrzędnych (i dlatego mogą się zmieniać bez ich pobierania przez raporty changedAttributesSinceTimestamp), mają zwykle prefiks „efektywny”, np. effectiveLabelIds lub effectiveBidStartegy.
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2023-12-14 UTC.
[null,null,["Ostatnia aktualizacja: 2023-12-14 UTC."],[[["\u003cp\u003eThe new Search Ads 360 Reporting API offers increased flexibility for creating custom reports and integrating data into your workflows.\u003c/p\u003e\n"],["\u003cp\u003eIncremental reports allow you to retrieve only the data that has changed since your last request, making reports smaller and more efficient.\u003c/p\u003e\n"],["\u003cp\u003eIt is recommended to periodically request full reports in addition to incremental reports to ensure all data is captured.\u003c/p\u003e\n"],["\u003cp\u003eIncremental reports can be requested based on either changed metrics or changed attributes using specific time range properties.\u003c/p\u003e\n"],["\u003cp\u003eWhile \u003ccode\u003echangedAttributesSinceTimestamp\u003c/code\u003e requests provide efficient updates for attributes, changes to parent attributes might not be reflected, necessitating awareness of potential data discrepancies.\u003c/p\u003e\n"]]],["The new Search Ads 360 Reporting API allows users to build custom reports and integrate data into their applications. It offers incremental reports, which retrieve only data that has changed since the last request, reducing report size. Users can request changes in metrics (`changedMetricsSinceTimestamp`) or attributes (`changedAttributesSinceTimestamp`). Full reports are still recommended periodically to ensure no data is missed. For `changedMetricsSinceTimestamp`, data must be segmented by day and should be requested every seven days. Changed attributes only report changes to the attribute itself, not inherited changes from parent.\n"],null,["# Incremental Reports\n\nThe new Search Ads 360 Reporting API is now available. The new API provides enhanced flexibility to build custom reports and integrate the data into your reporting applications and processes. Learn more about migrating to and using the [new Search Ads 360 Reporting\nAPI](https://developers.google.com/search-ads/reporting/overview).\nInstead of receiving a dump of all data every time you request a report, you can\nperiodically request only the data that has changed since your last report. These\nincremental reports will likely be significantly smaller than a full report.\n\nIf you request incremental reports, you should be aware of the following:\n\n- It's still a good idea to request a full report every once in a while, just in case some incremental changes are lost. For example, if you request weekly incremental reports during January, at the end of February you should request a full report for January to make sure you get all of the January data.\n- Since it isn't always possible to determine if some entities have changed, an incremental report will contain an entity if Search Ads 360 even *suspects* that the entity has changed. This means that incremental reports might contain data that hasn't changed.\n\n\nTo request an incremental report, specify one of the following ` `[Reports.request.timeRange](/search-ads/v2/reference/reports#request.timeRange)`\n` properties:\n\n`changedMetricsSinceTimestamp=`*timestamp*\n\n: Requests metrics that have changed since the specified timestamp. Because metrics are\n stored at a daily granularity and might change for one day but not another, such\n requests must be segmented by day (the `date` column must be present). For\n example, a `keyword` report with the columns\n `clicks`, `actions`, and `date`, would\n return a row for each keyword and date in which the recorded number of\n clicks or actions has changed since the given timestamp.\n\n\n The timestamp must be no earlier than 8 days before the time of request. To capture\n all of the changing metrics, be sure to make a `changedMetricsSinceTimestamp`\n request at least once every 7 days, and make a full report for each date\n once the metrics have settled (it is safer to wait at least 7 days). An\n example pattern is to create two reports every day: an incremental\n report for metrics that have changed in the last 36 hours, and a full\n report for metrics that occurred 8 days ago.\n\n`changedAttributesSinceTimestamp=`*timestamp*\n\n: Requests attributes that have changed since the given timestamp. A\n `changedAttributesSinceTimestamp` request can only include\n attribute columns (no metric or segment columns), and does not work for\n raw event reports such as\n [`conversion`](/search-ads/v2/report-types/conversion) reports. For example, a\n `campaign` report with the columns `dailyBudget`\n and `campaignStartDate` would return a row for each campaign\n whose daily budget or start date has changed since the given timestamp.\n\n\n Note that changes to parent attributes are not captured in `changedAttributesSinceTimestamp` reports. For example a keyword may inherit its bid strategy from the parent ad group. Even if the ad group is assigned a new bid strategy, this keyword might not appear in the report. Attribute columns whose value depends on parent entities (and therefore could change without getting picked up by `changedAttributesSinceTimestamp` reports) usually have the prefix \"effective\", such as `effectiveLabelIds` or `effectiveBidStartegy`.\n\n \u003cbr /\u003e"]]
