Selettori

I selettori aiutano il programmatore a creare la query che recupera i dati desiderati Entità Google Ads. Con i selettori, è possibile restringere l'elenco delle entità recuperate e ordinarlo. La maggior parte dei selettori ha i seguenti valori: metodo:

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à chesoddisfano 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'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 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 in base ai 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 messe in catena. 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 riscritti 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 Iterator chiamandolo. selector.get().

Per suggerimenti, consulta le best practice e qualche trucchetto su come utilizzare in modo efficiente il selettore.