Cosa sono i selettori?

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

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

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

    Puoi applicare una o più condizioni a un selettore. Se si specificano più condizioni, viene considerata un'operazione AND. Ad esempio, l'entità viene selezionata solo se la condizione A è vera E la condizione B è vera.

  • withIds() — Da utilizzare per specificare gli ID delle entità da selezionare. Equivale a una clausola SQL IN .

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

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

    Esempio: forDateRange("LAST_14_DAYS")

  • orderBy() — Consente di ordinare le entità restituite dal selettore in base a un campo specificato. Equivale a una clausola SQL ORDER BY .

    Esempio: orderBy("Clicks DESC")

  • withLimit() — Utilizzato per 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 (usando la notazione a punti) più condizioni 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 degli script, utilizza condizioni di filtro specifiche per assicurarti di recuperare solo le entità desiderate. Dopo aver ottenuto il selettore, chiama il get() metodo per recuperare un iteratore che usi per scorrere l'elenco delle 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

Informazioni sugli iteratori

  • Ultimo aggiornamento: