Compartilhar via


AdGroup

Contém os métodos utilizados para gerir um grupo de anúncios.

Métodos

Nome do Método Tipo de Devolução Descrição
addLocation(int locationId) TargetedLocationOperation Cria um destino de localização neste grupo de anúncios a partir de um ID de localização.
addLocation(int locationId, double bidModifier) TargetedLocationOperation Cria um destino de localização neste grupo de anúncios a partir de um ID de localização e modificador de licitação.
anúncios AdSelector Obtém um seletor utilizado para filtrar a lista de anúncios neste grupo de anúncios.
applyLabel(nome da cadeia) vazio Aplica a etiqueta a este grupo de anúncios.
licitação AdGroupBidding Obtém os métodos utilizados para gerir o montante da oferta deste grupo de anúncios.
ativar vazio Ativa este grupo de anúncios.
excludeLocation(int locationId) ExcludedLocationOperation Cria uma exclusão de localização neste grupo de anúncios a partir de um ID de localização.
getCampaign Campanha Obtém a campanha à qual este grupo de anúncios pertence.
getEndDate BingAdsDate Obtém a data em que os anúncios neste grupo de anúncios deixam de servir.
getEntityType cadeia Obtém o tipo desta entidade.
getId cadeia Obtém o ID que identifica exclusivamente este grupo de anúncios.
getName cadeia Obtém o nome deste grupo de anúncios.
getStartDate BingAdsDate Obtenha a data em que os anúncios neste grupo de anúncios começam a servir.
getStats Estatísticas Obtém os dados de desempenho deste grupo de anúncios.
isEnabled Booleano Obtém um valor Booleano que indica se este grupo de anúncios está ativado.
isPaused Booleano Obtém um valor Booleano que indica se este grupo de anúncios está em pausa.
isRemoved Booleano Obtém um valor Booleano que indica se este grupo de anúncios foi removido.
palavras-chave KeywordSelector Obtém um seletor utilizado para filtrar a lista de palavras-chave neste grupo de anúncios.
etiquetas Seletor de Etiquetas Obtém um seletor utilizado para filtrar a lista de etiquetas associadas a este grupo de anúncios.
newAd AdBuilderSpace Obtém um objeto que contém métodos para obter construtores de anúncios.
newKeywordBuilder KeywordBuilder Obtém um construtor utilizado para adicionar uma palavra-chave a este grupo de anúncios.
colocar em pausa vazio Coloca este grupo de anúncios em pausa.
productGroups ProductGroupSelector Obtém um seletor utilizado para filtrar a lista de grupos de produtos neste grupo de anúncios.
removeLabel(nome da cadeia) vazio Remove a etiqueta deste grupo de anúncios.
rootProductGroup Grupo de Produtos Obtém o grupo de produtos raiz para este grupo de anúncios.
setEndDate(string endDate) vazio Define a data em que os anúncios neste grupo de anúncios deixam de servir.
setEndDate(Object endDate) vazio Define a data em que os anúncios neste grupo de anúncios deixam de servir.
setName(Nome da cadeia) vazio Define o nome do grupo de anúncios.
setStartDate(string startDate) vazio Define a data em que os anúncios neste grupo de anúncios começam a servir.
setStartDate(Object startDate) vazio Define a data em que os anúncios neste grupo de anúncios começam a servir.
filtragem AdGroupTargeting Fornece acesso aos critérios de filtragem ao nível do grupo de anúncios: filtragem de localização.
URLs AdGroupUrls Contém os métodos utilizados para gerir os URLs finais deste grupo de anúncios, o modelo de controlo e os parâmetros personalizados.

addLocation(int locationId)

Cria um destino de localização neste grupo de anúncios a partir de um ID de localização.

Devoluções

Tipo Descrição
TargetedLocationOperation O objeto de operação utilizado para verificar se a localização de destino foi adicionada com êxito.

addLocation(int locationId, double bidModifier)

Cria um destino de localização neste grupo de anúncios a partir de um ID de localização e modificador de licitação.

Devoluções

Tipo Descrição
TargetedLocationOperation O objeto de operação utilizado para verificar se a localização de destino foi adicionada com êxito.

anúncios

Obtém um seletor utilizado para filtrar a lista de anúncios neste grupo de anúncios.

Devoluções

Tipo Descrição
AdSelector Um seletor utilizado para filtrar a lista de anúncios neste grupo de anúncios.

applyLabel(nome da cadeia)

Aplica a etiqueta ao grupo de anúncios.

Pode aplicar um máximo de 50 etiquetas a um grupo de anúncios. Para obter um exemplo que adiciona uma etiqueta a uma entidade, veja Utilizar etiquetas.

Argumentos

Name Tipo Descrição
nome cadeia O nome sensível às maiúsculas e minúsculas da etiqueta. Para obter uma lista de etiquetas nesta conta que pode aplicar, consulte AdsApp.labels.

Devoluções

Tipo Descrição
vazio Não devolve nada.

licitação

Obtém os métodos utilizados para gerir o montante da oferta deste grupo de anúncios.

Devolve:

Tipo Descrição
AdGroupBidding Contém os métodos para gerir o montante da oferta deste grupo de anúncios.

ativar

Ativa este grupo de anúncios.

Devoluções

Tipo Descrição
vazio Não devolve nada.

excludeLocation(int locationId)

Cria uma exclusão de localização neste grupo de anúncios a partir de um ID de localização.

Devoluções

Tipo Descrição
ExcludedLocationOperation O objeto de operação utilizado para verificar se a localização excluída foi adicionada com êxito.

getCampaign

Obtém a campanha à qual este grupo de anúncios pertence.

Devoluções

Tipo Descrição
Campanha A campanha a que este grupo de anúncios pertence.

getEndDate

Obtém a data em que os anúncios neste grupo de anúncios deixam de servir.

Devoluções

Tipo Descrição
BingAdsDate A data em que os anúncios neste grupo de anúncios deixam de servir.

getEntityType

Obtém o tipo desta entidade.

Devoluções

Tipo Descrição
cadeia O tipo desta entidade, que é AdGroup.

getId

Obtém o ID que identifica exclusivamente este grupo de anúncios.

Devoluções

Tipo Descrição
cadeia O ID que identifica exclusivamente este grupo de anúncios.

getName

Obtém o nome deste grupo de anúncios.

Devoluções

Tipo Descrição
cadeia O nome deste grupo de anúncios.

getStartDate

Obtém a data em que os anúncios neste grupo de anúncios começam a servir.

Devoluções

Tipo Descrição
BingAdsDate A data em que os anúncios neste grupo de anúncios começam a servir.

getStats

Obtém os dados de desempenho deste grupo de anúncios.

Para chamar este método, tem de incluir um dos forDateRange métodos na cadeia do seletor do grupo de anúncios .

Devolve:

Tipo Descrição
Estatísticas Os dados de desempenho deste grupo de anúncios.

isEnabled

Obtém um valor Booleano que indica se este grupo de anúncios está ativado.

Devolve:

Tipo Descrição
Booleano É verdade se este grupo de anúncios estiver ativado; caso contrário, falso.

isPaused

Obtém um valor Booleano que indica se este grupo de anúncios está em pausa.

Devolve:

Tipo Descrição
Booleano É verdade se este grupo de anúncios estiver em pausa; caso contrário, falso.

isRemoved

Obtém um valor Booleano que indica se este grupo de anúncios foi removido (eliminado).

Devoluções

Tipo Descrição
Booleano É verdadeiro se este grupo de anúncios for removido; caso contrário, falso.

palavras-chave

Obtém um seletor utilizado para filtrar a lista de palavras-chave neste grupo de anúncios.

Devoluções

Tipo Descrição
KeywordSelector Um seletor utilizado para filtrar a lista de palavras-chave neste grupo de anúncios.

etiquetas

Obtém um seletor utilizado para filtrar a lista de etiquetas associadas a este grupo de anúncios.

Devoluções

Tipo Descrição
Seletor de Etiquetas Um seletor utilizado para filtrar a lista de etiquetas associadas a este grupo de anúncios.

newAd

Obtém um objeto que contém métodos para obter construtores de anúncios.

Devoluções

Tipo Descrição
AdBuilderSpace Um objeto que contém métodos para obter construtores de anúncios. Por exemplo, para criar um anúncio de texto expandido, chame o método do expandedTextAdBuilder objeto para obter o objeto ExpandedTextAdBuilder .

newKeywordBuilder

Obtém um construtor utilizado para adicionar uma palavra-chave a este grupo de anúncios.

Devoluções

Tipo Descrição
KeywordBuilder O construtor utilizou para adicionar uma palavra-chave a este grupo de anúncios.

colocar em pausa

Coloca este grupo de anúncios em pausa.

Devoluções

Tipo Descrição
vazio Não devolve nada.

productGroups

Obtém um seletor utilizado para filtrar a lista de grupos de produtos neste grupo de anúncios.

Devoluções

Tipo Descrição
ProductGroupSelector Um seletor utilizado para filtrar a lista de grupos de produtos neste grupo de anúncios.

removeLabel(nome da cadeia)

Remove a etiqueta do grupo de anúncios.

Argumentos

Name Tipo Descrição
nome cadeia O nome sensível às maiúsculas e minúsculas da etiqueta. Para obter uma lista de etiquetas associadas a este grupo de anúncios, veja etiquetas.

Devoluções

Tipo Descrição
vazio Não devolve nada.

rootProductGroup

Obtém o grupo de produtos raiz neste grupo de anúncios.

Devoluções

Tipo Descrição
Grupo de Produtos O grupo de produtos raiz neste grupo de anúncios. Devolve nulo se o grupo de anúncios não contiver grupos de produtos.

setEndDate(string endDate)

Define a data em que os anúncios neste grupo de anúncios deixam de servir. Defina uma data de fim apenas se quiser que os anúncios no grupo deixem de servir numa data específica.

Argumentos

Name Tipo Descrição
endDate cadeia A data em que os anúncios no grupo de anúncios deixam de servir. Especifique a data no formulário YYYYMMDD.

Devoluções

Tipo Descrição
vazio Não devolve nada.

setEndDate(Object endDate)

Define a data em que os anúncios neste grupo de anúncios deixam de servir. Defina uma data de fim apenas se quiser que os anúncios no grupo deixem de servir numa data específica.

Argumentos

Name Tipo Descrição
endDate Objeto A data em que os anúncios neste grupo de anúncios deixam de servir. Especifique a data com um objeto com os seguintes campos:
  • ano
  • mês
  • dia
Por exemplo: var date = {year: 2018, month: 5, day: 13};

O mês é baseado num, em que 1 é janeiro e 12 é dezembro.

Devoluções

Tipo Descrição
vazio Não devolve nada.

setName(nome da cadeia)

Define o nome deste grupo de anúncios.

Argumentos

Name Tipo Descrição
nome cadeia O nome deste grupo de anúncios. O nome pode conter um máximo de 256 carateres e tem de ser exclusivo entre todos os grupos de anúncios na campanha.

Devoluções

Tipo Descrição
vazio Não devolve nada.

setStartDate(string startDate)

Define a data em que os anúncios neste grupo de anúncios começam a servir. Defina uma data de início apenas se pretender que os anúncios no grupo comecem a servir numa data específica; caso contrário, começam a servir imediatamente.

Argumentos

Name Tipo Descrição
endDate cadeia A data em que os anúncios neste grupo de anúncios começam a servir. Especifique a data no formulário YYYYMMDD.

Devoluções

Tipo Descrição
vazio Não devolve nada.

setStartDate(Object startDate)

Define a data em que os anúncios neste grupo de anúncios começam a servir. Defina uma data de início apenas se pretender que os anúncios no grupo comecem a servir numa data específica; caso contrário, começam a servir imediatamente.

Argumentos

Name Tipo Descrição
endDate Objeto A data em que os anúncios neste grupo de anúncios começam a servir. Especifique a data com um objeto com os seguintes campos:
  • ano
  • mês
  • dia
Por exemplo: var date = {year: 2018, month: 5, day: 13};

O mês é baseado num, em que 1 é janeiro e 12 é dezembro.

Devoluções

Tipo Descrição
vazio Não devolve nada.

filtragem

Fornece acesso aos critérios de filtragem ao nível do grupo de anúncios: filtragem de localização.

Devoluções

Tipo Descrição
AdGroupTargeting Acesso a critérios de destino de localização neste grupo de anúncios.

URLs

Contém os métodos utilizados para gerir os URLs finais deste grupo de anúncios, o modelo de controlo e os parâmetros personalizados.

Devoluções

Tipo Descrição
AdGroupUrls O objeto utilizado para gerir os URLs finais deste grupo de anúncios, o modelo de controlo e os parâmetros personalizados.

Consulte também