Les sélecteurs aident le programmeur à construire la requête permettant de récupérer les entités Google Ads souhaitées. Les sélecteurs permettent de réduire la liste des entités extraites et de l'ordonner. 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 reliées par l'opérateur AND. En d'autres termes, le sélecteur ne renvoie que les entités qui répondent à toutes les conditions spécifiées.
withIds()- Ajoute un ensemble d'ID en tant que condition. Une condition basée sur l'ID sera reliée à toutes les autres conditions par l'opérateur AND.
forDateRange()- Requis lorsqu'une clause de condition ou de classement fait référence à un champ de statistiques, tel que le CTR ou les impressions. Si vous demandez toutes les campagnes ayant enregistré plus de 100 impressions, les scripts Google Ads devront connaître la plage de dates à 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 lorsqu'elle est utilisée conjointement avec
orderBy()pour extraire des éléments tels que "10 mots clés ayant enregistré le plus d'impressions hier". Par défaut, tous les sélecteurs définissent la limite sur 50 000. Vous pouvez l'augmenter en spécifiant manuellement une limite.
Vous pouvez appeler ces méthodes dans n'importe quel ordre. La seule exception concerne orderBy(), où l'ordre des appels joue de fait un rôle. En cas d'appels multiples de cette méthode, plusieurs clauses de classement sont spécifiées, qui sont appliquées dans l'ordre. Prenons l'exemple de 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 affichant le même nombre de clics seront classés par taux de clics 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 Iterator à partir de celui-ci en appelant selector.get().
Consultez les bonnes pratiques pour obtenir des conseils et des astuces sur l'utilisation des sélecteurs.