Les sélecteurs aident le programmeur à construire la requête qui extrait les entités Google Ads souhaitées. Les sélecteurs permettent de restreindre la liste des entités récupérées et de l'ordonner. La plupart des sélecteurs proposent les méthodes suivantes:
withCondition()
- Ajoute une condition à un sélecteur. Si plusieurs conditions sont utilisées, elles sont reliées par un opérateur ET. 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 un ID sera associée à toutes les autres par l'opérateur AND.
forDateRange()
- est nécessaire lorsqu'une clause de condition ou de tri fait référence à un champ Statistiques, tel que CTR ou Impressions. Si vous demandez toutes les campagnes ayant enregistré 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 conjonction avec
orderBy()
afin de récupérer des résultats de type "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 augmenter la limite 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 est effectivement important: plusieurs appels de cette méthode spécifient plusieurs clauses d'ordonnancement, 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 affichant le même nombre de clics 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 des astuces sur l'utilisation efficace des sélecteurs.