Raporty przyrostowe

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=timestamp

Wskaź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=timestamp

Atrybuty żą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.