Selettori

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 connesse insieme con una relazione di tipo AND; in altre parole, il selettore restituirà solo le entità che soddisfano tutte le condizioni specificate.
withIds()
Aggiunge una raccolta di ID come condizione. Una condizione basata su ID verrà unita tramite AND insieme a tutte le altre.
forDateRange()
È necessario quando una condizione o una clausola di ordinamento fa riferimento a un campo Statistiche, ad esempio 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'ordinamento 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 specificandone uno manualmente.

Questi metodi possono essere chiamati in qualsiasi ordine. Un'eccezione è orderBy(), in cui l'ordine delle chiamate è importante: più chiamate a questo metodo specificheranno più clausole di ordinamento, che verranno applicate in ordine. Prendi in esame 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 di clic uguali verranno ordinati in base al 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");

può essere riscritto 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, è possibile ottenere un Iterator chiamando selector.get().

Leggi le best practice per suggerimenti e trucchi sull'utilizzo efficiente dei selettori.