Compartilhar via

Anúncio

  • Artigo

O objeto base a partir do qual os anúncios, como anúncios de texto expandidos, derivam.

Este objeto também representa anúncios de texto padrão. Pode deixar de criar anúncios de texto padrão, mas pode obter, colocar em pausa, remover e ativá-los. Os seguintes métodos não se aplicam a objetos derivados e não devem ser chamados.

  • getDestinationUrl()
  • getDisplayUrl()
  • getHeadline()
  • isMobilePreferred()

Nota

  • Atualize os anúncios de texto expandidos para anúncios de pesquisa reativos até 1 de fevereiro de 2023. Após esta data, deixará de poder criar anúncios de texto expandido novos ou editar existentes. Para obter mais informações, consulte Acerca dos anúncios de pesquisa reativos.
  • Os anúncios de texto expandido existentes continuarão a servir e poderá ver relatórios sobre o desempenho dos mesmos.
  • Continuará a poder colocar em pausa, ativar ou remover os anúncios de texto expandidos. Caso contrário, as tentativas de adicionar ou atualizar anúncios de texto expandido resultarão num CampaignServiceAdTypeInvalid erro.
  • Saiba mais sobre esta alteração.

Métodos

Nome do Método Tipo de Devolução Descrição
applyLabel(nome da cadeia) vazio Aplica a etiqueta a este anúncio.
asType AdViewSpace Contém os métodos utilizados para converter este anúncio num tipo de anúncio específico.
ativar vazio Ativa este anúncio.
getAdGroup AdGroup Obtém o grupo de anúncios ao qual este anúncio pertence.
getCampaign Campanha Obtém a campanha à qual este anúncio pertence.
getDescription cadeia Obtém o texto de cópia deste anúncio.
getDestinationUrl cadeia Obtém o URL da página Web para a qual o utilizador é levado quando clica no anúncio.
getDisplayUrl cadeia Obtém o URL que é apresentado no anúncio.
getEntityType cadeia Obtém o tipo desta entidade.
getHeadline cadeia Obtém o título deste anúncio.
getId cadeia Obtém o ID que identifica exclusivamente este anúncio.
getPolicyApprovalStatus cadeia Obtém o estado de aprovação editorial deste anúncio.
getStats Estatísticas Obtém os dados de desempenho deste anúncio.
getType cadeia Obtém o tipo derivado deste anúncio.
isEnabled booleano Obtém um valor Booleano que indica se este anúncio está ativado.
isMobilePreferred booleano Obtém um valor Booleano que indica se a preferência é que este anúncio seja apresentado em dispositivos móveis ou em todos os dispositivos.
isPaused Booleano Obtém um valor Booleano que indica se este anúncio está em pausa.
isType AdTypeSpace Contém os métodos utilizados para testar se um anúncio é do tipo especificado.
etiquetas Seletor de Etiquetas Obtém um seletor utilizado para filtrar a lista de etiquetas associadas a este anúncio.
colocar em pausa vazio Coloca este anúncio em pausa.
remover vazio Remove este anúncio.
removeLabel(nome da cadeia) vazio Remove a etiqueta deste anúncio.
URLs AdUrls Contém os métodos utilizados para obter os URLs finais deste anúncio, o modelo de controlo e os parâmetros personalizados.

applyLabel(nome da cadeia)

Aplica a etiqueta ao anúncio.

Pode aplicar um máximo de 50 etiquetas a um anúncio. 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.

asType

Contém os métodos utilizados para converter este anúncio num tipo de anúncio específico.

Devoluções

Tipo Descrição
AdViewSpace Contém os métodos utilizados para converter este anúncio num tipo de anúncio específico.

ativar

Ativa este anúncio.

Devoluções

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

getAdGroup

Obtém o grupo de anúncios ao qual este anúncio pertence.

Devoluções

Tipo Descrição
AdGroup O grupo de anúncios a que este anúncio pertence.

getCampaign

Obtém a campanha à qual este anúncio pertence.

Devoluções

Tipo Descrição
Campanha A campanha a que este anúncio pertence.

getDescription

Obtém o texto de cópia deste anúncio.

Devoluções

Tipo Descrição
cadeia O texto de cópia do anúncio.

getDestinationUrl

Obtém o URL da página Web para a qual o utilizador é levado quando clica no anúncio.

Devoluções

Tipo Descrição
cadeia O URL da página Web para a qual o utilizador é levado quando clica no anúncio. Devolve nulo se for chamado a partir de um objeto derivado.

getDisplayUrl

Obtém o URL que é apresentado no anúncio.

Devoluções

Tipo Descrição
cadeia O URL que é apresentado no anúncio. Devolve nulo se for chamado a partir de um objeto derivado.

getEntityType

Obtém o tipo desta entidade.

Devoluções

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

getHeadline

Obtém o título deste anúncio.

Devoluções

Tipo Descrição
cadeia O título do anúncio. Devolve nulo se for chamado a partir de um objeto derivado.

getId

Obtém o ID que identifica exclusivamente este anúncio.

Devoluções

Tipo Descrição
cadeia O ID que identifica exclusivamente este anúncio.

getPolicyApprovalStatus

Obtém o estado de aprovação editorial deste anúncio.

Devoluções

Tipo Descrição
cadeia O estado de aprovação editorial do anúncio. Seguem-se os valores possíveis.
  • APROVADO
  • APPROVED_LIMITED
  • UNDER_REVIEW
  • REPROVADO

getStats

Obtém os dados de desempenho deste anúncio.

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

Devoluções

Tipo Descrição
Estatísticas Os dados de desempenho do anúncio.

getType

Obtém o tipo derivado deste anúncio.

Devoluções

Tipo Descrição
cadeia Este tipo derivado deste anúncio. Seguem-se os tipos possíveis.
  • EXPANDED_TEXT_AD
.

isEnabled

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

Devoluções

Tipo Descrição
booleano É verdade se este anúncio estiver ativado; caso contrário, falso.

isMobilePreferred

Obtém um valor Booleano que indica se a preferência é que este anúncio seja apresentado em dispositivos móveis ou em todos os dispositivos.

Devoluções

Tipo Descrição
booleano É verdadeiro se a preferência for que este anúncio seja apresentado em dispositivos móveis. Se for falso, a preferência é que este anúncio seja apresentado em todos os dispositivos.

isPaused

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

Devoluções

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

isType

Contém os métodos utilizados para testar se um anúncio é do tipo especificado.

Devoluções

Tipo Descrição
AdTypeSpace Contém os métodos utilizados para testar se um anúncio é do tipo especificado.

etiquetas

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

Devoluções

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

colocar em pausa

Coloca este anúncio em pausa.

Devoluções

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

remover

Remove este anúncio.

Devoluções

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

removeLabel(nome da cadeia)

Remove a etiqueta do anúncio.

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 anúncio, veja etiquetas.

Devoluções

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

URLs

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

Devoluções

Tipo Descrição
AdUrls O objeto utilizado para obter os URLs finais deste anúncio, o modelo de controlo e os parâmetros personalizados.

Consulte também