I selettori aiutano il programmatore a creare la query che recupera le entità Google Ads desiderate. Con i selettori, puoi restringere l'elenco delle entità recuperate e ordinarlo. La maggior parte dei selettori ha i seguenti metodi:
withCondition()
- Aggiunge una condizione a un selettore. Se vengono utilizzate più condizioni, queste vengono unite con l'operatore AND; in altre parole, il selettore restituirà solo entità che soddisfano tutte le condizioni specificate.
withIds()
- Aggiunge una raccolta di ID come condizione. Una condizione basata su ID sarà associata a tutte le altre con AND.
forDateRange()
- È necessaria quando una condizione o una clausola di ordinamento fa riferimento a un campo Statistiche, come CTR o Impressioni. Se richiedi tutte le campagne con più di 100 impressioni, gli script Google Ads dovranno conoscere l'intervallo di date da esaminare.
orderBy()
- Specifica l'ordine delle entità restituite.
withLimit()
- Limita il numero di entità restituite al valore specificato. È particolarmente utile in combinazione con
orderBy()
per recuperare elementi come "10 parole chiave con il maggior numero di impressioni ieri". Per impostazione predefinita, tutti i selettori impostano il limite su 50.000. Puoi aumentare il limite specificando manualmente un limite.
Questi metodi possono essere chiamati in qualsiasi ordine. Un'eccezione è orderBy()
, in cui
l'ordine delle chiamate è effettivamente importante: più chiamate a questo metodo specificheranno
più clausole di ordinamento e verranno applicate in ordine. Considera il seguente snippet:
selector = selector.forDateRange("LAST_14_DAYS")
.orderBy("metrics.clicks DESC")
.orderBy("metrics.ctr ASC");
I risultati verranno ordinati per clic in ordine decrescente. I risultati con valori uguali ai clic saranno ordinati per CTR in ordine crescente.
Le chiamate ai metodi di un selettore possono essere concatenate. Il seguente codice
var campaignSelector = AdsApp.campaigns();
campaignSelector.withCondition("metrics.clicks > 10");
campaignSelector.withCondition("metrics.impressions > 1000");
campaignSelector.orderBy("metrics.impressions DESC");
campaignSelector.forDateRange("YESTERDAY");
possono essere riscritte in modo più compatto:
var campaignSelector = AdsApp.campaigns()
.withCondition("metrics.clicks > 10")
.withCondition("metrics.impressions > 1000")
.orderBy("metrics.impressions DESC")
.forDateRange("YESTERDAY");
Una volta creato il selettore, puoi ottenerne un
Iterator chiamando
selector.get()
.
Leggi le best practice per suggerimenti e suggerimenti su un utilizzo efficiente del selettore.