A funcionalidade de conversões pode ser acessada dentro do menu de automação na aba lateral esquerda do site da OmniChat, conforme o exemplo abaixo:
Através dessa tela, o usuário pode compartilhar as suas informações de conversão com a OmniChat para calcular o ROAS das campanhas e determinar a influência da OmniChat em conversões concluídas em outros canais.
Nesta tela o usuário poderá visualizar uma lista de todas os processos de importações de conversões realizados, seja por arquivo ou API, e seus respectivos status. Nessa tela o usuário também tem a possibilidade de enviar novas importações, através do upload de arquivo.
Como realizar a importação do arquivo?
Existem duas formas de fazer o upload das informações, sendo respectivamente via tela de conversões na página da OmniChat e pela API; vamos a elas:
Importação de conversão via upload de arquivo CSV:
Ao acessar a tela de conversões (conforme a primeira imagem deste documento), clicar no botão Importar no canto superior direito da tela:
Será carregado um pop-up solicitando o upload do arquivo, também será solicitado que seja dado um nome para a sua importação:
Como deve ser montado o arquivo que será importado?
Para se realizar a importação de um arquivo pela ferramenta, algumas regras devem ser respeitadas:
O arquivo deve ser no formato .CSV
O arquivo deve ter tamanho máximo de 6MB
A separação dos itens deve ser feita por vírgula (,) ou ponto e vírgula (;)
Importante: As colunas do arquivo CSV possuem validação “Case Sensitive”, tenha isso em mente quando for formatar o arquivo.
Abaixo um exemplo de um arquivo CSV válido:
type,origin,channel,eventDate,customData.value,customData.externalId,customer.countryCode,customer.phoneNumber,customer.email,customer.name,customer.lastName ORDER,ERP,Filial Barigui,2022-03-08T15:24:33.955Z,1234.56,ORD-AS8988SDS,55,41991929394,omni.chat@omni.chat,Ednaldo,Pereira
|
No campo nome da importação são permitidos no máximo, 100 caracteres (e no mínimo 3 caracteres), caso você ultrapasse esse limite, um alerta é exibido na tela:
O mesmo vale para o campo de upload do arquivo, caso o arquivo selecionado não respeite as regras (formato e tamanho), será exibido um alerta de erro no campo, e o botão Importar continuará desabilitado:
Caso o arquivo esteja dentro dos parâmetros solicitados e a importação nomeada corretamente, o botão Importar será habilitado:
Importante: A tela só valida o formato e o tamanho do arquivo, caso o mesmo possua algum erro em seus dados, estes erros só serão “pegos” no momento que o arquivo for processo (pós upload)
Caso deseje substituir o arquivo anexado, basta clicar na lixeira, conforme indicado na imagem abaixo:
Importante: Caso seja anexado algum arquivo com erro (como mostrado nas imagens anteriores), não existe a necessidade de fechar o pop-up e abri-lo novamente, basta arrastar o novo arquivo para o campo indicado que o mesmo substituirá o anterior.
Após clicar em Importar, um alerta com a mensagem “Arquivo importado com sucesso” será exibido na parte superior central da tela, e a importação realizada será incorporada na lista com o status “Criado”:
Após o processamento do arquivo, o mesmo terá o seu status atualizado;
Se todos os dados forem computados corretamente, o status será alterado para Finalizado, caso contrário, o status será alterado para Erro:
Importação de conversão via upload de arquivo API:
Existem dois métodos que podem ser utilizados na API:
Para se realizar a importação de dados via API, é necessário inserir os valores “x-api-key” e “x-api-secret” no header, esses dados podem ser obtidos na página da OmniChat, acessando pelo menu lateral esquerdo: Configurações > Integrações > API. Tanto o método POST quanto o método GET necessitam desses dados no header.
Os dados da importação devem ser inseridos no body da requisição, conforme exemplo abaixo:
Ao realizar a requisição, caso esteja tudo correto, será gerado um ID como resposta da requisição:
É possível consultar o sucesso da requisição utilizando o método GET informado neste documento, basta realizar a requisição que o mesmo irá retornar a lista de importações realizadas pelo usuário conforme exemplo abaixo:
Para consultar o status do processamento, basta voltar a tela da OmniChat, a requisição estará junto as demais importações na lista: