Les sélecteurs permettent au programmeur de construire la requête qui récupère entités Google Ads. Les sélecteurs permettent d'affiner la liste des récupérées et les ordonner. La plupart des sélecteurs comportent les éléments suivants : méthodes:
withCondition()- Ajoute une condition à un sélecteur. Si plusieurs conditions sont utilisées, elles sont Lorsqu'ils sont reliés par l'opérateur AND, cela signifie que le sélecteur ne renvoie que les entités qui remplissent toutes les conditions spécifiées.
withIds()- Ajoute un ensemble d'ID en tant que . 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. Il est particulièrement utile en association 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 la limite sera fixée à 50 000. Vous pouvez augmenter la limite en spécifiant manuellement une limite.
Vous pouvez appeler ces méthodes dans n'importe quel ordre. Une exception est orderBy(), où l'ordre des appels est important : plusieurs appels de cette méthode spécifient plusieurs clauses d'ordre, et elles s'appliquent dans l'ordre. Tenez compte des
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. Résultats avec est égal(e) à Les valeurs des clics seront triées 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 créé, vous pouvez en obtenir un itérateur en appelant selector.get().
Consultez les bonnes pratiques pour obtenir des conseils et des astuces sur l'utilisation efficace des sélecteurs.