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 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.