CampaignUrls

Contém os métodos para gerir os URLs da campanha. Para obter mais informações, veja Controlo de URLs com URLs Atualizados.

Métodos

Nome do Método	Tipo de Devolução	Descrição
clearTrackingTemplate	vazio	Remove o modelo de controlo da campanha.
getCustomParameters	Objeto	Obtém os parâmetros personalizados da campanha.
getTrackingTemplate	cadeia	Obtém o modelo de controlo da campanha.
setCustomParameters(Object customParameters)	vazio	Define os parâmetros personalizados da campanha.
setTrackingTemplate(String trackingTemplate)	vazio	Define o modelo de controlo da campanha.

clearTrackingTemplate

Remove o modelo de controlo da campanha. Para obter informações sobre o controlo de modelos, veja Tracking Templates (Controlar Modelos).

Devoluções

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

getCustomParameters

Obtém os parâmetros personalizados da campanha.

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

getTrackingTemplate

Obtém o modelo de controlo da campanha.

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

setCustomParameters(Object customParameters)

Define os parâmetros personalizados da campanha. Utilize este método se o URL final ou o modelo de controlo incluírem 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 campanha.

Para limpar os parâmetros personalizados da campanha, transmita um objeto vazio (por exemplo, setCustomParameters({})). Para limpar completamente os parâmetros personalizados, limpe os parâmetros em todos os níveis.

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 campanha. Por exemplo, {key1: 'value1', key2: 'value2', key3: 'value3'}, em que a chave é o nome e o valor do parâmetro personalizado é 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.

setTrackingTemplate(string trackingTemplate)

Define o modelo de controlo da campanha.

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?

Argumentos

Name	Tipo	Descrição
trackingTemplate	cadeia	O modelo de controlo a utilizar com esta campanha.

Devoluções

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