ProductGroupSelector

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

Exemple d’utilisation :

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

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

Méthodes

Nom de la méthode Type renvoyé Description
forDateRange(Object dateFrom, Object dateTo) ProductGroupSelector Applique les dates de début et de fin de la sélection des métriques de performances.
forDateRange(string dateRange) ProductGroupSelector Applique la plage de dates prédéfinie pour la sélection des métriques de performances.
get ProductGroupIterator Permet d’utiliser un itérateur pour parcourir la liste des groupes de produits.
orderBy(string orderBy) ProductGroupSelector Applique l’ordre spécifié aux groupes de produits sélectionnés.
withCondition(string condition) ProductGroupSelector Applique des critères de filtre aux groupes de produits.
withIds(string[] ids) ProductGroupSelector Obtient les groupes de produits avec les ID spécifiés.
withLimit(int limit) ProductGroupSelector Obtient les n premiers groupes de produits qui correspondent aux critères de sélection.

forDateRange(Object dateFrom, Object dateTo)

Applique les dates de début et de fin de la sélection des métriques de performances.

Spécifiez une plage de dates uniquement si :

  • Vous appliquez des conditions ou un ordre qui font référence à des champs de métrique de performances.
  • Vous souhaitez obtenir les données de performances des objets que vous sélectionnez. Par exemple, si vous prévoyez d’appeler la getStats() méthode.

Vous pouvez spécifier les paramètres de date à l’aide de chaînes ou d’objets. Pour utiliser des chaînes, spécifiez la date au format AAAAMMJJ. Si vous utilisez des objets, créez un objet avec les champs suivants :

  • year
  • month
  • jour

Par exemple :

var date = {year: 2018, month: 5, day: 13};

Le mois est basé sur une base, où 1 correspond à janvier et 12 à décembre.

La plage de dates est inclusive. Si vous spécifiez plusieurs plages de dates, seule la dernière plage de dates est utilisée.

Arguments

Nom Type Description
dateFrom Objet Date de début de la plage de dates qui spécifie les données de performances à inclure dans le sélecteur.
dateTo Objet Date de fin de la plage de dates qui spécifie les données de performances à inclure dans le sélecteur.

Retourne

Type Description
ProductGroupSelector Sélecteur avec plage de dates appliquée.

forDateRange(String dateRange)

Applique la plage de dates prédéfinie pour la sélection des métriques de performances.

Spécifiez une plage de dates uniquement si :

  • Vous appliquez des conditions ou un ordre qui font référence à des champs de métrique de performances.
  • Vous souhaitez obtenir les données de performances des objets que vous sélectionnez. Par exemple, si vous prévoyez d’appeler la getStats() méthode.

Si vous spécifiez plusieurs plages de dates, seule la dernière plage de dates est utilisée.

Valeurs de plage de dates prises en charge :

  • TODAY
  • HIER
  • LAST_WEEK
  • LAST_BUSINESS_WEEK
  • LAST_7_DAYS
  • THIS_WEEK_SUN_TODAY
  • LAST_14_DAYS
  • LAST_30_DAYS
  • LAST_WEEK_SUN_SAT
  • THIS_MONTH
  • LAST_MONTH
  • ALL_TIME

Arguments

Nom Type Description
dateRange String Chaîne de plage de dates prédéfinie qui spécifie les données de performances à inclure dans le sélecteur. La chaîne de plage de dates prédéfinie est sensible à la casse.

Retourne

Type Description
ProductGroupSelector Sélecteur avec plage de dates appliquée.

Obtenir

Permet d’utiliser un itérateur pour parcourir la liste des groupes de produits.

Retourne

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

orderBy(String orderBy)

Applique l’ordre spécifié aux groupes de produits 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 renvoie les groupes de produits dans l’ordre croissant par 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
ProductGroupSelector avec classement appliqué.

withCondition(condition de chaîne)

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

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 produits. 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
Groupe de produits string Valeur du groupe de produits. Par exemple, si le chemin d’accès est « Tous les produits > Articles de sport Sports d’hiver >> Ski Skis > Skis > de descente Neufs > », vous pouvez définir l’opérande sur Skis.

withCondition("ProductGroup = Skis")

Le sélecteur inclut le groupe de produits Skis et son groupe de produits « autre casse », s’il existe.

Notez que vous ne pouvez pas spécifier 'OtherCase' comme opérande.
Enchère double Montant de l’offre. Renvoie tous les groupes de produits qui correspondent à la condition d’enchère.

withCondition("Bid < 2.75")

L’utilisation de '<' retourne les groupes dont le montant de l’enchère au CPC est inférieur au montant spécifié ou défini sur null. Pour empêcher le sélecteur d’inclure la casse null, utilisez par exemple .withCondition("Bid < 2.75").withCondition("Bid > 0.0").

Arguments

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

Retourne

Type Description
ProductGroupSelector avec la condition appliquée.

withIds(string[] ids)

Obtient les groupes de produits 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 produits 33333.

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

Arguments

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

Retourne

Type Description
ProductGroupSelector avec les ID appliqués.

withLimit(int limit)

Obtient les n premiers groupes de produits qui correspondent aux critères de sélection.

Arguments

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

Retourne

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

Voir aussi

AdsApp.productGroups()AdGroup.productGroups()

  • Last updated on