Se o seu eCommerce está desenvolvido em PrestaShop, você poderá sincronizá-lo com sua conta Connectif em apenas alguns minutos e começar a coletar dados de interação dos seus contatos na página web.
Neste artigo, você aprenderá como integrar sua conta Connectif com seu PrestaShop.
Dificuldade: Baixa.
Quando usar?: Ao abrir sua conta no Connectif.
PASSO 1. Download do módulo
1. Faça login na sua conta Connectif.
2. Acesse Configurações da Loja no menu lateral esquerdo.
3. Na seção Plataformas e-commerce, procure por PrestaShop e clique em Editar.
4. Na seção Configuração, clique em Baixar zip para baixar o arquivo “connectif.zip” no seu computador.
Não feche esta janela! Você precisará dela mais tarde para extrair os dados identificativos da sua conta.
PASSO 2. Instalação do módulo no seu PrestaShop
5. Faça login no backoffice do seu PrestaShop.
6. Acesse “Módulos > Módulos e Serviços”.
7. No canto superior direito, clique em Enviar um módulo.
8. Na janela que abrir, clique em Selecionar o arquivo ou arraste-o para dentro do retângulo pontilhado. O assistente iniciará a instalação automaticamente.
9. Quando o módulo estiver instalado, clique em Configurar.
Também é possível acessar a configuração posteriormente em “Módulos > Módulos e Serviços > Connectif” clicando em Configurar.
PASSO 3. Configuração do módulo no PrestaShop
3.1. Configuração básica
(Nesta seção serão indicados os dados identificativos da sua conta para sincronizá-la e começar a coletar dados de interação dos contatos na web em tempo real).
10. Volte para sua Loja Connectif (seção “Integrações > PrestaShop”) e copie os dados identificativos da sua conta (Identificador do cliente e Chave secreta).
11. Retorne à aba do PrestaShop que você deixou aberta (configuração do módulo) e cole os dados copiados em “Client ID” e “Secret KEY”, respectivamente.
12. Verifique se o campo “Enabled” está selecionado como SIM.
13. Clique em Salvar.
3.2. Banners
14. Não é necessário realizar nenhuma ação nesta seção.
3.3. URLs públicas
(Nesta seção as URLs de cadastro/descadastro da newsletter, bem como a do Service Worker das notificações push, são preenchidas automaticamente).
15. Não é necessário realizar nenhuma ação nesta seção.
Você pode consultar essas URLs na sua conta Connectif:
— Cadastros/descadastros da newsletter, nas configurações da integração:
— Service worker das notificações push, em Configurações da Loja, “Canais > Notificações Push”.
3.4. Campos do formulário de registro
(Nesta seção são indicadas as propriedades do contato coletadas no PrestaShop que se deseja sincronizar com o Connectif).
16. Na seção Campos do contato, aparecem selecionados por padrão “firstname” (nome), “lastname” (sobrenome) e “birthday” (data de nascimento). Se desejar que o Connectif sincronize qualquer uma das outras opções desta seção ou de Campos do endereço, marque “Sim” nos campos desejados.
Para registrar os dados selecionados no perfil de cada contato, será necessário criar um campo personalizado para cada um deles, com a mesma ID indicada na lista (por exemplo, id_gender). Este passo deve ser feito para todos os campos opcionais ativados, exceto para o campo “Newsletter” que capta automaticamente as inscrições. Você pode consultar mais informações a respeito aqui.
3.5. Parâmetros avançados
(Nesta seção são configuradas opções avançadas da integração).
17. Para uma integração básica, não é necessário realizar nenhuma ação nesta etapa. Se desejar realizar uma configuração mais avançada, ative/desative as opções que deseja sincronizar com o Connectif:
Configurações gerais
Ativar multi-idioma: coletar dados de interação dos contatos diferenciando por idiomas.
Incluir categoria raiz na categoria da página: incluir a categoria “Raiz” nas categorias da tag cn_page_category.
Verificar se o hook top não é renderizado mais de uma vez: ativar/desativar cálculo de percentual de desconto baseado nos preços.
Habilitar logs de depuração: ativar/desativar os logs.
Sincronizar as informações do contato no Connectif ao atualizar o cliente pelo backoffice do PrestaShop: sincronizar no contato do Connectif, além dos campos básicos e nativos do módulo, os campos ativados no módulo na aba Campos do formulário de registro na seção Campos do contato. Se a opção multi-idioma estiver ativada, será sincronizado em cada loja do Connectif onde existir o e-mail do contato.
Essas alterações não são enviadas ao Connectif se for feita uma importação de clientes no PrestaShop nem se um cliente for excluído no PrestaShop.
Eventos
Eventos de compra: registrar todas as compras.
Eventos de registro: registrar as atividades de registro.
Eventos de login: registrar os logins do contato.
Eventos de inscrição na newsletter: registrar as inscrições na newsletter.
Estado do carrinho: registrar os eventos do estado do carrinho.
Eventos de busca: registrar os eventos de busca no eCommerce.
Configurações de produto
Usar descrição longa: coletar descrição longa dos produtos.
Usar combinações de produto no carrinho e compras: determinar se, ao receber o Connectif a informação dos produtos do carrinho, coletará o produto padrão ou a combinação específica (tamanho, cor, etc.).
Usar SKU como identificador do produto: utilizar o SKU dos seus produtos no PrestaShop como ID dos produtos no Connectif.
Inclui a categoria raiz sem necessidade de selecioná-la na configuração do produto: enviar para o Connectif a categoria raiz dentro das categorias do produto.
Incluir a categoria somente se estiver ativa: enviar para o Connectif a categoria do produto somente se ela estiver ativa no PrestaShop.
Calcular o percentual de desconto baseado nos preços: ativar/desativar o cálculo que os define automaticamente.
Incluir imposto no desconto: incluir o IVA em produtos com desconto.
Arredondar preços: arredondar preços de produtos no Connectif.
Disponibilidade máxima em dias: define o período em dias, anteriores à data de reposição, em que um produto estará disponível para compra antecipada.
Se os dias restantes até a data de entrada de um produto forem maiores que a disponibilidade máxima em dias, o item será considerado sem estoque, portanto o Connectif não o recomendará nas estratégias ativas.
- Selecionar tamanho da imagem do produto: indicar o tipo de imagem dos produtos que será sincronizado (recomenda-se selecionar a mesma usada na ficha do produto do PrestaShop).
3.6. Envio de compras
(Nesta seção configura-se o envio de compras para o Connectif a partir do módulo do PrestaShop).
18. Através da seção Envio de Compras é possível enviar para o Connectif as compras realizadas na sua loja, indicando um intervalo de datas e os estados a importar.
Para aprender como realizar o envio de compras do PrestaShop para o Connectif, consulte este artigo.
PASSO 4. Configuração em lojas com vários idiomas
Este passo só precisará ser realizado se seu PrestaShop possuir vários idiomas e/ou moedas.
ECommerces multilíngues requerem a abertura de uma conta individual para cada idioma e moeda. Para mais informações, entre em contato com accountmanager@connectif.es.
Para registrar os dados diferenciados por idiomas, no passo anterior (17) deve ter sido ativada a opção “Ativar multi-idioma”.
19. Na aba Configuração básica, clique em .
20. Em uma nova janela do navegador, acesse sua conta Connectif do idioma correspondente e copie os dados identificativos (“Identificador do cliente” e “Chave secreta”), conforme indicado no passo 10.
21. Retorne ao PrestaShop e cole os dados identificativos (“Client ID” e “Secret KEY”).
22. Selecione o idioma e a moeda que deseja sincronizar com essa conta Connectif.
23. No campo “Enabled”, clique em SIM.
24. Clique em Salvar.
Sucesso!
A integração da sua conta Connectif com seu PrestaShop já está pronta.
Para verificar se a integração foi realizada corretamente e se os dados de interação já estão sendo coletados, clique aqui.
RESOLUÇÃO DE PROBLEMAS
Encontre soluções rápidas para os problemas mais comuns ao realizar uma integração com PrestaShop.
1. Que informação o Connectif coleta através desta integração
a. Informação coletada dos Contatos
Nas integrações com PrestaShop, através da tag cn_client_info, é transferida, por padrão, certa informação sobre os Contatos:
- _name
- _surname
- _birthdate
- _newsletter_subscription_status
Além disso, nas configurações do módulo Connectif no PrestaShop há uma seção que permite habilitar outros campos de contato. Esses campos serão adicionados à tag cn_client_info com o mesmo identificador que aparece nessa seção. Para que o Connectif salve o valor, deve existir na Loja Connectif um campo personalizado com o mesmo ID (ver passo 3.5).
b. Informação coletada dos Produtos
Nas integrações com PrestaShop, através da tag cn_product_visited e da sincronização diária do catálogo, é coletada por padrão certa informação sobre os Produtos:
- quantity
- price url
- product_id
- name
- description
- image_url
- unit_price
- availability
- brand
- published_at
- category
- related_external_product_id
- tag
c. Informação coletada das Compras
Nas integrações com PrestaShop, através da tag cn_purchase, é coletada por padrão certa informação sobre as Compras:
- purchase_id
- purchase_date
- payment_method
- cart_id
- total_quantity
- total_price
2. Não são registrados dados de compras, contatos e/ou eventos do carrinho
-
Em Parâmetros avançados, verifique se as seguintes opções estão ativas:
“Eventos de compra”, para registrar dados de compras.
“Eventos de registro”, para coletar dados de contatos.
“Eventos do carrinho”, para captar estados do carrinho.
Caso estejam desativados, clique em Sim nos campos que precisar e em Salvar para habilitá-los.
- Verifique se o módulo Connectif está ancorado ao hook displayTop em “Design > Posições” do PrestaShop.
-
Certifique-se de que seu template não modifica páginas base do PrestaShop (como, por exemplo, o Checkout) e execute o hook displayTop da seguinte forma:
{hook h='displayTop'}
Você pode consultar a informação oficial do PrestaShop clicando aqui.
Configure sua plataforma de pagamento para que, após realizar uma transação, o contato seja redirecionado automaticamente para a página de Confirmação de compra do eCommerce.
Se não for possível executar o hook displayTop por incompatibilidades com outros módulos, recomenda-se executar o hook displayConnectifTags em todas as páginas e garantir que o módulo está ancorado corretamente a esse hook.
3. Não são sincronizados os estados de inscrição na newsletter
Verifique se as URLs preenchidas automaticamente na integração com PrestaShop da sua conta Connectif coincidem com as URLs do módulo instalado no seu PrestaShop em “Configuração > URLs públicas”
Confira se as URLs existem copiando e colando-as na barra de endereços do seu navegador. Se der erro 404, será necessário corrigir no próprio eCommerce.
4. Como recuperar carrinhos abandonados com a URL de Recuperação de Carrinho
(Nesta seção explica-se como funciona a URL de Recuperação de Carrinho para obter os itens associados a um carrinho específico).
Através da integração com PrestaShop, é enviada ao Connectif uma URL de Recuperação de Carrinho, ou seja, um link para recuperar os artigos relacionados a esse carrinho que pode ser usado em workflows e conteúdos.
Para obter a URL de recuperação de carrinho via workflow, deve-se usar o nó "Obter último carrinho" e "Ao abandonar carrinho", depois, mapear nas variáveis do conteúdo a ser exibido ou enviado.
- Aprenda como funciona essa URL nos diferentes CMS e como usá-la neste artigo.
Continue aprendendo!
Para aproveitar todo o potencial da sua conta Connectif, recomendamos continuar com os seguintes artigos:
Onboarding, para adquirir habilidade com nossa interface.
Workflows iniciais, para implementar suas primeiras estratégias na conta.
Integrações com sistemas externos, para integrar com Facebook, formulários e webhooks do seu site.
Integrações via API, para administrar eventos como registros de compras ou inscrições de contatos.
Eventos que consomem Atividades, para compreender melhor o consumo da sua conta.