Campos de URL atualizados

Os URLs atualizados separam os URLs da página de destino dos parâmetros de acompanhamento, permitindo que você gerencie a lógica de acompanhamento sem acionar novas revisões de anúncios quando os parâmetros de acompanhamento mudam.

Com os URLs atualizados, é possível especificar as partes de acompanhamento e página de destino do seu URL em campos separados:

• URLs finais (final_urls): representa uma lista de páginas de destino reais para seu anúncio, palavra-chave ou sitelink. O URL final precisa ser o que o usuário vê na barra do navegador depois de clicar em um anúncio.
• URLs finais para dispositivos móveis (final_mobile_urls): representa uma lista de possíveis URLs finais para dispositivos móveis do seu anúncio, palavra-chave ou sitelink após todos os redirecionamentos de vários domínios.
• URLs finais do app (final_app_urls): representam uma lista de URLs finais do app que serão usados em dispositivos móveis se o usuário tiver o app específico instalado.
• Modelo de acompanhamento (tracking_url_template): modelo opcional para especificar parâmetros de acompanhamento ou redirecionamentos adicionais. Vamos usar esse modelo para montar o URL de destino real a ser associado ao anúncio.
• Sufixo do URL final (final_url_suffix): parâmetros opcionais anexados diretamente ao final do URL da página de destino para rastrear a atividade dela (por exemplo, com o acompanhamento paralelo).
• Parâmetros personalizados (url_custom_parameters): opcionais. Parâmetros ValueTrack a que você pode atribuir seus próprios IDs.

Para especificações detalhadas, consulte a página de referência do Ad.

Descrições de campo

As seções a seguir descrevem os campos de um URL atualizado.

URLs finais (final_urls)

O URL final representa a página de destino real do seu anúncio, palavra-chave ou sitelink. O URL final precisa ser o que o usuário vê na barra do navegador depois de clicar no seu anúncio. Ele não pode ter redirecionamentos para fora do domínio.

Os URLs finais seguem as mesmas regras de substituição dos URLs de destino. Por exemplo, um URL final no nível da palavra-chave substitui um URL final no nível do anúncio.

Todas as regras de validação atuais para URLs de destino também se aplicam aos URLs finais. Você pode ter tags de URL em URLs finais. Todas as tags precisam ser tags ValueTrack válidas ou parâmetros personalizados. É possível ter até quatro níveis de aninhamento ao especificar tags de URL:

{ifmobile:{ifsearch:{keyword:cp={_customP}}}}

Na maioria das vezes, você só precisa especificar um URL final ou um URL final para dispositivos móveis. No raro caso em que um modelo de rastreamento pode redirecionar o usuário para uma de várias páginas de destino que não passam por uma página de destino comum no domínio do anunciante (por exemplo, ao testar páginas de destino), é possível especificar essas páginas usando vários URLs finais.

URLs finais para dispositivos móveis (final_mobile_urls)

Se você quiser enviar os usuários para uma página de destino diferente em dispositivos móveis, forneça um URL final separado preferencial para dispositivos móveis. No entanto, se você preferir usar parâmetros ValueTrack, use os parâmetros ValueTrack {device} e {ifmobile} em vez deste campo.

URLs finais do app (final_app_urls)

Se você tiver anúncios que direcionam diretamente para o conteúdo no app usando links diretos ou anúncios de clique para download, especifique esses URLs no campo "URLs finais do app".

Modelo de rastreamento (tracking_url_template)

O campo "Modelo de acompanhamento" permite especificar outros parâmetros de acompanhamento ou redirecionamentos. Quando esse parâmetro é especificado, ele é usado em vez dos URLs finais para montar o URL de destino real do seu anúncio. O serviço de acompanhamento rastreia o clique e redireciona o usuário para uma página de destino. O URL da página de destino precisa corresponder ao URL final. Esse modelo pode incorporar o URL final usando parâmetros ValueTrack, como {lpurl}.

Sufixo do URL final (final_url_suffix)

No campo "Sufixo do URL final", você pode especificar parâmetros de rastreamento que serão anexados ao final do URL da página de destino. Com o acompanhamento paralelo, os usuários são enviados diretamente para o URL final enquanto a medição de cliques ocorre em segundo plano. Portanto, todos os parâmetros necessários para a página de destino precisam ser colocados no final_url_suffix (ou diretamente no final_urls), em vez do modelo de acompanhamento.

Assim como os modelos de acompanhamento, um final_url_suffix definido em uma entidade de nível inferior (como uma palavra-chave ou um anúncio) substitui um definido em uma entidade de nível superior (como um grupo de anúncios, uma campanha ou um cliente).

Parâmetros personalizados (url_custom_parameters)

Com os parâmetros personalizados, você pode criar seus próprios parâmetros, semelhantes aos parâmetros ValueTrack. Isso pode ser útil quando você quer usar seus próprios IDs, por exemplo, para identificar anúncios. Antes, era necessário codificar isso no URL de destino do anúncio. Agora, é possível especificar o ID do anúncio, usar um parâmetro personalizado para cada anúncio e consultar o parâmetro personalizado no URL final, no modelo de rastreamento ou em ambos, como faria com qualquer outro parâmetro ValueTrack.

O nome de um parâmetro personalizado pode conter apenas caracteres alfanuméricos. Ao se referir ao parâmetro personalizado em URLs finais e modelos de acompanhamento, coloque o parâmetro personalizado entre chaves e adicione um sublinhado ao nome dele. Por exemplo, {_promoCode}.

Observação: ao definir valores de parâmetros personalizados para uma entidade compatível, os itens na lista url_custom_parameters (por exemplo, de um objeto Ad) precisam ter um key exclusivo. A verificação de exclusividade não diferencia maiúsculas de minúsculas. Portanto, sua lista não pode conter um item com key="promoCode" e outro com key="promocode". Se você tiver vários itens com o mesmo key na lista url_custom_parameters, a solicitação vai falhar com DistinctError.DUPLICATE_ELEMENT.

Assim como nos URLs finais, os parâmetros personalizados em uma entidade de nível inferior substituem os valores de entidades de nível superior. É possível ter até oito parâmetros personalizados para uma entidade. A chave e o valor não podem exceder 16 e 200 bytes, respectivamente.

Exemplo

O snippet JSON a seguir mostra um exemplo de configuração de um objeto Ad com campos de URL atualizados:

{
  "finalUrls": ["https://www.example.com/shoes"],
  "finalUrlSuffix": "src=google&promo={_promoCode}",
  "trackingUrlTemplate": "https://www.tracker.com/?u={lpurl}&alloc={_promoCode}",
  "urlCustomParameters": [
    {
      "key": "promoCode",
      "value": "summer15"
    }
  ]
}