AssetGroupSelector

Contient les méthodes de filtrage et de tri d’une liste de groupes de ressources. Pour plus d’informations sur les sélecteurs, consultez Sélecteurs.

Exemple d’utilisation :

    var iterator = Campaign.assetGroups()
        .withCondition("ClickConversionRate > 0.3")
        .forDateRange("LAST_WEEK")
        .orderBy("Clicks DESC")
        .get();

    while (iterator.hasNext()) {
        var assetGroup = iterator.next();
        var metrics = assetGroup.getStats();
    }

Méthodes

Nom de la méthode Type renvoyé Description
get AssetGroupIterator Permet d’utiliser un itérateur pour itérer dans la liste des groupes de ressources.
orderBy(string orderBy) AssetGroupSelector Applique l’ordre spécifié aux groupes de ressources sélectionnés.
withCondition(string condition) AssetGroupSelector Applique des critères de filtre aux groupes de ressources.
withIds(string[] ids) AssetGroupSelector Obtient les groupes de ressources avec les ID spécifiés.
withLimit(int limit) AssetGroupSelector Obtient les n principaux groupes de ressources qui correspondent aux critères de sélection.

Obtenir

Permet d’utiliser un itérateur pour itérer dans la liste des groupes de ressources.

Retourne

Type Description
AssetGroupIterator Itérateur utilisé pour itérer dans les groupes de ressources sélectionnés.

orderBy(String orderBy)

Applique l’ordre spécifié aux groupes de ressources sélectionnés.

Spécifiez le paramètre orderBy au format « columnName orderDirection » où :

  • columnName est l’une des colonnes prises en charge.
  • orderDirection est l’ordre dans lequel trier les résultats. Réglez sur ASC pour classer les résultats dans l’ordre croissant ou DESC pour classer les résultats dans l’ordre décroissant. La valeur par défaut est ASC.

Par exemple, l’appel suivant retourne les groupes de ressources dans l’ordre croissant en fonction de AverageCpc.

selector = selector.orderBy("AverageCpc");

Les sélecteurs prennent en charge le classement des entités par un seul champ. Vous ne pouvez pas classer la liste des entités par champ x, et au sein de x par champ y, etc. Si vous spécifiez plusieurs orderBy() appels dans une chaîne ou dans des appels de sélecteur distincts, Scripts ordonne la liste des entités à l’aide du champ spécifié dans le dernier orderBy() appel. 

Arguments

Nom Type Description
orderBy string L’ordre à appliquer.

Retourne

Type Description
AssetGroupSelector avec classement appliqué.

withCondition(condition de chaîne)

Applique des critères de filtre aux groupes de ressources.

Spécifiez le paramètre de condition au format « valeur de l’opérateur columnName » où :

Opérateurs

L’opérateur que vous utilisez dépend du type de la colonne. Les opérateurs respectent la casse. Par exemple, utilisez STARTS_WITH au lieu de starts_with.

Opérateurs pour les colonnes qui contiennent des entiers et des valeurs longues :

<
<=
>
>=
=
!=

Opérateurs pour les colonnes qui contiennent des valeurs doubles :

<
>

Opérateurs pour les colonnes qui contiennent des valeurs de chaîne :

=
!=
STARTS_WITH
STARTS_WITH_IGNORE_CASE
CONTAINS
CONTAINS_IGNORE_CASE
DOES_NOT_CONTAIN
DOES_NOT_CONTAIN_IGNORE_CASE

Opérateurs pour les colonnes qui contiennent des valeurs d’énumération :

=
!=
IN []
NOT_IN []

Opérateurs pour les colonnes qui contiennent un tableau de chaînes :

CONTAINS_ALL
CONTAINS_ANY
CONTAINS_NONE

Colonnes prises en charge

Colonnes prises en charge pour le filtrage des groupes de ressources. Les noms sont sensibles à la casse.

Voici les colonnes de métriques de performances que vous pouvez spécifier.

Column Type Exemple
AbsoluteTopImpressionRate double withCondition("AbsoluteTopImpressionRate > 0.25")
AverageCpc double withCondition("AverageCpc < 2.75")
AverageCpm double withCondition("AverageCpm > 0.65")
Taux de conversion des clics double withCondition("ClickConversionRate > 0.25")
Clics long withCondition("Clicks >= 33")
ConvertedClicks long withCondition("ConvertedClicks >= 10")
Cost double withCondition("Cost > 3.25")

Le coût est exprimé dans la devise du compte.
Ctr double withCondition("Ctr > 0.05")

Le CTR est de l’ordre de 0..1, donc utilisez 0.05 pour un CTR de 5 %.
Impressions long withCondition("Impressions > 10")
TopImpressionRate double withCondition("TopImpressionRate > 0.25")

Voici les propriétés d’entité que vous pouvez spécifier.

Column Type Exemple
Statut énumération Le status du groupe de ressources. Les valeurs possibles respectant la casse sont les suivantes :
  • ACTIVÉ
  • PAUSE
  • SUPPRIMÉ
Cet exemple renvoie uniquement les groupes de ressources activés.

withCondition("Status = ENABLED")
Nom string Nom du groupe de ressources.

withCondition("Name CONTAINS_IGNORE_CASE 'sport'")
Nom de campagne string Nom de la campagne.

withCondition("CampaignName CONTAINS_IGNORE_CASE 'truck'")
KeywordMaxCpc double Enchère au CPC du groupe de ressources. L’enchère est exprimée dans la devise du compte.

withCondition("KeywordMaxCpc > 5.0")
CampaignStatus (CampaignStatus) énumération Le status de la campagne. Les valeurs possibles respectant la casse sont les suivantes :
  • ACTIVÉ
  • PAUSE
  • SUPPRIMÉ
Cet exemple renvoie uniquement les groupes de ressources dont la campagne parente est suspendue.

withCondition("CampaignStatus = PAUSED")
Noms d’étiquette jeu de chaînes Liste d’un ou plusieurs noms d’étiquette respectant la casse. Permet d’obtenir les groupes de ressources associés aux étiquettes nommées.

withCondition("LabelNames CONTAINS_ANY ['bar', 'foo']")
Type de campagne énumération Type de campagne. Les valeurs possibles respectant la casse sont les suivantes :
  • SEARCH_AND_CONTENT
  • ACHATS
  • DYNAMIC_SEARCH_ADS
Cet exemple renvoie uniquement les groupes de ressources dont le type de campagne parent est Achats.

withCondition("CampaignType = SHOPPING")

Arguments

Nom Type Description
Condition physique string Condition à appliquer au sélecteur.

Retourne

Type Description
AssetGroupSelector avec la condition appliquée.

withIds(string[] ids)

Obtient les groupes de ressources avec les ID spécifiés.

Vous pouvez appliquer une ou plusieurs conditions à un sélecteur. Une chaîne de conditions est considérée comme une opération ET. Par exemple, l’entité est sélectionnée uniquement si la condition A est vraie ET la condition B est vraie. Par exemple, l’appel suivant sélectionne uniquement le groupe de ressources 33333.

var selector = Campaign.assetGroups()
    .withIds(['11111', '22222', '33333'])
    .withIds(['33333', '44444', '55555']);

Arguments

Nom Type Description
Ids string[] Tableau d’ID de groupe de ressources. Pour connaître les limites, consultez Limites d’exécution de script.

Retourne

Type Description
AssetGroupSelector avec les ID appliqués.

withLimit(int limit)

Obtient les n principaux groupes de ressources qui correspondent aux critères de sélection.

Arguments

Nom Type Description
limit int Nombre de groupes de ressources à renvoyer. Le nombre réel peut être inférieur.

Retourne

Type Description
AssetGroupSelector Sélecteur avec limite appliquée.

Voir aussi

Campaign.assetGroups()

  • Dernière mise à jour :