Partilhar via

AdGroupExcludedAudienceSelector

  • Artigo

Contém os métodos para filtrar e ordenar uma lista de audiências excluídas do grupo de anúncios. Para obter informações sobre seletores, consulte Seletores.

Utilização de exemplo:

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

Nome do Método Tipo de Devolução Descrição
obter AdGroupExcludedAudienceIterator Obtém um iterador utilizado para iterar através da lista de audiências excluídas do grupo de anúncios.
orderBy(string orderBy) AdGroupExcludedAudienceSelector Aplica a ordenação especificada às audiências excluídas do grupo de anúncios selecionado.
withCondition(condição de cadeia) AdGroupExcludedAudienceSelector Aplica critérios de filtro às audiências excluídas do grupo de anúncios.
withIds(string[] ids) AdGroupExcludedAudienceSelector Obtém audiências excluídas do grupo de anúncios com os IDs especificados.
withLimit(int limit) AdGroupExcludedAudienceSelector Obtém as principais audiências excluídas do grupo n ad que correspondem aos critérios de seleção.

obter

Obtém um iterador utilizado para iterar através da lista de audiências excluídas do grupo de anúncios.

Devoluções

Tipo Descrição
AdGroupExcludedAudienceIterator Um iterador utilizado para iterar através do grupo de anúncios selecionado excluiu audiências.

orderBy(String orderBy)

Aplica a ordenação especificada às audiências excluídas do grupo de anúncios selecionado.

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

  • columnName é uma das colunas suportadas.
  • orderDirection é a ordem para ordenar os resultados. Defina como ASC para ordenar os resultados por ordem ascendente ou DESC para ordenar os resultados por ordem descendente. A predefinição é ASC.

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

selector = selector.orderBy("AverageCpc");

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

Argumentos

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

Devoluções

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

withCondition(Condição de cadeia)

Aplica critérios de filtro às audiências excluídas do grupo de anúncios.

Especifique o parâmetro condition no formulário "columnName operator value" em que:

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:

CONTAINS_ALL
CONTAINS_ANY
CONTAINS_NONE

Colunas Suportadas

Colunas suportadas para a filtragem de audiências excluída do grupo de anúncios. Os nomes são sensíveis às maiúsculas e minúsculas.

Seguem-se as propriedades da entidade que 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 estado 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 devolve apenas audiências excluídas do grupo de anúncios cujo grupo de anúncios principal está em pausa.

withCondition("AdGroupStatus = PAUSED")
AudienceId long O 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'")
CampaignStatus enumeração O estado 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 devolve apenas audiências excluídas do grupo de anúncios cuja campanha principal está em pausa.

withCondition("CampaignStatus = PAUSED")
Estado enumeração O estado da associação. Os possíveis valores sensíveis às maiúsculas e minúsculas são:
  • ATIVADO
  • EM PAUSA
  • REMOVIDO
Este exemplo devolve apenas audiências excluídas do grupo de anúncios ativado.

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

withCondition("UserListName = 'foo'")

Argumentos

Name Tipo Descrição
condição cadeia A condição a aplicar ao seletor.

Devoluções

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

withIds(string[] ids)

Obtém audiências excluídas 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 excluído da audiência 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 audiência excluídos do grupo de anúncios. Para obter limites, veja Limites de execução de scripts.

Devoluções

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

withLimit(int limit)

Obtém as principais audiências excluídas do grupo n ad 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.