Partager via

AdGroupExcludedAudienceSelector

  • Article

Contient les méthodes de filtrage et de tri d’une liste d’audiences exclues d’un groupe d’annonces. Pour plus d’informations sur les sélecteurs, consultez Sélecteurs.

Exemple d’utilisation :

    // Gets the iterator that iterates all ad group excluded audiences
    // in the account.
    var iterator = AdsApp.adGroups().get();

    // Loops through all ad groups in the account.
    while (iterator.hasNext()) {
        var adGroup = iterator.next();

        // Gets the iterator that iterates all ad group excluded audiences
        // in the ad group excluded audience.
        var audienceIterator = adGroup.targeting().audiences()
            .withLimit(10)
            .withIds("123456789")
            .get();
    
        // Loops through all ad group excluded audiences in the ad group excluded audience.
        while (audienceIterator.hasNext()) {
            var audience = audienceIterator.next();
        }
    }

Méthodes

Nom de la méthode Type renvoyé Description
get AdGroupExcludedAudienceIterator Obtient un itérateur utilisé pour itérer dans la liste des audiences exclues des groupes d’annonces.
orderBy(string orderBy) AdGroupExcludedAudienceSelector Applique le classement spécifié aux audiences exclues du groupe d’annonces sélectionnés.
withCondition(string condition) AdGroupExcludedAudienceSelector Applique des critères de filtre aux audiences exclues du groupe d’annonces.
withIds(string[] ids) AdGroupExcludedAudienceSelector Obtient les audiences exclues du groupe d’annonces avec les ID spécifiés.
withLimit(int limit) AdGroupExcludedAudienceSelector Obtient les n premières audiences exclues du groupe d’annonces qui correspondent aux critères de sélection.

Avoir

Obtient un itérateur utilisé pour itérer dans la liste des audiences exclues des groupes d’annonces.

Retourne

Type Description
AdGroupExcludedAudienceIterator Itérateur utilisé pour itérer dans le groupe d’annonces sélectionné des audiences exclues.

orderBy(String orderBy)

Applique le classement spécifié aux audiences exclues du groupe d’annonces sélectionnés.

Spécifiez le paramètre orderBy sous la forme « columnName orderDirection » où :

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

Par exemple, l’appel suivant retourne des audiences exclues de groupe d’annonces 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 dans x par champ y, et ainsi de suite. Si vous spécifiez plusieurs orderBy() appels dans une chaîne ou dans des appels de sélecteur distincts, les scripts commandent la liste des entités à l’aide du champ spécifié dans le dernier orderBy() appel. 

Arguments

Nom Type Description
Orderby string Ordre à appliquer.

Retourne

Type Description
AdGroupExcludedAudienceSelector Sélecteur avec classement appliqué.

withCondition(String condition)

Applique des critères de filtre aux audiences exclues du groupe d’annonces.

Spécifiez le paramètre de condition sous la forme « columnName operator value » 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 d’audiences exclues de groupe d’annonces. Les noms respectent la casse.

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

Column Type Exemple
AdGroupName chaîne Nom du groupe d’annonces de l’association.

withCondition("AdGroupName CONTAINS_IGNORE_CASE 'truck'")
AdGroupStatus Énumération Status du groupe d’annonces de l’association. Les valeurs possibles respectant la casse sont les suivantes :
  • ACTIVÉ
  • PAUSE
  • ENLEVÉ
Cet exemple retourne uniquement les audiences exclues de groupe d’annonces dont le groupe d’annonces parent est suspendu.

withCondition("AdGroupStatus = PAUSED")
AudienceId long ID de l’audience associée.

withCondition("AudienceId = 123456789")
CampaignName string Nom de la campagne qui contient le groupe d’annonces de l’association.

withCondition("CampaignName CONTAINS_IGNORE_CASE 'truck'")
CampaignStatus Énumération Status de la campagne qui contient le groupe d’annonces de l’association. Les valeurs possibles respectant la casse sont les suivantes :
  • ACTIVÉ
  • PAUSE
  • ENLEVÉ
Cet exemple retourne uniquement les audiences exclues de groupe d’annonces dont la campagne parente est suspendue.

withCondition("CampaignStatus = PAUSED")
Statut Énumération Le status de l’association. Les valeurs possibles respectant la casse sont les suivantes :
  • ACTIVÉ
  • PAUSE
  • ENLEVÉ
Cet exemple retourne uniquement les audiences exclues de groupe d’annonces activées.

withCondition("Status = ENABLED")
UserListName string Nom de l’audience associée.

withCondition("UserListName = 'foo'")

Arguments

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

Retourne

Type Description
AdGroupExcludedAudienceSelector Sélecteur avec la condition appliquée.

withIds(string[] ids)

Obtient les audiences exclues du groupe d’annonces 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 AND. Par exemple, l’entité est sélectionnée uniquement si la condition A a la valeur true ET si la condition B a la valeur true. Par exemple, l’appel suivant sélectionne uniquement l’audience 33333 exclu du groupe d’annonces.

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

Arguments

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

Retourne

Type Description
AdGroupExcludedAudienceSelector Sélecteur avec les ID appliqués.

withLimit(int limit)

Obtient les n premières audiences exclues du groupe d’annonces qui correspondent aux critères de sélection.

Arguments

Nom Type Description
limit int Nombre d’audiences exclues du groupe d’annonces à retourner. Le nombre réel peut être inférieur.

Retourne

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