Compartilhar via


AdGroupUrls

Contém os métodos para gerir os URLs do grupo de anúncios. 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 deste grupo de anúncios.
getCustomParameters Objeto Obtém os parâmetros personalizados do grupo de anúncios.
getTrackingTemplate cadeia Obtém o modelo de controlo do grupo de anúncios.
setCustomParameters(Object customParameters) vazio Define os parâmetros personalizados do grupo de anúncios.
setTrackingTemplate(string trackingTemplate) vazio Define o modelo de controlo do grupo de anúncios.

clearTrackingTemplate

Remove o modelo de controlo deste grupo de anúncios. 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 do grupo de anúncios.

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 do grupo de anúncios.

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 do grupo de anúncios.

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 do grupo de anúncios.

setCustomParameters(Object customParameters)

Define os parâmetros personalizados do grupo de anúncios. Utilize este método se o seu URL final ou 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 adicione um caráter de sublinhado (_) à esquerda ao 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 do grupo de anúncios.

Para limpar os parâmetros personalizados do grupo de anúncios, transmita um objeto vazio (por exemplo, setCustomParameters({})). Se limpar os parâmetros personalizados do grupo de anúncios, o grupo de anúncios herda os URLs da campanha principal (se a campanha especificar URLs). 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 no grupo de anúncios. 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.

setTrackingTemplate(string trackingTemplate)

Define o modelo de controlo a utilizar com este grupo de anúncios.

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 este grupo de anúncios.

Devoluções

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