AdGroupExcludedAudienceSelector

Contém os métodos para filtrar e classificar uma lista de públicos excluídos do grupo de anúncios. Para obter informações sobre seletores, consulte Seletores.

Exemplo de utilização:

    // 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();
        }
    }

Metodologia

Nome do método Tipo de Devolução Descrição
Obter AdGroupExcludedAudienceIterator Obtém um iterador usado para iterar através da lista de públicos excluídos do grupo de anúncios.
orderBy(string orderBy) AdGroupExcludedAudienceSelector Aplica a ordenação especificada aos públicos-alvo excluídos do grupo de anúncios selecionado.
withCondition(condição string) AdGroupExcludedAudienceSelector Aplica critérios de filtro aos públicos-alvo excluídos do grupo de anúncios.
withIds(string[] ids) AdGroupExcludedAudienceSelector Obtém públicos-alvo excluídos do grupo de anúncios com os IDs especificados.
withLimit(int limit) AdGroupExcludedAudienceSelector Obtém os primeiros n grupos de anúncios excluídos públicos que correspondem aos critérios de seleção.

Obter

Obtém um iterador usado para iterar através da lista de públicos excluídos do grupo de anúncios.

Devoluções

Tipo Descrição
AdGroupExcludedAudienceIterator Um iterador usado para iterar através do grupo de anúncios selecionado excluiu públicos-alvo.

orderBy(String orderBy)

Aplica a ordenação especificada aos públicos-alvo excluídos do grupo de anúncios selecionado.

Especifique o parâmetro orderBy no formulário "columnName orderDirection" onde:

  • columnName é uma das colunas suportadas.
  • orderDirection é a ordem pela qual ordenar os resultados. Defina ASC para ordenar os resultados por ordem ascendente ou DESC para ordenar os resultados por ordem descendente. O padrão é ASC.

Por exemplo, a chamada seguinte devolve audiências excluídas do grupo de anúncios por ordem ascendente por CpcMédia.

selector = selector.orderBy("AverageCpc");

Os seletores suportam entidades de ordenação apenas por um campo. Não pode ordenar a lista de entidades pelo campo x, e dentro de x pelo campo y, e assim sucessivamente. Se você especificar mais de uma orderBy() chamada em cadeia ou em chamadas separadas do seletor, os scripts ordenam a lista de entidades usando o campo especificado na última orderBy() chamada. 

Argumentos

Name Tipo Descrição
orderBy cadeia A ordem a aplicar.

Devoluções

Tipo Descrição
AdGroupExcludedAudienceSelector Seletor com ordenação aplicada.

withCondition(condição String)

Aplica critérios de filtro aos públicos-alvo excluídos do grupo de anúncios.

Especifique o parâmetro de condição no formulário, "columnName operator value" onde:

Operadores

O operador que utilizar depende do tipo da coluna. Os operadores são sensíveis às maiúsculas e minúsculas. Por exemplo, utilize STARTS_WITH em vez de starts_with.

Operadores para colunas que contêm números inteiros e valores longos:

<
<=
>
>=
=
!=

Operadores para colunas que contêm valores duplos:

<
>

Operadores para colunas que contêm valores de cadeia:

=
!=
STARTS_WITH
STARTS_WITH_IGNORE_CASE
CONTAINS
CONTAINS_IGNORE_CASE
DOES_NOT_CONTAIN
DOES_NOT_CONTAIN_IGNORE_CASE

Operadores para colunas que contêm valores de enumeração:

=
!=
IN []
NOT_IN []

Operadores para colunas que contêm uma matriz de cadeias de caracteres:

CONTAINS_ALL
CONTAINS_ANY
CONTAINS_NONE

Colunas Suportadas

As colunas suportadas para o grupo de anúncios excluíram a filtragem de público-alvo. Os nomes são sensíveis às maiúsculas e minúsculas.

A seguir estão as propriedades da entidade que você pode especificar.

Coluna Tipo Exemplos:
AdGroupName cadeia O nome do grupo de anúncios da associação.

withCondition("AdGroupName CONTAINS_IGNORE_CASE 'truck'")
AdGroupStatus Enumeração O status do grupo de anúncios da associação. Os possíveis valores sensíveis às maiúsculas e minúsculas são:
  • ATIVADO
  • EM PAUSA
  • REMOVIDO
Este exemplo retorna apenas públicos-alvo excluídos do grupo de anúncios cujo grupo de anúncios pai está pausado.

withCondition("AdGroupStatus = PAUSED")
AudienceId longo ID da audiência associada.

withCondition("AudienceId = 123456789")
CampaignName cadeia O nome da campanha que contém o grupo de anúncios da associação.

withCondition("CampaignName CONTAINS_IGNORE_CASE 'truck'")
Estado da Campanha Enumeração O status da campanha que contém o grupo de anúncios da associação. Os possíveis valores sensíveis às maiúsculas e minúsculas são:
  • ATIVADO
  • EM PAUSA
  • REMOVIDO
Este exemplo retorna apenas públicos-alvo excluídos do grupo de anúncios cuja campanha pai está pausada.

withCondition("CampaignStatus = PAUSED")
Estado Enumeração O estatuto da associação. Os possíveis valores sensíveis às maiúsculas e minúsculas são:
  • ATIVADO
  • EM PAUSA
  • REMOVIDO
Este exemplo retorna apenas públicos-alvo excluídos de grupos de anúncios habilitados.

withCondition("Status = ENABLED")
NomeDaLista de Utilizadores cadeia O nome da audiência associada.

withCondition("UserListName = 'foo'")

Argumentos

Name Tipo Descrição
Condição cadeia A condição a ser aplicada ao seletor.

Devoluções

Tipo Descrição
AdGroupExcludedAudienceSelector Seletor com a condição aplicada.

withIds(string[] ids)

Obtém públicos-alvo excluídos do grupo de anúncios com os IDs especificados.

Pode aplicar uma ou mais condições a um seletor. Uma cadeia de condições é considerada uma operação E. Por exemplo, a entidade só é selecionada se a condição A for verdadeira E a condição B for verdadeira. Por exemplo, a chamada seguinte seleciona apenas o grupo de anúncios do público excluído 33333.

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

Argumentos

Name Tipo Descrição
IDs cadeia[] Uma matriz de IDs de público excluídos do grupo de anúncios. Para limites, consulte Limites de execução de scripts.

Devoluções

Tipo Descrição
AdGroupExcludedAudienceSelector Seletor com os IDs aplicados.

withLimit(int limit)

Obtém os primeiros n grupos de anúncios excluídos públicos que correspondem aos critérios de seleção.

Argumentos

Name Tipo Descrição
limite int O número de audiências excluídas do grupo de anúncios a devolver. O número real pode ser menor.

Devoluções

Tipo Descrição
AdGroupExcludedAudienceSelector Seletor com limite aplicado.
  • Last updated on