Les sélecteurs aident le programmeur à créer la requête qui récupère les entités Google Ads demandées. Ils permettent d'affiner la liste des entités récupérées et de les trier. La plupart des sélecteurs comportent les méthodes suivantes :
withCondition()- Ajoute une condition à un sélecteur. Si plusieurs conditions sont utilisées, elles sont combinées avec l'opérateur logique "et". En d'autres termes, le sélecteur ne renvoie que les entités qui remplissent toutes les conditions spécifiées.
withIds()- Ajoute une collection d'ID en tant que condition. Une condition basée sur un ID est combinée avec toutes les autres à l'aide de l'opérateur logique "et".
forDateRange()- Est nécessaire lorsqu'une condition ou une clause de tri fait référence à un champ de statistiques, tel que le CTR ou les impressions. Si vous demandez toutes les campagnes qui ont généré plus de 100 impressions, les scripts Google Ads doivent connaître la période à examiner.
orderBy()- Spécifie l'ordre des entités renvoyées.
withLimit()- Limite le nombre d'entités renvoyées à la valeur spécifiée. Elle est particulièrement utile en combinaison avec
orderBy()pour récupérer des éléments tels que "10 mots clés ayant généré le plus d'impressions hier". Par défaut, tous les sélecteurs définissent la limite sur 50 000. Vous pouvez augmenter cette limite en la spécifiant manuellement.
Vous pouvez appeler ces méthodes dans n'importe quel ordre. Une exception à la règle est orderBy(), pour laquelle l'ordre des appels est important : plusieurs appels à cette méthode spécifient plusieurs clauses de tri, qui s'appliquent dans l'ordre. Prenons l'extrait de code suivant :
selector = selector.forDateRange("LAST_14_DAYS")
.orderBy("metrics.clicks DESC")
.orderBy("metrics.ctr ASC");
Les résultats seront classés en fonction du nombre de clics, dans l'ordre décroissant. Les résultats ayant le même nombre de clics seront classés en fonction du CTR, dans l'ordre croissant.
Les appels aux méthodes d'un sélecteur peuvent être chaînés. Le code ci-dessous
var campaignSelector = AdsApp.campaigns();
campaignSelector.withCondition("metrics.clicks > 10");
campaignSelector.withCondition("metrics.impressions > 1000");
campaignSelector.orderBy("metrics.impressions DESC");
campaignSelector.forDateRange("YESTERDAY");
peut être réécrit d'une façon plus concise :
var campaignSelector = AdsApp.campaigns()
.withCondition("metrics.clicks > 10")
.withCondition("metrics.impressions > 1000")
.orderBy("metrics.impressions DESC")
.forDateRange("YESTERDAY");
Une fois le sélecteur créé, vous pouvez obtenir un
itérateur à partir de celui-ci en appelant
selector.get().
Consultez les bonnes pratiques pour obtenir des conseils et astuces sur l'utilisation efficace des sélecteurs.