Quais parâmetros de URL ou acompanhamento posso usar?

Examine os parâmetros de URL que você pode adicionar a seu modelo de acompanhamento ou URLs de destino para saber como os visitantes chegam a seu site.

Você pode adicionar parâmetros de URL à URL de destino ou ao modelo de acompanhamento para saber como os visitantes chegam a seu site. Parâmetros de URL permitem acompanhar informações sobre a origem de um clique no anúncio.

Embora os nomes de variável e os parâmetros possam mudar, a estrutura é sempre a mesma:

Um parâmetro, entre { }, que indica ao Microsoft Advertising quais dados você deseja que sejam retornados quando um anúncio for clicado. Os parâmetros específicos dentre os quais escolher são listados na tabela abaixo.
Uma variável que você define para armazenar esses dados. O nome da variável é de sua escolha, mas deve ser o nome usado no script de seu site para armazenar o valor que o parâmetro está retornando. Trabalhe com seus programadores de sites, que podem ajudá-lo a definir nomes apropriados para usar.

Juntando tudo, fica assim:

www.yourLandingPageURL.com?variable={parameter}

If you are adding more than one variável={parâmetro}, you separate the variable/parameter pair with an ampersand (&).

Parâmetros disponíveis para:

URL de destino, URLs finais, modelos de acompanhamento e parâmetros personalizados expando image

{CampaignId}
O que ele retorna: A ID da campanha que disparou o anúncio. Por exemplo, suponha que a URL de destino seja www.northwindtraders.com/{CampaignId}. Considerando que a ID da campanha seja 2410012280, a URL de destino será www.northwindtraders.com/2410012280.
{Campaign}
O que ele retorna O nome da campanha que disparou o anúncio. Por exemplo, suponha que a URL de destino seja www.northwindtraders.com/{Campaign}. Considerando que o nome da campanha seja Sale, a URL de destino será www.northwindtraders.com/Sale.
{AdGroupId}
O que ele retorna A ID do grupo de anúncios que disparou o anúncio. Por exemplo, suponha que a URL de destino seja www.northwindtraders.com/{AdGroupId}. Considerando que a ID do grupo de anúncios seja 2410012280, a URL de destino será www.northwindtraders.com/2410012280.
{AdGroup}
O que ele retorna O nome do grupo de anúncios que disparou o anúncio. Por exemplo, suponha que a URL de destino seja www.northwindtraders.com/{AdGroup}. Considerando que a ID do grupo de anúncios seja Clearance, a URL de destino será www.northwindtraders.com/Clearance.
{TargetId}
O que ele retorna A ID da palavra-chave ("kwd"), lista de remarketing ou de audiência personalizada ("aud"), alvo de anúncio dinâmico ("dat"), partição de produtos ("pla") ou ID de local direcionado ("loc") que disparou o anúncio. Se houver mais de uma ID, elas aparecerão na seguinte ordem: aud, dat, kwd, pla. Por exemplo, se você associar a lista de remarketing "1234" à palavra-chave "5678", {TargetId} será substituído por "aud-1234:kwd-5678". Observação: As audiências no mercado e a segmentação por perfil no LinkedIn não podem ser acompanhadas por meio desse parâmetro, pois isso poderia expor o comportamento do usuário individual no Bing e outras propriedades da Microsoft.
{MatchType}
O que ele retorna O tipo de correspondência usado para veicular um anúncio. Isso pode ser diferente de {BidMatchType}. Por exemplo, se você fizer um lance em uma correspondência ampla e o termo de pesquisa for uma correspondência exata. Isso pode ajudar a determinar quais tipos de correspondência estão recebendo o maior número de cliques. e=exata p=frase b=ampla b=expandido (a correspondência expandida é tratada como uma correspondência ampla)
{BidMatchType}
O que ele retorna O tipo de correspondência de lance de palavra-chave. Isso pode ser diferente de {MatchType}. Por exemplo, se você fizer um lance em uma correspondência ampla e o termo de pesquisa for uma correspondência exata. Quando usado com {MatchType}, isso pode ajudá-lo a refinar suas estratégias de lance, palavra-chave e página de aterrissagem. be=exata com lance bp=frase com lance bb=ampla com lance
{Network}
O que ele retorna O tipo de rede de anúncios em que o anúncio foi veiculado. o = pertencente e operada (resultados de pesquisa do Bing, AOL e Yahoo) s = sindicalizada (resultados de sites de parceiros de pesquisa) a = audiência (posicionamentos do Microsoft Audience Network) Por exemplo, suponha que sua URL de destino seja www.northwindtraders.com/network={Network}. Considerando que sua rede (distribuição de anúncios) seja a pesquisa do Bing, AOL e Yahoo (somente pertencente e operada), a URL de destino será www.northwindtraders.com/network=o.
{Device}
O que ele retorna Um dos seguintes códigos, dependendo de onde o clique veio. Essa lista pode ajudá-lo a determinar que tipos de dispositivos estão gerando mais cliques. Em seguida, você pode personalizar seus anúncios e lances da maneira adequada. m=dispositivo móvel t=dispositivo tablet c=computador desktop ou laptop
{IfMobile:string}
O que ele retorna O texto da cadeia de caracteres (que você define) à direita dos dois-pontos, se o anúncio é exibido em um dispositivo móvel. Por exemplo, se o parâmetro for: {IfMobile:adDisplayedOnMobile} e seu anúncio for exibido em um dispositivo móvel, seu log do servidor receberá: adDisplayedOnMobile.
{IfNotMobile:string}
O que ele retorna O texto da cadeia de caracteres (que você define) à direita dos dois-pontos se o anúncio é exibido em um desktop, laptop ou tablet. Por exemplo, se o parâmetro ficar assim: {IfNotMobile:adNotOnMobile} e seu anúncio for exibido em um dispositivo móvel, seu log do servidor receberá: adNotOnMobile.
{IfSearch:string}
O que ele retorna O texto da cadeia de caracteres (que você define) à direita dos dois-pontos, se o anúncio é exibido na rede de pesquisa. Por exemplo, se o parâmetro ficar assim: {ifsearch:adDisplayedOnSearch} e seu anúncio for exibido na rede de pesquisa, seu log do servidor receberá: adDisplayedOnSearch.
{IfNative:string}
O que ele retorna O texto da cadeia de caracteres (que você define) à direita dos dois pontos será substituídos na URL se o anúncio for exibido como um Anúncio de Audiência da Microsoft. Por exemplo, se o seu parâmetro for assim: {IfNative:nativeAd} e seu anúncio tiver sido exibido como um anúncio de audiência, seu log de servidor receberá: nativeAd.
{IfPLA:string}
O que ele retorna O texto da cadeia de caracteres (que você define) à direita dos dois pontos será substituídos na URL se o anúncio for exibido como um anúncio nativo. Por exemplo, se o seu parâmetro for assim: {IfPLA:productAd} e seu anúncio tiver sido exibido como um anúncio de produto, seu log de servidor receberá: productAd.
{AdId}
O que ele retorna A ID numérica do anúncio exibido. Você pode obter a ID do anúncio na tabela Anúncios na página Campanhas. Se a coluna ID do anúncio não for exibida na tabela, clique em Colunas e selecione ID do anúncio. Em seguida, clique em OK.
{keyword:default}
O que ele retorna Substitui a palavra-chave que corresponderau ao termo de pesquisa do usuário. Espaços na palavra-chave serão substituídos por "%20" para garantir que a URL é válida. Observação: Você deve fornecer uma cadeia de caracteres padrão que o sistema usará se a inclusão do valor de substituição fizer com que a cadeia de caracteres expandida exceda o limite de cadeia de caracteres da URL. Não há suporte à substituição de texto padrão. Portanto, você não deve incluir caracteres como um espaço, que fará com que a URL seja inválida.
{msclkid}
O que ele retorna Um ClickID exclusivo para os cliques no anúncio. Para saber mais, confira Descrição da metodologia
{OrderItemId}
O que ele retorna A ID numérica da palavra-chave que disparou a exibição de seu anúncio. Para campanhas de compras, {OrderItemId} retornará a ID do grupo de produtos.
{ param1: default}
O que ele retorna Substitui {Param1} na URL pela configuração de Param1 da palavra-chave que correspondeu ao termo de pesquisa do usuário. Observação: Você deve fornecer uma cadeia de caracteres padrão que o sistema usará se a inclusão do valor de substituição fizer com que a cadeia de caracteres expandida exceda o limite de cadeia de caracteres da URL.
{ param2: default}
O que ele retorna Substitui {Param2} na URL pela configuração de Param2 da palavra-chave que correspondeu ao termo de pesquisa do usuário. Observação: Você deve fornecer uma cadeia de caracteres padrão que o sistema usará se a inclusão do valor de substituição fizer com que a cadeia de caracteres expandida exceda o limite de cadeia de caracteres da URL.
{ param3: default}
O que ele retorna Substitui {Param3} na URL pela configuração de Param3 da palavra-chave que correspondeu ao termo de pesquisa do usuário. Observação: Você deve fornecer uma cadeia de caracteres padrão que o sistema usará se a inclusão do valor de substituição fizer com que a cadeia de caracteres expandida exceda o limite de cadeia de caracteres da URL.
{QueryString}
O que ele retorna O texto da consulta de pesquisa que o usuário digitou.
{copy:queryparameter}
O parâmetro {copy} não funciona com URLs finais, mas funciona com URLs de destino. Quando um anúncio com uma Extensão de Aplicativo, extensão de anúncio de Imagem ou Extensão de Link de Site é veiculado, a cadeia de caracteres {copy} na URL de destino da extensão de anúncio é substituída pelo parâmetro de consulta especificado da URL de destino resolvida do anúncio. A URL de destino resolvida é a URL usada pelo anúncio no momento em que o anúncio é veiculado; depois, todas as cadeias de caracteres de texto dinâmico na URL de destino do anúncio são substituídas por valores reais. Por exemplo, se a URL de destino de uma Extensão de Link de Site contiver {copy:myId} e a URL de destino resolvida do anúncio incluir ?myId=123, a cadeia de caracteres {copy:myId} será substituída por myId=123. Se a URL de destino resolvidoa do anúncio não incluir o parâmetro de consulta, a cadeia de caracteres {copy} será substituída pela parte do nome do parâmetro de consulta. Por exemplo, myId=. Observação Se você atualizar suas URLs de destino de palavra-chave para a URL final, mas ainda não tiver atualizado suas URLs de Extensão de Link de Site, o parâmetro {copy} ainda funcionará para a Extensão de Link de Site. Por exemplo: URL Final de Palavra-chave (atualizada): http://www.example.com?a=1&b=desk URL Móvel de Palavra-chave (atualizada): http://www.example.com?a=1&b=mob URL de Extensão de Link de Site (não atualizada): http://www.example.com?a=1&{copy:b}
{feeditemid}
O que ele retorna A ID da extensão de anúncio que foi clicada.
{loc_physical_ms}
O que ele retorna O código de localização geográfica da localização física do clique. Para obter mais informações sobre códigos de localização geográfica, veja este documento da API do Microsoft Advertising.
{loc_interest_ms}
O que ele retorna O código de localização geográfica da localização de interesse que disparou o anúncio. Para obter mais informações sobre códigos de localização geográfica, veja este documento da API do Microsoft Advertising

Importante

Os parâmetros personalizados retornarão a variável se adicionados a um modelo de acompanhamento, mas retornarão um valor vazio se adicionados a uma URL de destino.

Somente modelos de acompanhamento expando image

Modelos de acompanhamento devem incluir um parâmetro que insere a URL de sua página de aterrissagem usando {lpurl} ou outros parâmetros avançados. Depois que seu anúncio for clicado, esses parâmetros inserirão a URL final. Se você não incluir um parâmetro de inserção de URL no modelo de acompanhamento, a URL da página de aterrissagem não funcionará.

Configuração básica de {lpurl}

Quando usar:

Você pode acompanhar as marcas na página de aterrissagem real.

Estrutura do modelo de acompanhamento:

{lpurl}, um ponto de interrogação e, em seguida, os parâmetros

Exemplo:

URL final:	http://example.com
Modelo de acompanhamento:	{lpurl}?matchtype={matchtype}
URL da página de aterrissagem:	http://example.com?matchtype={matchtype}

Parâmetros e redirecionamento de {lpurl} 1

Quando usar:

Você tem um redirecionamento para um site de acompanhamento e deseja enviar parâmetros a ele.

Estrutura do modelo de acompanhamento:

URL de redirecionamento, um ponto de interrogação, url={lpurl}, um E comercial e, em seguida, os parâmetros

Exemplo:

URL final:	http://example.com
Modelo de acompanhamento:	http://tracker.com?url={lpurl}&matchtype={matchtype}
URL da página de aterrissagem:	http://tracker.com?url=http%3A%2F%2Fexample.com&matchtype={matchtype}

{lpurl} 1 redirecionamento e parâmetros da página de aterrissagem (modelo de acompanhamento)

Quando usar:

Você tem um redirecionamento para um site de acompanhamento e deseja enviar parâmetros à página de aterrissagem usando um modelo de acompanhamento.

Estrutura do modelo de acompanhamento:

URL de redirecionamento, um ponto de interrogação, url={lpurl}, %3F, %26 e, em seguida, os parâmetros

Como {lpurl} não está no início do modelo de acompanhamento, você precisa adicionar %3F após {lpurl} em vez de um ponto de interrogação. Você também precisa substituir o E comercial (&) por %26.

Exemplo:

URL final:	http://example.com
Modelo de acompanhamento:	http://tracker.com?url={lpurl}%3F%26matchtype={matchtype}
URL da página de aterrissagem:	http://tracker.com?url=http%3A%2F%2Fexample.com%3F%26matchtype={matchtype}

{lpurl} um redirecionamento e parâmetros da página de aterrissagem (modelo de acompanhamento)

Quando usar:

Você tem um redirecionamento para um site de acompanhamento e deseja enviar parâmetros à página de aterrissagem sem usar um modelo de acompanhamento.

Estrutura do modelo de acompanhamento:

URL de redirecionamento, um ponto de interrogação, url={lpurl}

Ideal para armazenar parâmetros da página de aterrissagem na URL final ao usar uma URL de redirecionamento para que o Bing não faça toda a codificação dentro de {lpurl} ao avaliar o modelo de acompanhamento.

Exemplo:

URL final:	http://example.com?matchtype={matchtype}
Modelo de acompanhamento:	http://tracker.com?url={lpurl}
URL da página de aterrissagem:	http://tracker.com?url=http%3A%2F%2Fexample.com%3F%26matchtype={matchtype}

Observação

Recomendamos que você coloque {lpurl} no início do modelo de acompanhamento. Caso contrário, a URL final será seguida por um caractere de escape. Todos os caracteres que não forem letras, números ou os seguintes caracteres de pontuação terão um escape adicionado: -, _, ., !, *, (, e ).

Parâmetros avançados

Existem também parâmetros avançados que podem ser usados se você tem mais de um redirecionamento ou quer usar URLs seguidas ou não por caracteres de escape. Aqui está um breve resumo:

Parâmetro

O que ele retorna

{lpurl+2}

A URL Final, com dois caracteres de escape. Também conhecido como codificação dupla. Você usa isso quando tem dois redirecionamentos antes de atingir a página de aterrissagem.

URL final:	http://example.com
Modelo de acompanhamento:	http://a-tracker.com?urlb=http%3A%2F%2Fb-tracker.com%3Furl%3D{lpurl+2}
URL da página de aterrissagem:	http://a-tracker.com?urlb=http%3A%2F%2Fb-tracker.com%3Furl%3Dhttp%253A%252F%252Fexample.com

{lpurl+3}

A URL Final, com três caracteres de escape. Também conhecido como codificação tripla. Você usa isso quando tem três redirecionamentos antes de atingir a página de aterrissagem.

URL final:	http://example.com
Modelo de acompanhamento:	http://a-tracker.com?urlb=http%3A%2F%2Fb-tracker.com%3Furlc%3Dhttp%253A%252F%252Fc-tracker.com%253Furl%253D{lpurl+3}
URL da página de aterrissagem:	http://a-tracker.com?urlb=http%3A%2F%2Fb-tracker.com%3Furlc%3Dhttp%253A%252F%252Fc-tracker.com%253Furl%253Dhttp%25253A%25252F%25252Fexample.com

{unescapedlpurl}

A URL Final, sem um caractere de escape.

{escapedlpurl}

A URL Final, com um caractere de escape. Adiciona um escape a todos os caracteres que não são letras, números ou os seguintes caracteres de pontuação: -, _, ., !, *, ( e ).

{escapedlpurl+2}

A URL Final, com dois caracteres de escape. É útil quando você tem uma cadeia de redirecionamentos.

{escapedlpurl+3}

A URL Final, com três caracteres de escape. É útil quando você tem uma cadeia de redirecionamentos.

Quais caracteres adicionar após o parâmetro de inserção de URL? expando image

Como visto nos exemplos acima, o que você adiciona após o parâmetro de inserção de URL depende de onde no modelo de acompanhamento ele é colocado. Você deve cumprir as regras a seguir, caso contrário, seu site/sistema de terceiros pode não salvar corretamente as informações de seus parâmetros de URL.

Parâmetro	Local do modelo de acompanhamento	Seguido de	Exemplo
{lpurl}	No início	?	{lpurl}?
{lpurl}	Não no início	%3F	{lpurl}%3F
{lpurl+2}	Não no início	%253F	{lpurl+2}%253F
{lpurl+3}	Não no início	%25253F	{lpurl+3}%25253F
{unescapedlpurl}	Em qualquer lugar	?	{unescapedlpurl}?
{escapedlpurl}	Em qualquer lugar	%3F	{escapedlpurl}%3F
{escapedlpurl+2}	Em qualquer lugar	%253F	{escapedlpurl+2}%253F
{escapedlpurl+3}	Em qualquer lugar	%25253F	{escapedlpurl+2}%253F

O Microsoft Advertising substituirá o ponto de interrogação no modelo de acompanhamento por um e comercial ou uma versão com caractere de escape correto de um E comercial, se a URL final já contiver um ponto de interrogação.

Apenas URL final expando image

Parâmetro	O que ele retorna
{ignore}	Ignora os elementos de acompanhamento de URL Final para ajudar a reduzir a carga de rastreamento em seu site. Só pode ser usado na URL Final ou na URL móvel Final. Por exemplo, se a URL Final for http://www.example.com/product?p1=a&/p2=b&p3=c&p4=d, e as informações de acompanhamento após o ponto de interrogação na URL não alterarem a página de aterrissagem, você poderá inserir {ignore} antes de suas informações de acompanhamento para indicar que tudo depois disso consiste simplesmente em informações acompanhamento. Aqui está um exemplo de como fazer isso: http://www.example.com/product?{ignore}p1=a&p2=b&p3=c&p4=d

Parâmetro

O que ele retorna

{ignore}

Ignora os elementos de acompanhamento de URL Final para ajudar a reduzir a carga de rastreamento em seu site. Só pode ser usado na URL Final ou na URL móvel Final.
Por exemplo, se a URL Final for http://www.example.com/product?p1=a&/p2=b&p3=c&p4=d, e as informações de acompanhamento após o ponto de interrogação na URL não alterarem a página de aterrissagem, você poderá inserir {ignore} antes de suas informações de acompanhamento para indicar que tudo depois disso consiste simplesmente em informações acompanhamento. Aqui está um exemplo de como fazer isso: http://www.example.com/product?{ignore}p1=a&p2=b&p3=c&p4=d

Aqui estão alguns itens para ter em mente ao usar {ignore}

{ignore} não pode ser inserido em outros parâmetros.
Você deverá usar {ignore} em sua URL Final se nada em sua URL Final puder ser modificado por terceiros quando alguém clicar em seu anúncio.

Campanhas de Compras da Microsoft Somente expando image

Se você anunciar com anúncios de produtos em suas Campanhas de Compras da Microsoft, a DestinationUrl de um BiddableAdGroupCriterion poderá incluir as cadeias de caracteres de texto dinâmico a seguir. As cadeias de caracteres diferenciam maiúsculas de minúsculas e devem incluir as chaves de abertura e fechamento.

Parâmetro	O que ele retorna
{CriterionId}	O identificador do grupo de produtos de Microsoft Shopping usado com anúncios de produtos. Observação: Para campanhas de compras, {CriterionId} é o mesmo que {OrderItemId}.
{OrderItemId}	O identificador do grupo de produtos de Microsoft Shopping usado com anúncios de produtos. Observação: Para campanhas de compras, {OrderItemId} é o mesmo que {CriterionId}.
{product_channel}	O tipo de canal de compras (online ou local) em que o produto no anúncio clicado é vendido.
{product_country}	O país/região de venda do produto no anúncio clicado. Por exemplo, EUA, Reino Unido etc.
{ProductId}	A ID numérica do produto que disparou seu anúncio. Esse item vem de seu catálogo do Microsoft Merchant Center e é usado com anúncios de produtos.
{product_language}	O idioma de suas informações de produto, como indicado no feed de dados do Merchant Center. Por exemplo, EN, FR.
{seller_name}	O valor associado do vendedor para esse produto, que pode ser o nome do vendedor do feed ou o nome da loja, dependendo de o anunciante ser um agregador ou não.