Urls de palavras-chave

Contém os métodos para gerir os URLs da palavra-chave, o modelo de controlo e os parâmetros personalizados. Para obter informações, consulte Controle de URL com URLs atualizados.

Metodologia

Nome do método	Tipo de Devolução	Descrição
clearFinalUrl	Void	Remove o URL final da palavra-chave.
clearMobileFinalUrl	Void	Remove o URL final da palavra-chave para dispositivos móveis.
clearTrackingTemplate	Void	Remove o modelo de controlo da palavra-chave.
getCustomParameters	Objecto	Obtém os parâmetros personalizados da palavra-chave.
getFinalUrl	cadeia	Obtém o URL final da palavra-chave.
getMobileFinalUrl	cadeia	Obtém o URL final da palavra-chave para dispositivos móveis.
getTrackingTemplate	cadeia	Obtém o modelo de acompanhamento da palavra-chave.
setCustomParameters(Object customParameters)	Void	Define os parâmetros personalizados da palavra-chave.
setFinalUrl(String finalUrl)	Void	Define o URL final da palavra-chave.
setMobileFinalUrl(String finalUrl)	Void	Define o URL final da palavra-chave para dispositivos móveis.
setTrackingTemplate(String trackingTemplate)	Void	Define o modelo de controlo da palavra-chave.

clearFinalUrl

Remove o URL final da palavra-chave.

Devoluções

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

clearMobileFinalUrl

Remove o URL final da palavra-chave para dispositivos móveis.

Devoluções

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

clearTrackingTemplate

Remove o modelo de controlo da palavra-chave.

Devoluções

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

getCustomParameters

Obtém os parâmetros personalizados da palavra-chave.

Os parâmetros personalizados são úteis na partilha de informações dinâmicas em vários URLs. Para obter mais informações sobre seu uso, consulte Parâmetros personalizados.

Devoluções

Tipo	Descrição
Objecto	Um mapa dos parâmetros personalizados da palavra-chave. Por exemplo, {key1: 'value1', key2: 'value2', key3: 'value3'}, onde chave é o nome do parâmetro personalizado e valor é o valor do parâmetro.

getFinalUrl

Obtém o URL final da palavra-chave. Este é o URL da página Web para a qual o utilizador é direcionado quando clica no anúncio.

Aplicam-se as mesmas regras de substituição que noutros casos. Por exemplo, especificar o URL final de uma palavra-chave substitui o URL final do anúncio.

Devoluções

Tipo	Descrição
cadeia	URL final da palavra-chave.

getMobileFinalUrl

Obtém o URL final da palavra-chave para dispositivos móveis. Este é o URL da página Web para dispositivos móveis para a qual o utilizador é direcionado quando clica no anúncio.

Aplicam-se as mesmas regras de substituição que noutros casos. Por exemplo, especificar o URL final móvel de uma palavra-chave substitui o URL final móvel do anúncio.

Devoluções

Tipo	Descrição
cadeia	URL final da palavra-chave para dispositivos móveis.

getTrackingTemplate

Obtém o modelo de acompanhamento da palavra-chave.

Os modelos de acompanhamento são usados com o FinalUrl da palavra-chave para criar a URL de destino usada pelo anúncio. Para obter mais informações, consulte Que parâmetros de rastreamento ou URL posso usar?

Devoluções

Tipo	Descrição
cadeia	O modelo de controlo da palavra-chave.

setCustomParameters(Object customParameters)

Define os parâmetros personalizados da palavra-chave. Utilize este método se o URL final ou o modelo de controlo incluir cadeias de substituição personalizadas.

Para utilizar um nome de parâmetro de cliente no URL final ou modelo de controlo, coloque o nome entre chavetas e atribua um caráter de sublinhado (_) ao nome. Por exemplo, se o nome do parâmetro for foo, use {_foo} no modelo de acompanhamento ou URL final. Não adicione um sublinhado à esquerda ao nome do parâmetro ao definir o objeto de parâmetros personalizados.

Chamar este método substitui os parâmetros personalizados existentes da palavra-chave.

Para limpar os parâmetros personalizados da palavra-chave, passe um objeto vazio (por exemplo, setCustomParameters({})). Se limpar os parâmetros personalizados da palavra-chave, a palavra-chave herda os URLs do grupo de anúncios principal (se o grupo de anúncios especificar URLs). Para limpar completamente os parâmetros personalizados, limpe-os em todos os níveis da hierarquia.

Os parâmetros personalizados são úteis na partilha de informações dinâmicas em vários URLs. Para obter mais informações sobre seu uso, consulte Parâmetros personalizados.

Argumentos

Name	Tipo	Descrição
customParameters	Objecto	Um mapa com até três parâmetros personalizados para usar na palavra-chave. Por exemplo, {key1: 'value1', key2: 'value2', key3: 'value3'}, onde chave é o nome do parâmetro personalizado e valor é o valor do parâmetro. O nome do parâmetro pode conter apenas caracteres alfanuméricos e o valor do parâmetro não pode conter espaço em branco. O nome pode conter um máximo de 16 carateres de 8 bytes e o valor pode conter um máximo de 200 carateres de 8 bytes.

Devoluções

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

setFinalUrl(String finalUrl)

Define o URL final da palavra-chave.

O URL final identifica a página Web para a qual o utilizador é direcionado quando clica no anúncio. Se não for especificado, a entidade herda o URL final de sua entidade pai. Por exemplo, a entidade da palavra-chave herda o URL final do anúncio. Especifique o URL final da palavra-chave para substituir o URL final do anúncio.

Para obter mais informações, consulte Que parâmetros de rastreamento ou URL posso usar?

Se o valor da propriedade não for válido, a chamada falhará silenciosamente. Para confirmar se a propriedade foi realmente atualizada, obtenha o objeto novamente e teste se o valor da propriedade é igual ao novo valor. Para obter informações, consulte Tratamento de erros e avisos.

Argumentos

Name	Tipo	Descrição
finalUrl	cadeia	URL final da palavra-chave.

Devoluções

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

setMobileFinalUrl(String finalUrl)

Define o URL final da palavra-chave para dispositivos móveis.

O URL final identifica a página Web para a qual o utilizador é direcionado quando clica no anúncio. Se não for especificado, a entidade herda o URL final de sua entidade pai. Por exemplo, a entidade da palavra-chave herda o URL final do anúncio. Especifique o URL final da palavra-chave para substituir o URL final do anúncio.

Para obter mais informações, consulte Que parâmetros de rastreamento ou URL posso usar?

Para especificar um URL final para dispositivos móveis, primeiro especifique um URL final para dispositivos não móveis (consulte setFinalUrl()).

Se o valor da propriedade não for válido, a chamada falhará silenciosamente. Para confirmar se a propriedade foi realmente atualizada, obtenha o objeto novamente e teste se o valor da propriedade é igual ao novo valor. Para obter informações, consulte Tratamento de erros e avisos.

Argumentos

Name	Tipo	Descrição
finalUrl	cadeia	URL final da palavra-chave: dispositivos móveis.

Devoluções

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

setTrackingTemplate(String trackingTemplate)

Define o modelo de controlo da palavra-chave.

Os modelos de acompanhamento são usados com o FinalUrl da palavra-chave para criar a URL de destino usada pelo anúncio. Para obter mais informações, consulte Que parâmetros de rastreamento ou URL posso usar?

Se o valor da propriedade não for válido, a chamada falhará silenciosamente. Para confirmar se a propriedade foi realmente atualizada, obtenha o objeto novamente e teste se o valor da propriedade é igual ao novo valor. Para obter informações, consulte Tratamento de erros e avisos.

Argumentos

Name	Tipo	Descrição
trackingTemplate	cadeia	O modelo de controlo da palavra-chave.

Devoluções

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