Importação de chats

Caso os usuários prefiram obter informações ou efetuar pedidos usando apps de mensagem (WhatsApp, Telegram ou Viber) ao interagirem com o seu site, é possível rastrear esses contatos através de eventos de chat e vinculá-los às ações do usuário no site.

A importação de chats contribui para:

• Saber quantas conversas via chat aconteceram.
• Estimar a qualidade delas: por exemplo, descobrir quantos chats não foram respondidos.
• Avaliar os resultados. É possível ver se uma conversa resultou numa compra, por exemplo.
• Ter um panorama melhor das suas interações com os clientes e ver se os canais de publicidade que geram conversas em apps de mensagem são eficazes.

Como rastrear chats no Yandex Metrica

Para coletar dados, utilize um serviço de rastreamento de chat ou alguma solução personalizada e depois transmita os dados de chat para o Yandex Metrica usando a API.

O Yandex Metrica rastreia conversas usando objetivos: quando você transmite dados de conversão de chat pela primeira vez, o serviço automaticamente cria uma objetivo especial Chat. Esse objetivo automático aparece então na página de gerenciamento de objetivos, na interface do Yandex Metrica.

Não é preciso criar um objetivo distinto manualmente: o Yandex Metrica vai reconhecer os eventos de chat transmitidos e começar a contabilizar conversões.

O objetivo Chat pode ser adicionado a todo e qualquer relatório do Yandex Metrica. Você poderá visualizar métricas de conversão (conversões, objetivos atingidos etc.) relativas a esse objetivo. Também é possível utilizar o objetivo e suas conversões para otimizar anúncios, ajustar esse objetivo e suas conversões para que só sejam acionados com alguns chats específicos, e adicionar novos objetivos desse tipo.

O que os dados de chat podem transmitir

Você pode usar a API ou algum serviço de rastreamento de apps de mensagem para transmitir informações básicas e adicionais sobre chats para o Yandex Metrica. Entre os dados necessários incluem-se os dados que permitem identificar um evento de chat por horário e app de mensagem, assim como as IDs de uma conversa. Além disso, é possível transmitir métricas usadas para avaliar a qualidade e valor dos chats.

Para informações a respeito de dados disponíveis e como eles são usados nos relatórios, leia abaixo.

Campos para upload de chat

Informações	Obrigatório?	Descrição
Data e horário do chat (Unix time, UTC)	Sim	Usado para registrar o evento de chat. Deve ser especificado no formato Unix timestamp (UTC).
Plataforma de chat (app de mensagem: whatsapp, telegram, viber)	Sim	O nome do app de mensagem. Valores aceitos: whatsapp, telegram e viber.
IDs de chat (nome de usuário, ID, número de telefone)	Sim (pelo menos uma ID)	Pelo menos um dos seguintes campos deve ser preenchido: ChatUsername, ChatUserID ou PhoneNumber.
Resposta ao chat (se o usuário recebeu ou não uma resposta)	Não	Registra se algum atendente respondeu ao chat. Valor: 1 ou 0.
Tags de chat	Não	Uma tag de texto de até 100 caracteres. Usada para segmentação de chat.
Quantia de conversão (valor do chat) e moeda	Não	Utilize para transmitir dados de receita relativos a um chat: um valor numérico e um código de moeda ISO 4217.
URL da página na qual o chat foi iniciado no site	Não	A URL da página na qual o usuário iniciou a conversa.
Link de um serviço de rastreamento de apps de mensagem	Não	Um link técnico para o chat no sistema de rastreamento, usado para análise interna.

Como transmitir dados de chat

Há duas maneiras de se fazer a integração:

• Usando serviços de rastreamento de chat

  O serviço fornece um código, que pode ser um widget ou um script, para ser adicionado ao seu site. O snippet de código coleta automaticamente as IDs necessárias e prepara os eventos para a importação no Yandex Metrica.

• Diretamente por meio da API

  Para este método, siga as recomendações abaixo.

Passo 1. Coletar IDs de usuário

Objetivo: assegurar que os chats estejam vinculados a sessões do site ou a cliques em anúncios.

• Caso você utilize um serviço de rastreamento de chat

  Basta instalar o snippet de código que lhe foi fornecido. Ele obtém e transmite as IDs necessárias para o Yandex Metrica de forma automática, inclusive:

  • ClientID da _ym_uid.
  • UserID, caso necessária.
  • Yclid, para tráfego do Yandex Direct.

• Caso você utilize uma integração personalizada

  Transmitir uma ou mais das seguintes IDs:

  • ClientID: o identificador principal de um usuário no Yandex Metrica. Recomendamos que você a envie caso um chat tenha se originado de uma sessão do site.
  • UserID: sua ID de usuário interna, caso a funcionalidade UserID esteja habilitada.
  • Yclid: a ID de um clique, usada no Yandex Direct. Útil para quando o usuário vai direto para o app de mensagem, sem visitar o site.
  • PurchaseID: a ID do pedido, usada caso o chat esteja vinculado a uma transação específica. Trata-se de um caso raro.

Se nenhuma ID for transmitida, o evento será considerado sem atribuição e não será vinculado a nenhuma sessão ou clique.

Passo 2. Adicionar sua própria ID de chat a links de apps de mensagem

Objetivo: fazer a correspondência explícita do chat com as IDs Yandex Metrica do Passo 1 quando uma nova conversa for iniciada.

Recomendamos o seguinte algoritmo, que é usado por serviços de rastreamento de chat e também funciona com integrações personalizadas:

1. Gerar uma ID de chat única. Por exemplo, CT8F2A9.

2. O snippet de código instalado no seu site vai adicionar essa ID a cada link de app de mensagem:

   • Robô do Telegram: através de um deeplink (parâmetro de lançamento). O usuário não verá a ID, mas o robô a receberá quando contatado pela primeira vez.
   • Contas pessoais no Telegram, WhatsApp ou Viber: através de um modelo de primeira mensagem pré-preenchido com a ID. Por exemplo, a ID pode ser informada em forma de tag técnica no final de uma mensagem.

3. Depois que a conversa se inicia, o serviço obtém a ID do chat do deeplink ou da primeira mensagem e faz a correspondência dela com as IDs Yandex Metrica coletadas anteriormente: ClientID, UserID, Yclid.

4. O serviço então estabelece um vínculo ID do chat ↔ IDs Yandex Metrica forte, suficiente para uma atribuição correta.

Passo 3. Importar eventos para o Yandex Metrica

Depois que o vínculo for estabelecido, você pode começar a transmitir eventos de chat por meio da API importadora de chats do Yandex Metrica. Os requisitos relativos à formatação dos dados (o horário do evento, valores aceitáveis pela plataforma, estrutura dos campos etc.) estão descritos na especificação da API.

Fale conosco

---