Acerca de session_attributes

A importação de conversões offline (ICO) acompanha as conversões offline de importações através do GCLID. Em cenários em que o GCLID não está disponível, os utilizadores da ICO podem usar outros identificadores, como dados fornecidos pelos utilizadores com hash, wbraid/gbraid ou session_attributes.

Nesta página

• Acerca de session_attributes
• Como captar session_attributes
• Como enviar os dados para o Google Ads

---

Acerca de session_attributes

session_attributes é um campo que fornece mais contexto e sinais sobre a interação do utilizador com o seu Website, o que pode melhorar a precisão da medição de conversões, dos relatórios (incluindo a discriminação entre dispositivos) e dos lances. Pode usar o nosso script de interface abaixo para criar a string codificada em base64 de session_attributes, transmiti-la para a sua base de dados/CRM e enviá-la para a Google nas suas importações de APIs. Se não conseguir usar o script de interface, use o campo session_attributes_key_value_pairs para enviar cada par de chave/valor individualmente.

Recomendamos que envie todos os subcampos, mas pode optar por enviar todos os que quiser. Todos os subcampos são opcionais. O tamanho de armazenamento recomendado para o campo session_attributes é de 5 KB. A maioria da utilização não excede este tamanho. Se session_attributes for superior a este valor, colabore com o seu fornecedor de CRM para modificar o tamanho do campo (altamente recomendado) ou remova os parâmetros landing_page_url e landing_page_referrer da função auxiliar de JavaScript.

Veja os subcampos incluídos no campo session_attributes:

• gad_source: um parâmetro agregado publicado no URL para identificar a origem do tráfego proveniente de anúncios. Saiba mais acerca dos parâmetros de URL gad_*.
• gad_campaignid: o ID da campanha publicitária específica que gerou o clique num anúncio. Saiba mais acerca dos parâmetros de URL gad_*.
• landing_page_url: o URL completo da página de destino no seu Website. Isto indica a página específica em que o utilizador chegou pela primeira vez.
• session_start_time_usec: a data/hora em que a sessão do utilizador começou no seu Website. Isto ajuda a monitorizar a duração das visitas dos utilizadores. É importante usar um formato de data/hora em microssegundos época Unix consistente.
• landing_page_referrer: o URL da página Web que direcionou o utilizador para o seu Website. Isto ajuda a saber quais são as origens de tráfego que direcionam para o seu site. Para mais informações sobre Referenciadores, consulte este artigo. Embora o artigo se foque no Analytics, o conceito de referenciador é universal na Web.
• landing_page_user_agent: uma string que identifica o navegador e o sistema operativo do utilizador. Estas informações podem ser úteis para saber qual é o ambiente técnico dos seus utilizadores.

---

Como captar session_attributes

Pode usar a função auxiliar de JavaScript e o formulário HTML abaixo na sua página de destino para captar e persistir session_attributes.

Este código de exemplo persiste os dados no localStorage. Antes de implementar no seu Website, certifique-se também de que todos os requisitos de consentimento e retenção de dados necessários específicos do seu Website são preenchidos conforme necessário.

Formulário HTML

1. Tem de modificar todas as páginas de envio de formulário para adicionar um campo oculto para session_attributes. É deste modo que session_attributes é transmitido ao seu sistema de back-end. Segue-se um exemplo de código para o demonstrar.
   <form action="" name="myForm">
Nome: <input type="text" name="name">
<input type="hidden" id="session_attributes_field" name="session_attributes_field" value="">
<input type="submit" value="Enviar formulário" name="btnSubmit">
</form>
2. Exemplo de script para captar session_attributes_encoded e defini-lo no campo do formulário. Este código de exemplo persiste os dados no localStorage.

   <script>
function getSessionAttributes() {
const searchParams = new URLSearchParams(window.location.search);
if (Array.from(searchParams.keys()).some(key => key.startsWith('gad_')) ||
searchParams.has('gclid') || searchParams.has('gbraid')) {
const params = {};
searchParams.forEach((value, key) => {
if (key.startsWith('gad_')) params[key] = value;
});
params['session_start_time_usec'] =
(new Date().getTime() * 1000).toString();
params['landing_page_url'] = window.location.href;
params['landing_page_referrer'] = document.referrer;
params['landing_page_user_agent'] = navigator.userAgent;
const sessionAttributesEncoded = btoa(JSON.stringify(params))
.replace(/\+/g, '-')
.replace(/\//g, '_')
.replace(/=+$/, '');
localStorage.setItem('google_session_attributes', sessionAttributesEncoded);
return sessionAttributesEncoded;
}
return localStorage.getItem('google_session_attributes') || '';
}

   
   function addSessionAttributes() {
const sessionAttributesEncoded = getSessionAttributes();
var sessionAttributesFormField =
document.getElementById('session_attributes_field');
if (sessionAttributesFormField && sessionAttributesEncoded != '') {
sessionAttributesFormField.value = sessionAttributesEncoded;
}
}
window.addEventListener('load', addSessionAttributes);
</script>

---

Como enviar os dados para o Google Ads

1. Campo session_attributes_encoded na API Google Ads

A partir de 2 de fevereiro de 2026, a API Google Ads vai deixar de aceitar novos utilizadores de atributos da sessão ou dados de endereços IP como parte das importações de conversões. Para garantir uma experiência mais robusta e escalável para o processamento de dados complexos, recomendamos que os programadores da API Google Ads façam a transição para a API Data Manager, onde os atributos de sessão e o endereço IP são aceites, como a API de importação de dados de utilizadores e conversões principal. Saiba mais acerca das alterações à compatibilidade de atributos de endereço IP e sessão na API Google Ads.

Para os utilizadores da importação de conversões offline (ICO) existentes que usam JavaScript, envie estes dados definindo os session_attributes codificados captados a partir do JavaScript fornecido num novo campo denominado ClickConversion.session_attributes_encoded no esquema de carregamento existente. Continue a usar o seu processo de ICO atual, mas defina este novo campo quando fizer importações. O Google Ads usa session_attributes quando os outros identificadores não estão presentes.

Todos os novos utilizadores têm de usar a API Data Manager. Se uma conta não tiver sido incluída na lista de autorizações para transmitir endereços IP ou atributos de sessão através da API Google Ads, recebe uma mensagem de erro para essas conversões.

Nota: o acesso ao novo campo na API Google Ads requer a atualização para a v19 ou posterior.

Avançado

Se não conseguir usar JavaScript, pode captar os pares de chave/valor individuais e enviá-los com as importações de conversões offline.

Para os utilizadores da importação de conversões offline (ICO) existentes que não usam JavaScript, também pode definir o campo de par de chave-valor denominado ClickConversion.session_attributes_key_value_pairs no esquema de carregamento existente. Sugerimos que envie pares de chave/valor com estes campos quando chamar a API. Consulte a documentação para programadores que explica como adicionar pares de chave/valor individuais a uma ClickConversion.

2. Campo session_attributes através do Gestor de dados

Também pode enviar o campo session_attributes através do Gestor de dados.

• IU do Gestor de dados: use o JavaScript fornecido para criar o campo session_attributes e carregá-lo através da IU do Gestor de dados.
• API Data Manager: pode fazer a integração com a API Data Manager para carregar os seus dados de forma programática. Consulte a documentação do Gestor de dados para ver instruções específicas e detalhes do esquema.

Ao enviar os dados certos, permite que o Google Ads use estas informações para atribuir conversões às campanhas corretas e fornecer-lhe relatórios de conversões mais abrangentes.