A funcionalidade de conversões pode ser acessada dentro do menu de vendas 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.
Nessa 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.
Confira aqui o passo a passo de como utilizar a ferramenta de conversão
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.
Nota: Você pode acessar um exemplo de arquivo .CSV aqui
Novidade: Agora é possível adicionar os itens do pedido no arquivo .CSV ou no payload (quando realizar a importação via API).
Você pode acessar um exemplo de arquivo .CSV com itens aqui
No tópico "Importação de conversão via upload de arquivo API" você pode ver exemplos de payloads válidos nos prints de exemplo.
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:
Nota: Ao realizar a importação, uma pré-validação é realizada (cabeçalho, etc...), caso seja encontrada alguma inconsistência, um pop-up informando o erro (e a correção sugerida) é exibida:
Importante: As validações iniciais são focadas na estrutura, formato e tamanho do arquivo, estes erros só serão “pegos” no momento que o arquivo for processado (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:
Nota: Existem duas "ações" possíveis com os arquivos já processados, sendo a de exclusão e nos arquivos com status "erro", você pode realizar o download de um arquivo que todos os erros encontrados no arquivo.
Para excluir, um arquivo, basta clicar no ícone de lixeira na coluna "Ações", um pop-up irá aparecer solicitando que você confirme a exclusão, e então a mesma será realizada e os dados importados serão removidos da base. Porem tenha em mente que somente importações com menos de 48h (pós importação) podem ser excluídas; após isso, não é mais possível remover a importação.
Caso você tente excluir um arquivo com mais de 48h de importação, um pop-up informando o erro irá aparecer na tela:
Sobre o download de erros do arquivo, ao lado do status de "Erro" haverá um botão, basta clicar nele que o download será realizado automaticamente:
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: