Ordinamento e limitazione dei risultati

Google Ads Query Language ti consente di ordinare e limitare le righe restituite nelle risposte alle query utilizzando le clausole ORDER BY e LIMIT.

Ordina i risultati

Puoi specificare l'ordine delle righe nella risposta utilizzando la clausola ORDER BY, che è composta da una o più sequenze separate da virgole di:

FieldName (ASC | DESC)?

Se non specifichi ASC o DESC dopo il nome di un campo, l'API Google Ads utilizza per impostazione predefinita ASC. Se ometti completamente la clausola ORDER BY, l'ordine delle righe restituite non è deterministico.

La seguente clausola ORDER BY ordina un report a livello di campagna in base alle impressioni in ordine decrescente e al nome della campagna in ordine crescente:

ORDER BY metrics.impressions DESC, campaign.name ASC
  • In base agli attributi delle risorse non selezionate
  • In base alle metriche non selezionate
  • In base ai segmenti non selezionati
  • Per i campi dei seguenti tipi:
    • MESSAGE
    • Campi ripetuti
    • Attributi dei campi ripetuti

Limita il numero di risultati

Puoi limitare il numero totale di risultati restituiti utilizzando la clausola LIMIT con un numero intero positivo (1 o superiore; LIMIT 0 non è valido). Se combini questo con l'ordinamento dei risultati, puoi generare report "top N", ad esempio un report contenente le cinque campagne con il maggior numero di impressioni negli ultimi 30 giorni:

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

Filtra risultati

Quando combini i filtri WHERE con ORDER BY e LIMIT, tieni presente le seguenti limitazioni di filtro:

  • Il filtro non è consentito sui segmenti senza selezionarli, ad eccezione dei campi dei segmenti di date "principali" (segments.date, segments.week, segments.month, segments.quarter e segments.year).
  • Il filtro non è consentito direttamente sui campi MESSAGE compositi (ad eccezione dei messaggi wrapper primitivi come Int64Value e StringValue); applica invece il filtro ai relativi campi secondari scalari primitivi (int64, string, bool) o enum.
  • Il filtro non è consentito sugli attributi MESSAGE compositi dei campi ripetuti; è possibile filtrare solo i campi secondari scalari primitivi (int64, string, bool), enum o wrapper primitivi.
Indietro
Distinzione tra maiuscole e minuscole