Conectar a sua loja

Uma loja envia dois tipos de dados ao Emailit: o catálogo e os pedidos, a partir do backend, com a API, e o que os visitantes fazem no site, com o script de rastreamento do rastreamento de eventos. Use os dois para ter o quadro completo: a API é o registro confiável dos pedidos, e o script acrescenta as visualizações de produtos, os carrinhos e os visitantes que chegam pelos seus e-mails.

Antes de começar

• Uma chave de API para as chamadas do backend. Uma chave Events Only pode enviar produtos, pedidos e carrinhos: é a mesma chave que envia eventos do seu backend. Ela não consegue ler nada de volta, então as respostas dela trazem apenas object, id e external_id. Use uma chave Full Access para também ler dados, gerenciar cupons ou alterar configurações.
• Para o script de rastreamento, permissão para adicionar um script às páginas da sua loja.

Enviar dados do seu backend

Produtos

Envie o seu catálogo com Criar ou atualizar produtos em massa, e de novo sempre que os produtos mudarem. Cada produto é identificado pelo ID do produto na sua loja, então enviá-lo de novo o atualiza.

curl https://api.emailit.com/v2/products/batch \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "products": [{
      "id": "1234",
      "title": "Trail Runner GTX",
      "url": "https://shop.example.com/products/trail-runner",
      "image_url": "https://shop.example.com/images/trail-runner.jpg",
      "price": 139,
      "compare_at_price": 169,
      "currency": "EUR",
      "categories": ["Shoes", "Running"],
      "inventory_quantity": 40
    }]
  }'

Os feeds de produtos nos e-mails deixam de fora os produtos arquivados e os produtos com estoque 0, então mantenha status e inventory_quantity atualizados.

Pedidos

Quando um pedido é feito, envie-o com Criar ou atualizar um pedido:

curl https://api.emailit.com/v2/orders \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "1001",
    "email": "jane@example.com",
    "currency": "EUR",
    "total": 125,
    "shipping": 5,
    "coupon_codes": ["WLC-8K2M4P"],
    "cart_id": "cart_789",
    "items": [{ "product_id": "1234", "title": "Trail Runner GTX", "quantity": 1, "price": 120 }]
  }'

• id é o número do pedido na sua loja. Enviar o mesmo id de novo atualiza o pedido em vez de adicionar outro.
• O Emailit atribui o pedido ao e-mail em que o comprador clicou ou que ele abriu por último. Consulte Como os pedidos são atribuídos.
• O comprador vira um contato se ainda não for um. Adicione "accepts_marketing": true e um audience_id para também inscrevê-lo, por exemplo quando ele marcou uma caixa de newsletter no checkout. "create_contact": false faz o Emailit não criar o contato. O comando purchase do script de rastreamento nunca cria nem inscreve um contato.
• cart_id marca esse carrinho como convertido.

Quando o pedido for pago, processado, cancelado ou reembolsado, envie a mudança com Atualizar um pedido ou envie o pedido de novo com o novo status. Os pedidos cancelados não contam para a receita, e os reembolsos são subtraídos.

Pedidos anteriores

Importe o seu histórico de pedidos com Importar pedidos em massa, até 1.000 pedidos por requisição. As importações são históricas por padrão: elas preenchem o histórico de compras, as métricas e as recomendações, mas não são atribuídas a e-mails e não iniciam automações.

O script de rastreamento

O script de rastreamento registra o que os visitantes fazem no seu site: visualizações de produtos, o carrinho, compras e visitas. Ele também reconhece os visitantes que chegam pelos seus e-mails, para que a atividade deles fique ligada ao contato deles.

Adicionar o script

1. Crie uma chave de rastreamento. Em Email API›Events, abra a aba Tracking e selecione Create tracking key. Em Allowed origins, liste os domínios da sua loja, por exemplo shop.example.com ou *.example.com. Deixe vazio para aceitar qualquer site.

2. Adicione o trecho de código a todas as páginas, antes de </head>. A aba Tracking mostra o trecho com a sua chave preenchida:

   HTML

   <script>window.emailit=window.emailit||function(){(window._emailitq=window._emailitq||[]).push(arguments)};</script>
   <script async src="https://js.emailit.com/track/TRACKING_KEY/events.js"></script>

   As chaves de rastreamento são públicas: elas só podem enviar eventos, nunca ler dados. Se o script dos formulários do Emailit já estiver na página, mantenha os dois.

Para registrar também uma visualização de página em todas as páginas, adicione data-autotrack="pages" à tag do script. As visualizações de página atualizam a última atividade do contato no seu site e o fuso horário dele; elas não são armazenadas como eventos.

Registrar a atividade da loja

Chame estes comandos onde as ações acontecem:

// Product page
emailit("product", { id: "1234", title: "Trail Runner GTX", url: location.href,
  image_url: "https://shop.example.com/images/trail-runner.jpg", price: 139, currency: "EUR",
  categories: ["Shoes", "Running"] });

// Every time the cart changes
emailit("cart", { id: "cart_789", currency: "EUR", checkout_url: "https://shop.example.com/checkout",
  items: [{ product_id: "1234", title: "Trail Runner GTX", quantity: 1, price: 139 }] });

// Order confirmation page
emailit("purchase", { id: "1001", total: 125, currency: "EUR",
  items: [{ product_id: "1234", quantity: 1, price: 120 }], coupon_codes: ["WLC-8K2M4P"] });

Identificar visitantes

A atividade passa a contar para um contato quando o script sabe quem é o visitante:

• Por um link de e-mail. Quando um contato clica em um link de um e-mail de campanha ou de automação que leva ao seu site, o link leva um parâmetro _eit assinado. O script o armazena e o remove da barra de endereço. Os links recebem esse parâmetro quando o rastreamento de cliques está ativado e o link vai para uma origem permitida de uma chave de rastreamento ou, no caso de chaves sem origens permitidas, para o seu domínio de envio.

• Quando o visitante entrar ou fizer o checkout, chame identify com o endereço de e-mail ou o ID de contato dele:

  JavaScript

  emailit("identify", { email: "jane@example.com" });

• Quando ele sair da conta, chame emailit("reset") para esquecê-lo nesse navegador.

As visualizações de produtos e os carrinhos de antes da identificação do visitante são movidos para o contato. O script também registra o fuso horário do navegador, que o envio no horário local do destinatário usa, e quando o contato esteve ativo pela última vez no seu site.

emailit("debug", true) registra no console do navegador o que o script envia.

Onde a atividade aparece

A atividade da loja vai para o mesmo log de eventos que os seus outros eventos. As visualizações de produtos viram eventos product.viewed, os carrinhos novos ou alterados, cart.updated, e as compras, order.placed. Você os vê em Email API›Events e na atividade do contato, e os webhooks podem ser inscritos neles. product.viewed e cart.updated não fazem parte de All events, então inscreva o webhook neles pelo nome. Consulte Eventos de e-commerce.

Confirmar que funcionou

• Email Marketing›Commerce mostra os seus produtos e pedidos, e Carts mostra os carrinhos vindos do script.
• Email API›Events lista os eventos product.viewed, cart.updated e order.placed conforme os visitantes navegam e compram.
• Abra um contato que fez um pedido: o card Purchases mostra os pedidos, o total gasto e os produtos vistos recentemente.
• Depois de uma campanha, os pedidos atribuídos a ela aparecem na aba Revenue da campanha.

Veja também