Sélecteurs

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 l'ID est reliée par l'opérateur ET à toutes les autres.

forDateRange()

Est nécessaire lorsqu'une clause de condition ou d'ordonnancement fait référence à Stats (Statistiques), par exemple "CTR" ou "Impressions". Si vous demandez toutes les campagnes ayant enregistré plus de 100 impressions, Les scripts Google Ads doivent 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. Il est particulièrement utile avec orderBy() pour récupérer des éléments comme "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 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 importe: plusieurs appels de cette méthode indiqueront plusieurs clauses de tri, qui s'appliqueront dans l'ordre. Tenez compte des 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. 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 construit, vous pouvez obtenir Iterator à partir de celui-ci en appelant selector.get()

Lisez les bonnes pratiques pour obtenir des conseils. et des astuces pour utiliser efficacement les sélecteurs.