Selettori

I selettori aiutano il programmatore a creare la query che recupera le entità Google Ads richieste. Con i selettori, è possibile 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 le entità che soddisfano tutte le condizioni specificate.
withIds()
Aggiunge una raccolta di ID come condizione. Una condizione basata sull'ID verrà combinata con tutte le altre tramite l'operatore AND.
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 oltre 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 a 50.000. Puoi aumentare il limite specificandolo manualmente.

Questi metodi possono essere chiamati in qualsiasi ordine. Un'eccezione è orderBy(), in cui l'ordine delle chiamate è importante: più chiamate a questo metodo specificano più clausole di ordinamento e vengono applicate in ordine. Considera lo snippet seguente:

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 riscritta in modo più compatto:

var campaignSelector = AdsApp.campaigns()
  .withCondition("metrics.clicks > 10")
  .withCondition("metrics.impressions > 1000")
  .orderBy("metrics.impressions DESC")
  .forDateRange("YESTERDAY");

Una volta costruito il selettore, è possibile ottenere un iteratore chiamando selector.get().

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