Compartir a través de

AdGroupExcludedAudienceSelector

  • Artículo

Contiene los métodos para filtrar y ordenar una lista de audiencias excluidas del grupo de anuncios. Para obtener información sobre los selectores, vea Selectores.

Ejemplo de uso:

    // 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étodos

Nombre del método Tipo de valor devuelto Descripción
get AdGroupExcludedAudienceIterator Obtiene un iterador usado para recorrer en iteración la lista de audiencias excluidas del grupo de anuncios.
orderBy(string orderBy) AdGroupExcludedAudienceSelector Aplica el orden especificado a las audiencias excluidas del grupo de anuncios seleccionado.
withCondition(string condition) AdGroupExcludedAudienceSelector Aplica criterios de filtro a las audiencias excluidas del grupo de anuncios.
withIds(string[] ids) AdGroupExcludedAudienceSelector Obtiene audiencias excluidas del grupo de anuncios con los identificadores especificados.
withLimit(int limit) AdGroupExcludedAudienceSelector Obtiene las principales n audiencias excluidas del grupo de anuncios que coinciden con los criterios de selección.

Obtener

Obtiene un iterador usado para recorrer en iteración la lista de audiencias excluidas del grupo de anuncios.

Valores devueltos

Tipo Descripción
AdGroupExcludedAudienceIterator Iterador usado para recorrer en iteración las audiencias excluidas del grupo de anuncios seleccionado.

orderBy(String orderBy)

Aplica el orden especificado a las audiencias excluidas del grupo de anuncios seleccionado.

Especifique el parámetro orderBy en el formulario "columnName orderDirection" donde:

  • columnName es una de las columnas admitidas.
  • orderDirection es el orden en el que se ordenan los resultados. Establezca en ASC para ordenar los resultados en orden ascendente o DESC para ordenar los resultados en orden descendente. El valor predeterminado es ASC.

Por ejemplo, la siguiente llamada devuelve audiencias excluidas del grupo de anuncios en orden ascendente por AverageCpc.

selector = selector.orderBy("AverageCpc");

Los selectores admiten la ordenación de entidades solo por un campo. No puede ordenar la lista de entidades por campo x, y dentro de x por campo y, etc. Si especifica más de una orderBy() llamada en una cadena o en llamadas de selector independientes, Scripts ordena la lista de entidades mediante el campo especificado en la última orderBy() llamada. 

Argumentos

Nombre Tipo Descripción
Orderby string Orden que se va a aplicar.

Valores devueltos

Tipo Descripción
AdGroupExcludedAudienceSelector Selector con orden aplicado.

withCondition(String condition)

Aplica criterios de filtro a las audiencias excluidas del grupo de anuncios.

Especifique el parámetro de condición en el formulario "columnName operator value" donde:

Operadores

El operador que use depende del tipo de columna. Los operadores distinguen mayúsculas de minúsculas. Por ejemplo, use STARTS_WITH en lugar de starts_with.

Operadores para columnas que contienen enteros y valores largos:

<
<=
>
>=
=
!=

Operadores para columnas que contienen valores dobles:

<
>

Operadores para columnas que contienen valores de cadena:

=
!=
STARTS_WITH
STARTS_WITH_IGNORE_CASE
CONTAINS
CONTAINS_IGNORE_CASE
DOES_NOT_CONTAIN
DOES_NOT_CONTAIN_IGNORE_CASE

Operadores para columnas que contienen valores de enumeración:

=
!=
IN []
NOT_IN []

Operadores para columnas que contienen una matriz de cadenas:

CONTAINS_ALL
CONTAINS_ANY
CONTAINS_NONE

Columnas admitidas

Columnas admitidas para el filtrado de público excluido del grupo de anuncios. Los nombres distinguen mayúsculas de minúsculas.

Las siguientes son las propiedades de entidad que puede especificar.

Column Tipo Ejemplo
AdGroupName string Nombre del grupo de anuncios de la asociación.

withCondition("AdGroupName CONTAINS_IGNORE_CASE 'truck'")
AdGroupStatus Enumeración Estado del grupo de anuncios de la asociación. Los posibles valores que distinguen mayúsculas de minúsculas son:
  • HABILITADO
  • PAUSA
  • QUITADO
En este ejemplo solo se devuelven audiencias excluidas del grupo de anuncios cuyo grupo de anuncios primario está en pausa.

withCondition("AdGroupStatus = PAUSED")
AudienceId largo Identificador de la audiencia asociada.

withCondition("AudienceId = 123456789")
CampaignName string Nombre de la campaña que contiene el grupo de anuncios de la asociación.

withCondition("CampaignName CONTAINS_IGNORE_CASE 'truck'")
CampaignStatus Enumeración Estado de la campaña que contiene el grupo de anuncios de la asociación. Los posibles valores que distinguen mayúsculas de minúsculas son:
  • HABILITADO
  • PAUSA
  • QUITADO
En este ejemplo solo se devuelven audiencias excluidas del grupo de anuncios cuya campaña primaria está en pausa.

withCondition("CampaignStatus = PAUSED")
Estado Enumeración Estado de la asociación. Los posibles valores que distinguen mayúsculas de minúsculas son:
  • HABILITADO
  • PAUSA
  • QUITADO
En este ejemplo solo se devuelven audiencias excluidas de grupos de anuncios habilitados.

withCondition("Status = ENABLED")
UserListName string Nombre de la audiencia asociada.

withCondition("UserListName = 'foo'")

Argumentos

Nombre Tipo Descripción
Condición string Condición que se va a aplicar al selector.

Valores devueltos

Tipo Descripción
AdGroupExcludedAudienceSelector Selector con la condición aplicada.

withIds(string[] ids)

Obtiene audiencias excluidas del grupo de anuncios con los identificadores especificados.

Puede aplicar una o varias condiciones a un selector. Una cadena de condiciones se considera una operación AND. Por ejemplo, la entidad solo se selecciona si la condición A es true Y la condición B es true. Por ejemplo, la siguiente llamada selecciona solo el público excluido del grupo de anuncios 33333.

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

Argumentos

Nombre Tipo Descripción
ids string[] Matriz de identificadores de audiencia excluidos del grupo de anuncios. Para conocer los límites, consulte Límites de ejecución de scripts.

Valores devueltos

Tipo Descripción
AdGroupExcludedAudienceSelector Selector con los identificadores aplicados.

withLimit(int limit)

Obtiene las principales n audiencias excluidas del grupo de anuncios que coinciden con los criterios de selección.

Argumentos

Nombre Tipo Descripción
límite Entero Número de audiencias excluidas del grupo de anuncios que se van a devolver. El número real puede ser menor.

Valores devueltos

Tipo Descripción
AdGroupExcludedAudienceSelector Selector con límite aplicado.