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ê adiciona parâmetros de URL ao seu URL de destino ou modelo de rastreamento para descobrir como os visitantes chegaram ao seu site. Os parâmetros de URL permitem rastrear 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, delimitado por { } que informa Microsoft Advertising quais dados você deseja retornar quando um anúncio é clicado. Os parâmetros específicos para escolher estão listados na tabela abaixo.
Uma variável que você define para armazenar esses dados. O nome da variável fica a seu critério, mas deve ser o nome utilizado no script do seu site para armazenar o valor que o parâmetro está retornando. Trabalhe com os programadores do seu site que podem ajudá-lo a definir os nomes apropriados a serem usados.

Juntando tudo, fica assim:

www.yourLandingPageURL.com? variável={ parâmetro}

Se você estiver adicionando mais de uma variável={ parâmetro}, separe o par variável/parâmetro com um e comercial ( &).

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 acionou o anúncio. Por exemplo, suponha que seu URL de destino seja www.northwindtraders.com/{CampaignId}. Supondo que a ID da sua campanha seja 2410012280, o URL de destino será www.northwindtraders.com/2410012280.
{Campaign}
O que ele retorna O nome da campanha que acionou o anúncio. Por exemplo, suponha que seu URL de destino seja www.northwindtraders.com/{Campaign}. Supondo que o nome da sua campanha seja Venda, o URL de destino será www.northwindtraders.com/Venda.
{AdGroupId}
O que ele retorna A ID do grupo de anúncios que acionou o anúncio. Por exemplo, suponha que seu URL de destino seja www.northwindtraders.com/{AdGroupId}. Supondo que a ID do seu grupo de anúncios seja 2410012280, o URL de destino será www.northwindtraders.com/2410012280.
{AdGroup}
O que ele retorna O nome do grupo de anúncios que acionou o anúncio. Por exemplo, suponha que seu URL de destino seja www.northwindtraders.com/{AdGroup}. Presumindo que o ID do seu grupo de anúncios seja Clearance, o 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, eles aparecerão na seguinte ordem: aud, dat, kwd, pla. Por exemplo, se você associar a lista de remarketing "1234" à palavra-chave "5678", o {TargetId} será substituído por "aud-1234:kwd-5678". Observação: o público-alvo no mercado e a segmentação de perfil LinkedIn não podem ser rastreados por meio desse parâmetro, pois isso exporia o comportamento individual do usuário no Bing e em outras propriedades da Microsoft.
{MatchType}
O que ele retorna O tipo de correspondência usado para exibir um anúncio. Isso pode ser diferente do {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 você a determinar quais tipos de correspondência estão recebendo mais 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 lances, palavras-chave e páginas 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 ( Microsoft Audience Network posicionamentos) Por exemplo, suponha que seu URL de destino seja www.northwindtraders.com/network={Network}. Supondo que sua rede (distribuição de anúncios) seja apenas Bing, AOL e pesquisa do Yahoo (propriedade e operação), o URL de destino será www.northwindtraders.com/network=o.
{Device}
O que ele retorna Um dos seguintes códigos, dependendo de onde veio o clique. Esta lista pode ajudá-lo a determinar que tipo de dispositivos estão gerando mais cliques. Você pode personalizar seus anúncios e lances de acordo. m=dispositivo móvel t=dispositivo tablet c=computador desktop ou laptop
{IfMobile:string}
O que ele retorna O texto cadeia de caracteres (definido por você) à direita dos dois pontos se o anúncio for exibido em um dispositivo móvel. Por exemplo, se seu parâmetro for {IfMobile:adDisplayedOnMobile} e seu anúncio for exibido em um dispositivo móvel, seu log de servidor receberá adDisplayedOnMobile.
{IfNotMobile:string}
O que ele retorna O texto cadeia de caracteres (definido por você) à direita dos dois pontos se o anúncio for exibido em um computador, laptop ou tablet. Por exemplo, se seu parâmetro for semelhante a: {IfNotMobile:adNotOnMobile} e seu anúncio for exibido em um dispositivo móvel, o log do servidor receberá: adNotOnMobile.
{IfSearch:string}
O que ele retorna O texto cadeia de caracteres (definido por você) à direita dos dois pontos se o anúncio for exibido na rede de pesquisa. Por exemplo, se seu parâmetro for semelhante a: {IfSearch:adDisplayedOnSearch} e seu anúncio for exibido na rede de pesquisa, o log do servidor receberá: adDisplayedOnSearch.
{IfNative:string}
O que ele retorna O texto cadeia de caracteres (definido por você) à direita dos dois-pontos será substituído na URL se o anúncio for exibido como Microsoft Audience Ad. Por exemplo, se seu parâmetro for semelhante a este: {IfNative:nativeAd} e seu anúncio for exibido como um anúncio de público, o log do servidor receberá: nativeAd.
{IfPLA:string}
O que ele retorna O texto cadeia de caracteres (definido por você) à direita dos dois pontos será substituído no URL se o anúncio for exibido como um anúncio de produto. Por exemplo, se seu parâmetro for semelhante a: {IfPLA:productAd} e seu anúncio for exibido como um anúncio de produto, o log do 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 corresponde ao termo de pesquisa do usuário. Os espaços na palavra-chave serão substituídos por "%20" para garantir que a URL seja válida. Nota: 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 do 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, consulte Descrição da metodologia
{OrderItemId}
O que ele retorna O ID numérico da palavra-chave que acionou 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 Param1 da palavra-chave que corresponde ao termo de pesquisa do usuário. Nota: 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 do URL.
{param2:default}
O que ele retorna Substitui {Param2} na URL pela configuração Param2 da palavra-chave que corresponde ao termo de pesquisa do usuário. Nota: 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 do URL.
{param3:default}
O que ele retorna Substitui {Param3} no URL pela configuração Param3 da palavra-chave que corresponde ao termo de pesquisa do usuário. Nota: 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 do 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 gráfico ou extensão de sitelink é veiculado, a cadeia de caracteres {copy} no URL de destino da extensão de anúncio é substituída pelo parâmetro de consulta especificado do URL de destino resolvido do anúncio. O URL de destino resolvido é o URL usado pelo anúncio no momento em que o anúncio é exibido; depois que todas as cadeias de caracteres de texto dinâmico no URL de destino do anúncio forem substituídas por valores reais. Por exemplo, se o URL de destino de uma extensão de sitelink contiver {copy:myId} e o URL de destino resolvido do anúncio incluir ?myId=123, a cadeia de caracteres {copy:myId} será substituída por myId=123. Se o URL de destino resolvido 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ê atualizou seus URLs de destino de palavra-chave para o URL final, mas ainda não atualizou seus URLs de extensão de sitelink, o parâmetro {copy} ainda funcionará para a extensão de sitelink. 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, consulte este API do Microsoft Advertising documento.
{loc_interest_ms}
O que ele retorna O código de localização geográfica do local de interesse que acionou o anúncio. Para obter mais informações sobre códigos de localização geográfica, consulte este API do Microsoft Advertising documento

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

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

{lpurl} Configuração básica

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, quaisquer 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}

{lpurl} 1 redirecionamento e parâmetros

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, quaisquer 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 quaisquer 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} 1 redirecionamento e parâmetros de página de aterrissagem (sem modelo de rastreamento)

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}

É melhor armazenar os parâmetros da página de aterrissagem no URL final ao usar um URL de redirecionamento para que o Bing 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 o {lpurl} no início do modelo de acompanhamento. Caso contrário, o URL final será ignorado. Todos os caracteres que não sejam letras, números ou os seguintes caracteres de pontuação terão escape: -, _, ., !, *, (, e ).

Parâmetros avançados

Também existem parâmetros avançados que você pode usar se tiver mais de 1 redirecionamento ou quiser usar URLs com ou sem escape. Aqui está um rápido resumo:

Parâmetro

O que ele retorna

{lpurl+2}

O URL final escapou duas vezes. Também conhecido como codificação dupla. Você usa isso quando tem 2 redirecionamentos antes de chegar à 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}

O URL Final escapou três vezes. Também conhecida como codificação tripla. Você usa isso quando tem 3 redirecionamentos antes de chegar à 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}

O URL Final, sem um caractere de escape.

{escapedlpurl}

O URL Final, com escape. Escape de todos os caracteres que não sejam letras, números ou os seguintes caracteres de pontuação: -, _, ., !, *, (, e ).

{escapedlpurl+2}

O URL final, escapado duas vezes. Útil quando você tem uma cadeia de redirecionamentos.

{escapedlpurl+3}

O URL final escapou três vezes. Útil quando você tem uma cadeia de redirecionamentos.

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

Conforme visto nos exemplos acima, o que você adiciona após o parâmetro de inserção de URL depende de onde você o coloca no modelo de acompanhamento. Você deve aderir às seguintes regras ou 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}	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

Microsoft Advertising substituirá o ponto de interrogação em seu modelo de acompanhamento por um e comercial ou uma versão com escape correto de um e comercial se seu 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 rastreamento de seu URL final para ajudar a reduzir a carga de rastreamento em seu site. Ele só pode ser usado em seu URL final ou final para dispositivos móveis. Por exemplo, se seu URL final for http://www.example.com/product?p1=a &/p2=b &p3=c &p4=d e as informações de rastreamento seguir o ponto de interrogação no URL não altera a página de destino, você pode inserir {ignore} antes de suas informações de rastreamento para indicar que tudo depois disso são apenas informações de rastreamento. 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 rastreamento de seu URL final para ajudar a reduzir a carga de rastreamento em seu site. Ele só pode ser usado em seu URL final ou final para dispositivos móveis.
Por exemplo, se seu URL final for http://www.example.com/product?p1=a &/p2=b &p3=c &p4=d e as informações de rastreamento seguir o ponto de interrogação no URL não altera a página de destino, você pode inserir {ignore} antes de suas informações de rastreamento para indicar que tudo depois disso são apenas informações de rastreamento. 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 algumas coisas que você deve ter em mente ao usar {ignore}

{ignore} pode ser inserido dentro de outros parâmetros.
Você deve usar {ignore} em seu URL final se algo em seu URL final puder ser modificado por terceiros quando alguém clicar em seu anúncio.

Somente Campanhas de compras da Microsoft expando image

Se você anunciar com anúncios de produtos em seu Campanhas de compras da Microsoft, o DestinationUrl de um BiddableAdGroupCriterion pode incluir as seguintes strings de texto dinâmico. As strings não 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 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 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 de venda do produto no anúncio clicado. Por exemplo, EUA, Reino Unido, etc.
{ProductId}	A ID numérico do produto que acionou seu anúncio. Isso vem de seu catálogo Microsoft Merchant Center e é usado com anúncios de produtos.
{product_language}	O idioma das informações do produto, conforme 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.

Somente Campanhas de Hospedagem da Microsoft expando image

Parâmetro	O que ele retorna
{hotelcenter_id}	A ID da conta do Hotel Center vinculado à campanha que gerou o anúncio quando clicado.
{property_id}	A ID da propriedade do feed de propriedades da conta associada.
{hotel_partition_id}	O ID exclusivo do grupo de hotéis ao qual pertence o anúncio de hotel clicado.
{hotel_adtype}	Hotel se um anúncio de um hotel foi clicado. Roomse um anúncio de um Pacote de Quarto foi clicado.
{travel_start_day} {travel_start_month} {travel_start_year}	O dia, mês e ano da data de check-in exibidos no anúncio.
{travel_end_day} {travel_end_month} {travel_end_year}	O dia, mês e ano de check-out exibidos no anúncio.
{advanced_booking_window}	O número de dias entre a data do clique no anúncio e a data de check-in anunciada (por exemplo, "3" para um anúncio clicado em 5 de junho com data de check-in em 8 de junho).
{date_type}	padrão se o Microsoft Advertising selecionou as datas de início e término (para mostrar os preços representativos do usuário). selecionado se o próprio usuário final escolheu as datas em um seletor de datas.
{number_of_adults}	O número de adultos que ficarão no quarto mostrado no anúncio.
{price_displayed_total}	O custo total do quarto que é exibido para o usuário na moeda local do usuário.
{price_displayed_tax}	O valor dos impostos e taxas exibidos ao usuário na moeda local do usuário.
{user_currency}	Código de moeda de três letras que indica a moeda local do usuário. Esta também é a moeda para {price_displayed_total} e {price_displayed_tax}. Por exemplo, "USD" ou "CAD".
{user_language}	O código de idioma de duas letras que especifica o idioma de exibição do anúncio. Por exemplo, "en" ou "fr".
{adtype}	O tipo de anúncio de viagens que foi clicado. travel_booking se o clique foi em um módulo de reserva. travel_promotedse o clique foi em um anúncio de promoção de propriedade.
{rate_rule_id}	O identificador de qualquer preço especial que foi clicado. Os anunciantes de viagens podem aplicar tarifas condicionais a usuários específicos (por exemplo, membros de fidelidade), dispositivos específicos (por exemplo, desconto para usuários móveis) e países específicos.