Les sélecteurs aident le programmeur à créer la requête qui récupère les entités Google Ads demandées. Les sélecteurs permettent d'affiner et de trier la liste des entités récupérées. La plupart des sélecteurs disposent des méthodes suivantes :
withCondition()- Ajoute une condition à un sélecteur. Si plusieurs conditions sont utilisées, elles sont combinées avec un opérateur 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 sera combinée à toutes les autres avec l'opérateur ET.
forDateRange()- est nécessaire lorsqu'une clause de condition ou de tri fait référence à un champ Stats, tel que "Ctr" ou "Impressions". Si vous demandez toutes les campagnes ayant généré plus de 100 impressions, les scripts Google Ads devront 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. Il 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éfiniront la limite sur 50 000. Vous pouvez augmenter la limite en la spécifiant manuellement.
Vous pouvez appeler ces méthodes dans n'importe quel ordre. Une exception est orderBy(), où l'ordre des appels est important : plusieurs appels à cette méthode spécifieront plusieurs clauses de tri, qui s'appliqueront dans l'ordre. Prenons l'extrait 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 avec des valeurs de clics égales seront classés par 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 construit, 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.