CampaignExcludedAudienceSelector

Contiene los métodos para filtrar y ordenar una lista de públicos excluidos de campaña. Para obtener información sobre los selectores, consulte Selectores.

Ejemplo de uso:

    // Gets the iterator that iterates all campaigns
    // in the account.
    var shoppingCampaign = AdsApp.shoppingCampaigns().withIds(["123456789"]).get();

    // Loops through all campaigns in the account.
    while (iterator.hasNext()) {
        var campaign = iterator.next();

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

Métodos

Nombre del método Tipo de valor devuelto Description
get CampaignExcludedAudienceIterator Obtiene un iterador que se usa para iterar en la lista de públicos excluidos de la campaña.
orderBy(string orderBy) CampaignExcludedAudienceSelector Aplica el orden especificado a los públicos excluidos de la campaña seleccionada.
withCondition(condición de cadena) CampaignExcludedAudienceSelector Aplica criterios de filtro a los públicos excluidos de la campaña.
withIds(string[] ids) CampaignExcludedAudienceSelector Obtiene los públicos excluidos de la campaña con los identificadores especificados.
withLimit(int limit) CampaignExcludedAudienceSelector Obtiene los n mejores públicos excluidos de la campaña que cumplen los criterios de selección.

obtener

Obtiene un iterador que se usa para iterar en la lista de públicos excluidos de la campaña.

Valores devueltos

Tipo Description
CampaignExcludedAudienceIterator Un iterador utilizado para iterar a través de la campaña seleccionada excluyó audiencias.

orderBy(String orderBy)

Aplica el orden especificado a los públicos excluidos de la campaña seleccionada.

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 ordenarán los resultados. Establezca 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 campaña de devoluciones de llamadas excluyó audiencias en orden ascendente por AverageCpc.

selector = selector.orderBy("AverageCpc");

Los selectores admiten entidades de orden por un solo campo. No puede ordenar la lista de entidades por el campo x, y dentro de x por el campo y, etc. Si especifica más de una orderBy() llamada en una cadena o en selectores independientes, los scripts ordenan la lista de entidades mediante el campo especificado en la última orderBy() llamada. 

Argumentos

Nombre Tipo Description
orderBy string La orden de aplicar.

Valores devueltos

Tipo Description
CampaignExcludedAudienceSelector Selector con orden aplicado.

withCondition(condición de cadena)

Aplica criterios de filtro a los públicos excluidos de la campaña.

Especifique el parámetro de condición en el formulario "valor del operador columnName" 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 de 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 de columnas que contienen una matriz de cadenas:

CONTAINS_ALL
CONTAINS_ANY
CONTAINS_NONE

Columnas admitidas

Las columnas admitidas para el filtrado de públicos excluidos de la campaña. Los nombres distinguen mayúsculas de minúsculas.

Las siguientes son las propiedades de entidad que puede especificar.

Column Tipo Ejemplo
AudienceId largo Id. de la audiencia asociada.

withCondition("AudienceId = 123456789")
Nombre de campaña string El nombre de la campaña de la asociación.

withCondition("CampaignName CONTAINS_IGNORE_CASE 'truck'")
CampaignStatus enumeración El estado de la campaña de la asociación. Los valores que pueden distinguir mayúsculas de minúsculas son:
  • HABILITADO
  • EN PAUSA
  • SE QUITÓ
En este ejemplo solo se devuelven los públicos excluidos cuya campaña principal está en pausa.

withCondition("CampaignStatus = PAUSED")
Estado enumeración El estado de la asociación. Los valores que pueden distinguir mayúsculas de minúsculas son:
  • HABILITADO
  • EN PAUSA
  • SE QUITÓ
En este ejemplo solo se devuelven públicos excluidos de campaña habilitados.

withCondition("Status = ENABLED")
Nombre de lista de usuarios string El nombre de la audiencia asociada.

withCondition("UserListName = 'foo'")

Argumentos

Nombre Tipo Description
condición string La condición que se aplicará al selector.

Valores devueltos

Tipo Description
CampaignExcludedAudienceSelector Selector con la condición aplicada.

withIds(string[] ids)

Obtiene los públicos excluidos de la campaña con los identificadores especificados.

Puede aplicar una o más 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 verdadera Y la condición B es verdadera. Por ejemplo, la siguiente llamada selecciona solo la campaña para excluir el público 33333.

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

Argumentos

Nombre Tipo Descripción
ids string[] Una matriz de identificadores de público excluidos de la campaña. Para conocer los límites, consulte Límites de ejecución de scripts.

Valores devueltos

Tipo Description
CampaignExcludedAudienceSelector con los identificadores aplicados.

withLimit(int limit)

Obtiene los n mejores públicos excluidos de la campaña que cumplen los criterios de selección.

Argumentos

Nombre Tipo Description
límite Entero El número de públicos excluidos de la campaña para volver. El número real puede ser menor.

Valores devueltos

Tipo Description
CampaignExcludedAudienceSelector Selector con límite aplicado.
  • Last updated on