Zamawianie i ograniczanie wyników

Język zapytań Google Ads umożliwia sortowanie i ograniczanie liczby wierszy zwracanych w odpowiedziach na zapytania za pomocą klauzul ORDER BY i LIMIT.

Wyniki zamówienia

Kolejność wierszy w odpowiedzi możesz określić za pomocą klauzuli ORDER BY, która składa się z co najmniej 1 sekwencji rozdzielonej przecinkami:

FieldName (ASC | DESC)?

Jeśli po nazwie pola nie podasz ASC ani DESC, interfejs Google Ads API domyślnie użyje ASC. Jeśli całkowicie pominiesz klauzulę ORDER BY, kolejność zwracanych wierszy będzie niedeterministyczna.

Ta klauzula ORDER BY sortuje raport na poziomie kampanii według malejącej liczby wyświetleń i rosnącej nazwy kampanii:

ORDER BY metrics.impressions DESC, campaign.name ASC
  • Według atrybutów niewybranych zasobów
  • Według niewybranych danych
  • Według niewybranych segmentów
  • W przypadku pól tych typów:
    • MESSAGE
    • Pola powtarzane
    • Atrybuty pól powtarzanych

Ograniczanie liczby wyników

Możesz ograniczyć łączną liczbę zwracanych wyników, używając klauzuli LIMIT z dodatnią liczbą całkowitą (1 lub większą; LIMIT 0 jest nieprawidłowa). W połączeniu z porządkowaniem wyników możesz tworzyć raporty „N najlepszych”, np. raport zawierający 5 kampanii z największą liczbą wyświetleń w ciągu ostatnich 30 dni:

SELECT
  campaign.id,
  campaign.name,
  metrics.impressions
FROM campaign
WHERE segments.date DURING LAST_30_DAYS
ORDER BY metrics.impressions DESC
LIMIT 5

Filtruj wyniki

Podczas łączenia filtrów WHERE z filtrami ORDER BY i LIMIT pamiętaj o tych ograniczeniach filtrowania:

  • Filtrowanie nie jest dozwolone w przypadku segmentów, które nie zostały wybrane, z wyjątkiem „podstawowych” pól segmentów dat (segments.date, segments.week, segments.month, segments.quarter i segments.year).
  • Filtrowanie nie jest dozwolone bezpośrednio w polach złożonych MESSAGE (z wyjątkiem prymitywnych wiadomości opakowujących, takich jak Int64Value i StringValue). Zamiast tego filtruj według ich prymitywnych pól podrzędnych skalarnych (int64, string, bool) lub pól podrzędnych typu wyliczeniowego.
  • Filtrowanie nie jest dozwolone w przypadku złożonych atrybutów MESSAGE pól powtarzanych. Filtrować można tylko proste pola podrzędne skalarne (int64, string, bool), wyliczeniowe lub proste pola podrzędne opakowania.
Wstecz
Rozróżnianie wielkości liter