Ordinamento e limitazione dei risultati

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

Ordina 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

• Per attributi delle risorse non selezionate
• Per metriche non selezionate
• Per segmenti non selezionati
• Per i campi dei seguenti tipi:
  • MESSAGE
  • Campi ripetuti
  • Attributi dei campi ripetuti

Limitare 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 questa funzionalità 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 filtraggio:

• 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); filtra invece sui relativi campi secondari scalari primitivi (int64, string, bool) o enum.
• Il filtro non è consentito per gli attributi compositi MESSAGE dei campi ripetuti; è possibile filtrare solo i campi secondari scalari primitivi (int64, string, bool), enum o wrapper primitivi.