Partilhar via


KeywordUrls

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, veja Controlo de URLs com URLs atualizados.

Métodos

Nome do Método Tipo de Devolução Descrição
clearFinalUrl vazio Remove o URL final da palavra-chave.
clearMobileFinalUrl vazio Remove o URL final da palavra-chave para dispositivos móveis.
clearTrackingTemplate vazio Remove o modelo de controlo da palavra-chave.
getCustomParameters Objeto 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 controlo da palavra-chave.
setCustomParameters(Object customParameters) vazio Define os parâmetros personalizados da palavra-chave.
setFinalUrl(String finalUrl) vazio Define o URL final da palavra-chave.
setMobileFinalUrl(String finalUrl) vazio Define o URL final da palavra-chave para dispositivos móveis.
setTrackingTemplate(String trackingTemplate) vazio Define o modelo de controlo da palavra-chave.

clearFinalUrl

Remove o URL final da palavra-chave.

Devoluções

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

clearMobileFinalUrl

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

Devoluções

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

clearTrackingTemplate

Remove o modelo de controlo da palavra-chave.

Devoluções

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

getCustomParameters

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

Os parâmetros personalizados são úteis para partilhar informações dinâmicas em vários URLs. Para obter mais informações sobre a utilização, veja Parâmetros Personalizados.

Devoluções

Tipo Descrição
Objeto Um mapa dos parâmetros personalizados da palavra-chave.

Por exemplo, {key1: 'value1', key2: 'value2', key3: 'value3'}, em que a chave é o nome do parâmetro personalizado e o 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 é levado quando clica no anúncio.

As mesmas regras de substituição aplicam-se a outros locais. Por exemplo, especificar o URL final de uma palavra-chave substitui o URL final do anúncio.

Devoluções

Tipo Descrição
cadeia O 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 móvel para a qual o utilizador é levado quando clica no anúncio.

As mesmas regras de substituição aplicam-se a outros locais. Por exemplo, especificar o URL final móvel de uma palavra-chave substitui o URL final do anúncio para dispositivos móveis.

Devoluções

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

getTrackingTemplate

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

Os modelos de controlo são utilizados com o FinalUrl da palavra-chave para criar o URL de destino utilizado pelo anúncio. Para obter mais informações, veja Que parâmetros de controlo ou URL posso utilizar?

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 coloque um caráter de sublinhado (_) no nome. Por exemplo, se o nome do parâmetro for foo, utilize {_foo} no modelo de controlo ou no URL final. Não adicione um caráter de 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, transmita 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 para partilhar informações dinâmicas em vários URLs. Para obter mais informações sobre a utilização, veja Parâmetros Personalizados.

Argumentos

Name Tipo Descrição
customParameters Objeto Um mapa de até três parâmetros personalizados a utilizar na palavra-chave. Por exemplo, {key1: 'value1', key2: 'value2', key3: 'value3'}, em que a chave é o nome do parâmetro personalizado e o valor é o valor do parâmetro. O nome do parâmetro pode conter apenas carateres alfanuméricos e o valor do parâmetro pode não 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
vazio 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 é levado quando clica no anúncio. Se não for especificado, a entidade herda o URL final da entidade principal. Por exemplo, a entidade de 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, veja Que parâmetros de controlo ou URL posso utilizar?

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

Argumentos

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

Devoluções

Tipo Descrição
vazio 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 é levado quando clica no anúncio. Se não for especificado, a entidade herda o URL final da entidade principal. Por exemplo, a entidade de 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, veja Que parâmetros de controlo ou URL posso utilizar?

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 falha silenciosamente. Para confirmar se a propriedade foi realmente atualizada, obtenha novamente o objeto e teste se o valor da propriedade é igual ao novo valor. Para obter informações, veja Lidar com erros e avisos.

Argumentos

Name Tipo Descrição
finalUrl cadeia Os dispositivos móveis de URL finais da palavra-chave.

Devoluções

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

setTrackingTemplate(String trackingTemplate)

Define o modelo de controlo da palavra-chave.

Os modelos de controlo são utilizados com o FinalUrl da palavra-chave para criar o URL de destino utilizado pelo anúncio. Para obter mais informações, veja Que parâmetros de controlo ou URL posso utilizar?

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

Argumentos

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

Devoluções

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