Que sont les sélecteurs ?

Les sélecteurs vous permettent d’appliquer des critères de filtre et de tri lors de la récupération d’entités Microsoft Advertising telles que des mots clés et des campagnes. Les sélecteurs fournissent des fonctionnalités à peu près équivalentes à SQL WHERE et ORDER BY aux clauses. Les sélecteurs incluent les méthodes suivantes :

  • withCondition() — Permet de spécifier les conditions que les entités doivent remplir pour être sélectionnées. Cela équivaut à une clause SQL WHERE .

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

    Vous pouvez appliquer une ou plusieurs conditions à un sélecteur. La spécification de plusieurs conditions est considérée comme une opération ET. Par exemple, l’entité est sélectionnée uniquement si la condition A est vraie ET la condition B est vraie.

  • withIds() — Permet de spécifier les identifiants des entités à sélectionner. Cela équivaut à une clause SQL IN .

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

  • forDateRange() — Utilisé pour retourner des entités dont les données de performances correspondent à la plage de dates spécifiée. Si une condition spécifie une colonne de métrique, vous devez l’inclure forDateRange dans la chaîne de sélecteur.

    Exemple : forDateRange("LAST_14_DAYS")

  • orderBy() — Permet de classer les entités que le sélecteur renvoie par un champ spécifié. Cela équivaut à une clause SQL ORDER BY .

    Exemple : orderBy("Clicks DESC")

  • withLimit() — Permet de renvoyer au maximum le nombre spécifié d’entités. Cela équivaut à une clause SQL TOP .

    Exemple : withLimit(50)

Étant donné que chaque méthode renvoie le sélecteur avec les critères de filtre appliqués, vous pouvez enchaîner (à l’aide de la notation par points) plusieurs conditions pour affiner les critères de filtre. Par exemple :

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

Pour améliorer les performances des scripts, utilisez des conditions de filtre spécifiques pour vous assurer de récupérer uniquement les entités souhaitées. Après avoir obtenu le sélecteur, appelez la get() méthode pour récupérer un itérateur que vous utilisez pour itérer dans la liste des entités.

var campaigns = selector.get();

Ou

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

Voici la liste des sélecteurs.

Étapes suivantes

En savoir plus sur les itérateurs

  • Dernière mise à jour :