API de conversões LinkedIn para servidor GTM

Assim como outras plataformas de marketing, o LinkedIn passou a oferecer um método para monitorar conversões no servidor.

Há uma tag CAPI oficial do LinkedIn disponível na galeria do Gerenciador de Tags do Google. Porém, no momento, a API do LinkedIn está fechada e não está aceitando novos registros, estando disponível apenas para desenvolvedores que cumprem critérios específicos.

Vantagens da API de Conversão do LinkedIn:

  • Atribuição de conversão mais precisa
  • Maior confiança nos dados
  • Otimização da entrega de anúncios
  • Redução do custo por ação
  • Melhora no rendimento dos anúncios

Desduplicação da CAPI do LinkedIn

É recomendado pelos profissionais do LinkedIn que se utilize tanto a Insight Tag (para rastreamento web) quanto a API de conversões (para rastreamento do lado do servidor). No entanto, isso pode resultar em contagens duplicadas de eventos, sendo necessário realizar uma desduplicação.

Cada método de implementação, como a Tag Insight e a API de conversões, precisa de uma regra de conversão própria. Eventos idênticos, provenientes do navegador e do servidor, necessitam do mesmo event_id, assim como ocorre com os eventos do Facebook.

Configurando a CAPI do LinkedIn

A tag é simples e exige apenas a inserção de quatro campos, sendo dois deles opcionais. São necessários o Token de Acesso da API do LinkedIn, o ID da Regra de Conversão, o ID do Evento e o Valor de Conversão (este último sendo opcional).

  1. Token de acesso da API do Linkedin – veja aqui e aqui para saber mais sobre como gerar um token de acesso.
  2. ID da regra de conversão – O ID da regra de conversão pode ser encontrado navegando até a regra de conversão no LinkedIn Campaign Manager e abrindo a página de configurações. Nesta tela, selecione Usar um gerenciador de tags, role para baixo e veja o ID de conversão do Gerenciador de tags do Google. 
  3. ID do Evento – o ID exclusivo para indicar cada evento. É necessário se você enviar eventos da web e do servidor. Assim como o Facebook, o eventID indica que os mesmos eventos são enviados da web e do servidor.
  4. Valor de conversão – deve conter o código da moeda no padrão ISO e o valor do valor em uma string decimal. É opcional, mas é necessário se você deseja que seu ROAS e outros parâmetros semelhantes no LinkedIn ADS funcionem corretamente.

A complexidade surge ao garantir que os campos obrigatórios sejam especificados corretamente. Há critérios para a identificação do usuário, e pelo menos um deles precisa ser transmitido com o evento.

A tag CAPI do LinkedIn automatiza o mapeamento de certos parâmetros dos dados de eventos do sGTM, mas esta ainda é uma primeira versão, com atualizações esperadas para torná-la mais eficaz.

Configurar a tag parece simples à primeira vista. A parte complicada é que só funcionará com precisão se você especificar os campos obrigatórios na tag. Existe uma lista de critérios para identificação do usuário, e pelo menos um deles deve ser passado junto com o evento:

  • Um userId válido com idType SHA256_EMAIL 
  • Um userId válido com idType LINKEDIN_FIRST_PARTY_ADS_TRACKING_UUID 
  • Um userId válido com idType ACXIOM_ID 
  • Um userId válido com idType ORACLE_MOAT_ID 
  • Uma combinação userInfo válida que requer firstName e lastName

Como você pode ver, você não especifica esses dados em nenhum lugar da tag; a tag espera que você a passe nos dados do evento sGTM.

Esta é a primeira versão do Linkedind CAPI e será atualizada futuramente pois a solução não é a ideal. Esperançosamente, o LinkedIn adicionará uma opção para inserir dados para parâmetros específicos dentro da tag manualmente.

A tag Linkedin CAPI mapeia automaticamente os seguintes parâmetros dos dados de eventos sGTM:

1. ACXIOM_ID

Identificador do usuário para correspondência com o gráfico de identidade do LiveRamp.

A tag procura nos dados do evento pela chave ‘user_data.acxiomID’

2. ORACLE_MOAT_ID

Identificador de usuário para correspondência com o Oracle MOAT Identity.

A tag procura nos dados do evento pela chave ‘user_data.moatID’

3. Moeda

A tag procura nos dados do evento pela chave ‘currency’.

4. LINKEDIN_FIRST_PARTY_ADS_TRACKING_UUID

ID do cookie primário. Os anunciantes precisam ativar o acompanhamento de conversões aprimorado do Campaign Manager para ativar cookies primários que acrescentam um parâmetro de ID de clique li_fat_id aos URLs de clique.

Estranhamente, a tag não usa cookies dos cabeçalhos como a maioria das tags faz.

5. Dados do usuário

A tag espera que um objeto user_data nos dados do evento sGTM contenha:

  • sha256_email_address
  • endereço.primeiro_nome
  • endereço.último_nome
  • cargo
  • nome da empresa
  • endereço.país
  • linkedinFirstPartyId
  • fossoID
  • acxiomID

Observação!

A estrutura da variável Dados fornecidos pelo usuário é tomada como base, mas campos personalizados são adicionados a ela. Portanto, você não pode simplesmente usá-lo assim, você precisará usar a transformação para adicionar todos os dados adicionais, como jobTitle ou companyName, se, por exemplo, usar UPD também para Google ADS.

Nota Importante

É fundamental notar que, diferentemente de outras tags, esta não transforma os dados em hash se fornecidos em sua forma original. Segundo a documentação, apenas o e-mail necessita de hash; os outros dados são enviados de forma bruta.

Conclusão

O suporte ao rastreamento no servidor ou híbrido com desduplicação por mais plataformas é um avanço bem-vindo, e o LinkedIn faz parte desse movimento. No entanto, a tag atual ainda tem espaço para melhorias e requer um conhecimento profundo do GTM e sGTM, além da capacidade de interpretar códigos de terceiros e acesso ao beta do LinkedIn CAPI.

Espero que tenha gostado e até a próxima