Que sont les sélecteurs ?

  • Article

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 AND. Par exemple, l’entité est sélectionnée uniquement si la condition A a la valeur true ET si la condition B a la valeur true.

  • withIds() : permet de spécifier les ID des entités à sélectionner. Cela équivaut à une clause SQL IN .

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

  • forDateRange() : permet de retourner des entités avec des données de performances qui correspondent à la plage de dates spécifiée. Si une condition spécifie une colonne de métrique, vous devez inclure forDateRange dans la chaîne du sélecteur.

    Exemple : forDateRange("LAST_14_DAYS")

  • orderBy() : permet de classer les entités retournées par le sélecteur par un champ spécifié. Cela équivaut à une clause SQL ORDER BY .

    Exemple : orderBy("Clicks DESC")

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

    Exemple : withLimit(50)

Étant donné que chaque méthode retourne le sélecteur avec les critères de filtre appliqués, vous pouvez chaî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 que vous récupérez 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.

Prochaines étapes

En savoir plus sur les itérateurs