Condividi tramite


Che cosa sono i selettori?

I selettori consentono di applicare criteri di filtro e ordinamento quando si recuperano entità di Microsoft Advertising, ad esempio parole chiave e campagne. I selettori forniscono funzionalità approssimativamente equivalenti alle clausole SQL WHERE e ORDER BY . I selettori includono i metodi seguenti:

  • withCondition() : consente di specificare le condizioni che le entità devono soddisfare per essere selezionate. Equivale a una clausola SQL WHERE .

    Esempio: withCondition('Name STARTS_WITH "Contoso"')

    È possibile applicare una o più condizioni a un selettore. La specifica di più condizioni viene considerata un'operazione AND. Ad esempio, l'entità viene selezionata solo se la condizione A è true E la condizione B è true.

  • withIds() - Consente di specificare gli ID delle entità da selezionare. Equivale a una clausola SQL IN .

    Esempio: withIds(["1","2","3","4"])

  • forDateRange() : consente di restituire entità con dati sulle prestazioni che corrispondono all'intervallo di date specificato. Se una condizione specifica una colonna metrica, è necessario includere forDateRange nella catena del selettore.

    Esempio: forDateRange("LAST_14_DAYS")

  • orderBy() : consente di ordinare le entità restituite dal selettore da un campo specificato. Equivale a una clausola SQL ORDER BY .

    Esempio: orderBy("Clicks DESC")

  • withLimit() : consente di restituire al massimo il numero specificato di entità. Equivale a una clausola SQL TOP .

    Esempio: withLimit(50)

Poiché ogni metodo restituisce il selettore con i criteri di filtro applicati, è possibile concatenare più condizioni (usando la notazione punto) per perfezionare i criteri di filtro. Ad esempio:

var selector = AdsApp.campaigns()
    .withCondition("ClickConversionRate > 0.5")
    .withCondition("Cost > 4.0")
    .forDateRange("LAST_WEEK")
    .withLimit(10);

Per migliorare le prestazioni dello script, usare condizioni di filtro specifiche per assicurarsi di recuperare solo le entità desiderate. Dopo aver ottenuto il selettore, chiamare il get() metodo per recuperare un iteratore usato per scorrere l'elenco di entità.

var campaigns = selector.get();

Oppure

var campaigns = AdsApp.campaigns()
    .withCondition("ClickConversionRate > 0.5")
    .withCondition("Cost > 4.0")
    .forDateRange("LAST_WEEK")
    .withLimit(10)
    .get();

Di seguito è riportato l'elenco dei selettori.

Passaggi successivi