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. |