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

Com os URLs atualizados, você pode especificar as partes de acompanhamento e da 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 entre domínios.
• URLs finais do aplicativo (final_app_urls): representa uma lista de URLs finais do aplicativo que serão usados em dispositivos móveis se o usuário tiver o aplicativo 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 que será associado ao anúncio.
• Sufixo do URL final (final_url_suffix): parâmetros opcionais adicionados diretamente ao final do URL da página de destino para acompanhar a atividade dela (por exemplo, com o acompanhamento paralelo).
• Parâmetros personalizados (url_custom_parameters): parâmetros ValueTrack opcionais aos quais 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 URL que o usuário vê na barra do navegador depois de clicar no seu anúncio, sem 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. É possível ter tags de URL nos 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 caso raro em que um modelo de acompanhamento pode redirecionar o usuário para uma das 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 de destino 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 preferencial para dispositivos móveis separado. No entanto, se você preferir usar os parâmetros ValueTrack, use os parâmetros ValueTrack {device} e {ifmobile} em vez desse campo.

URLs finais do aplicativo (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, poderá especificar esses URLs no campo de URL final do aplicativo.

Modelo de acompanhamento (tracking_url_template)

O campo de 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)

O campo de sufixo do URL final permite especificar parâmetros de acompanhamento que serão anexados ao final do URL da página de destino. Com o acompanhamento paralelo, os usuários são enviados diretamente ao 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 de no modelo de acompanhamento.

Assim como nos 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. Em vez de fixar um ID no URL de destino do anúncio, você pode especificar o ID do anúncio, usar um parâmetro personalizado para cada anúncio e, em seguida, fazer referência ao parâmetro personalizado no URL final, no modelo de acompanhamento 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 fazer referência ao parâmetro personalizado em URLs finais e modelos de acompanhamento, coloque-o entre chaves e adicione um sublinhado ao nome, 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 atualizado:

{
  "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"
    }
  ]
}