NegativeKeywordListSelector

Contient les méthodes de filtrage et de classement des listes de mots clés négatifs. Pour plus d’informations sur les sélecteurs, consultez Sélecteurs.

Exemple d’utilisation :

    var iterator = AdsApp.negativeKeywordLists()
        .withCondition("MemberCount > 10")
        .orderBy("Name")
        .get();

    while (iterator.hasNext()) {
        var nkwList = iterator.next();
    }

Méthodes

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

Obtenir

Permet à un itérateur d’itérer dans les listes de mots clés négatifs.

Retourne

Type Description
NegativeKeywordListIterator Itérateur utilisé pour itérer dans les listes de mots clés négatifs.

orderBy(string orderBy)

Applique l’ordre spécifié aux listes de mots clés négatifs 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 des listes de mots clés négatifs dans l’ordre croissant par MemberCount.

selector = selector.orderBy("MemberCount");

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
NegativeKeywordListSelector avec classement appliqué.

withCondition(string condition)

Applique des critères de filtre aux listes de mots clés négatifs.

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. Les noms des colonnes sont sensibles à la casse.

Column Type Exemple
MemberCount int Nombre de mots clés négatifs dans la liste.

withCondition("MemberCount > 10")
Nom string Nom de la liste de mots clés négatifs.

withCondition("Name = 'LIST NAME GOES HERE'")
Nombre de références int Nombre de campagnes auxquelles la liste est associée.

withCondition("ReferenceCount > 10")
SharedSetId double ID d’une liste de mots clés négatifs. Si vous utilisez simplement cette méthode pour comparer l’égalité, envisagez plutôt d’utiliser cette withIds méthode.

withCondition("SharedSetId = 123456789")

Arguments

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

Retourne

Type Description
NegativeKeywordListSelector avec la condition appliquée.

withIds(string[] ids)

Obtient les listes de mots clés négatifs 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 la liste des mots clés négatifs 33333.

AdsApp.negativeKeywordLists()
    .withIds(['11111', '22222', '33333'])
    .withIds(['33333', '44444', '55555']);

Arguments

Nom Type Description
Ids string[] Un tableau de mots clés négatifs répertorie les ID. Pour connaître les limites, consultez Limites d’exécution de script.

Retourne

Type Description
NegativeKeywordListSelector avec les ID appliqués.

withLimit(int limit)

Obtient les listes des n principaux mots clés négatifs qui correspondent aux critères de sélection.

Arguments

Nom Type Description
limit int Nombre de listes de mots clés négatifs à renvoyer. Le nombre réel peut être inférieur.

Retourne

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

Voir aussi

  • Last updated on