Partilhar via


Palavra-chave

Contém os métodos para gerir uma palavra-chave. Para obter informações sobre palavras-chave, consulte Palavra-chave.

Métodos

Nome do Método Tipo de Devolução Descrição
adParams AdParamSelector Obtém um seletor utilizado para obter todos os parâmetros de substituição utilizados no anúncio para esta palavra-chave.
applyLabel(nome da cadeia) vazio Aplica a etiqueta a esta palavra-chave.
licitação KeywordBidding Obtém os métodos utilizados para gerir o valor da oferta desta palavra-chave.
clearDestinationUrl vazio Remove o URL de destino desta palavra-chave.
ativar vazio Ativa esta palavra-chave.
getAdGroup AdGroup Obtém o grupo de anúncios ao qual esta palavra-chave pertence.
getApprovalStatus cadeia Obtém o estado de aprovação editorial desta palavra-chave.
getCampaign Campanha Obtém a campanha à qual esta palavra-chave pertence.
getEntityType cadeia Obtém o tipo desta entidade.
getFirstPageCpc duplo Obtém a oferta estimada necessária para estar na primeira página dos resultados da pesquisa.
getId cadeia Obtém o ID que identifica exclusivamente esta palavra-chave.
getMatchType cadeia Obtém o tipo de correspondência desta palavra-chave.
getQualityScore número inteiro Obtém a classificação de qualidade desta palavra-chave.
getStats Estatísticas Obtém os dados de desempenho desta palavra-chave.
getText cadeia Obtém o texto da palavra-chave.
getTopOfPageCpc duplo Obtém a oferta estimada necessária para estar na parte superior dos resultados da pesquisa.
isEnabled Booleano Obtém um valor Booleano que indica se esta palavra-chave está ativada.
isPaused Booleano Obtém um valor Booleano que indica se esta palavra-chave está em pausa.
etiquetas Seletor de Etiquetas Obtém um seletor utilizado para filtrar a lista de etiquetas associadas a esta palavra-chave.
colocar em pausa vazio Coloca esta palavra-chave em pausa.
remover vazio Remove esta palavra-chave.
removeLabel(nome da cadeia) vazio Remove a etiqueta desta palavra-chave.
setAdParam(índice int, inserção de cadeiaTexto) vazio Adiciona o parâmetro de substituição e define o respetivo valor para o texto especificado.
URLs KeywordUrls Obtém os métodos utilizados para gerir os URLs finais destas palavras-chave, o modelo de controlo e os parâmetros personalizados.

adParams

Obtém um seletor de todos os parâmetros de substituição utilizados em anúncios para esta palavra-chave.

Os valores de substituição são utilizados num anúncio se o título do anúncio, o texto, o URL de apresentação ou o URL de destino contiverem a cadeia de substituição dinâmica {Param1}, {Param2} ou {Param3}.

Devoluções

Tipo Descrição
AdParamSelector O seletor que contém a lista de parâmetros de substituição para esta palavra-chave.

applyLabel(nome da cadeia)

Aplica a etiqueta à palavra-chave.

Pode aplicar um máximo de 50 etiquetas a uma palavra-chave. Para obter um exemplo que adiciona uma etiqueta a uma palavra-chave, 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 valor da oferta desta palavra-chave.

Devoluções

Tipo Descrição
KeywordBidding Contém os métodos utilizados para gerir o valor da oferta desta palavra-chave.

clearDestinationUrl

Remove o URL de destino desta palavra-chave.

Devoluções

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

ativar

Ativa esta palavra-chave.

Devoluções

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

getAdGroup

Obtém o grupo de anúncios ao qual esta palavra-chave pertence.

Devoluções

Tipo Descrição
AdGroup O grupo de anúncios a que esta palavra-chave pertence.

getApprovalStatus

Obtém o estado de aprovação editorial desta palavra-chave.

Devoluções

Tipo Descrição
cadeia O estado de aprovação editorial da palavra-chave. O estado indica se a palavra-chave está a ser analisada, aprovada ou não permitida. Os valores possíveis são:
  • APROVADO
  • APPROVED_LIMITED
  • REPROVADO
  • UNDER_REVIEW
Para obter informações sobre como estes valores de estado são mapeados para a API de Anúncios do Bing, veja Mapear valores de estado de aprovação editorial.

getCampaign

Obtém a campanha à qual esta palavra-chave pertence.

Devoluções

Tipo Descrição
Campanha A campanha à qual esta palavra-chave pertence.

getEntityType

Devolve o tipo desta entidade.

Devoluções

Tipo Descrição
cadeia O tipo desta entidade, que é Palavra-chave.

getId

Obtém o ID que identifica exclusivamente esta palavra-chave.

Devoluções

Tipo Descrição
cadeia O ID que identifica exclusivamente esta palavra-chave.

getFirstPageCpc

Obtém a oferta estimada necessária para que o anúncio apareça na barra lateral.

Devoluções

Tipo Descrição
duplo A oferta estimada necessária para que o anúncio apareça na barra lateral.

getMatchType

Obtém o tipo de correspondência desta palavra-chave.

Devoluções

Tipo Descrição
cadeia O tipo de correspondência da palavra-chave. Os valores possíveis são:
  • BROAD
  • EXPRESSÃO
  • EXATO
Para obter informações sobre estes tipos, consulte O que são tipos de correspondência de palavras-chave e como posso utilizá-los?

getQualityScore

Obtém a classificação de qualidade desta palavra-chave.

Devoluções

Tipo Descrição
número inteiro A classificação de qualidade da palavra-chave. A classificação está entre 1 e 10 (mais alta). Se não for possível calcular a classificação de qualidade da palavra-chave, este método devolve NULL.

A classificação mostra o quão competitivos são os seus anúncios no marketplace ao medir a relevância das suas palavras-chave e páginas de destino para os termos de pesquisa dos clientes. Para obter mais informações, veja Relatório de Desempenho de Palavras-chave.

getStats

Obtém estes dados de desempenho de palavras-chave.

Para chamar este método, tem de incluir um dos forDateRange métodos na cadeia do seletor de palavras-chave .

Devoluções

Tipo Descrição
Estatísticas Os dados de desempenho da palavra-chave. Por exemplo, cliques e impressões.

getText

Obtém o texto da palavra-chave. O texto inclui a sintaxe do tipo de correspondência da palavra-chave, se existir. Por exemplo:

  • A palavra-chave é livros se o tipo de correspondência for amplo ou +livros se a palavra-chave utilizar o modificador de tipo amplo
  • A palavra-chave é "livros" se o tipo de correspondência for expressão
  • A palavra-chave é [livros de capa dura] se o tipo de correspondência for exato

Para obter informações sobre estes tipos, consulte O que são tipos de correspondência de palavras-chave e como posso utilizá-los?

Devoluções

Tipo Descrição
cadeia O texto da palavra-chave.

getTopOfPageCpc

Obtém a oferta estimada necessária para que o anúncio apareça acima dos resultados da pesquisa orgânica.

Devoluções

Tipo Descrição
duplo A oferta estimada necessária para que o anúncio apareça acima dos resultados da pesquisa orgânica.

isEnabled

Obtém um valor Booleano que indica se esta palavra-chave está ativada.

Devoluções

Tipo Descrição
Booleano É verdadeiro se esta palavra-chave estiver ativada; caso contrário, falso.

isPaused

Obtém um valor Booleano que indica se esta palavra-chave está em pausa.

Devoluções

Tipo Descrição
Booleano É verdadeiro se esta palavra-chave estiver em pausa; caso contrário, falso.

etiquetas

Obtém um seletor utilizado para filtrar a lista de etiquetas associadas a esta palavra-chave.

Devoluções

Tipo Descrição
Seletor de Etiquetas Um seletor utilizado para filtrar a lista de etiquetas associadas a esta palavra-chave.

colocar em pausa

Coloca esta palavra-chave em pausa.

Devoluções

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

remover

Remove esta palavra-chave.

Devoluções

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

removeLabel(nome da cadeia)

Remove a etiqueta da palavra-chave.

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 esta palavra-chave, veja etiquetas.

Devoluções

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

setAdParam(índice int, inserção de cadeiaTexto)

Adiciona o parâmetro de substituição e define o respetivo valor para o texto especificado. Se o parâmetro de substituição existir, o texto será substituído.

Os valores de substituição são utilizados num anúncio se o título, texto, URL de apresentação ou URL final do anúncio contiverem as cadeias de substituição dinâmica {Param1}, {Param2} ou {Param3}. Para obter restrições e informações sobre como utilizar estes parâmetros, veja Param1, Param2 e Param3.

Os valores de substituição também são utilizados no modelo de controlo se o modelo especificar os marcadores de posição {param1:default}, {param2:default} ou {param3:default}.

Argumentos

Name Tipo Descrição
índice int O índice do parâmetro de substituição a definir. Os valores de índice válidos são de 1 a 3, inclusive. Utilize 1 para Param1, 2 para Param2 e 3 para Param3.
insertionText cadeia O texto para o que definir o parâmetro de substituição.

Devoluções

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

URLs

Obtém os métodos utilizados para gerir os URLs finais destas palavras-chave, o modelo de controlo e os parâmetros personalizados.

Devoluções

Tipo Descrição
KeywordUrls Contém os métodos utilizados nos URLs finais da palavra-chave, no modelo de controlo e nos parâmetros personalizados.

Consulte também