# E-commerce

> Envie os produtos, os pedidos e os carrinhos da sua loja para o Emailit para ver a receita que os seus e-mails geram, personalizar o conteúdo com produtos e cupons e alcançar compradores e carrinhos abandonados. Alfa: aberto apenas à equipe do Emailit.

O e-commerce conecta a sua loja virtual ao Emailit. Com os seus produtos, pedidos e carrinhos no Emailit, você pode ver quanta receita cada campanha e cada automação geram, colocar produtos, códigos de cupom e carrinhos nos e-mails, segmentar contatos pelo que eles compram e iniciar automações quando alguém faz um pedido ou abandona um carrinho.

> **O e-commerce está em alfa:** O e-commerce está aberto apenas à equipe do Emailit enquanto o testamos. Consulte [Quem pode usar o e-commerce](#who-can-use-commerce).

## Quem pode usar o e-commerce

Durante a fase alfa, o e-commerce está disponível apenas para os administradores da plataforma Emailit. O papel Admin de um workspace não é suficiente.

| Onde | Equipe do Emailit | Todos os outros |
| --- | --- | --- |
| Painel | **Email Marketing → Commerce**, a receita nos relatórios de campanha, os testes A/B vencidos por pedidos ou receita, o seletor **Products & coupons**, os gatilhos de compra nas automações, os eventos de e-commerce nos webhooks e o card **Purchases** nos contatos | **Commerce** no menu mostra **Soon** e não pode ser aberto. O resto fica oculto, mas uma campanha ou automação que já usa um recurso de e-commerce continua mostrando-o. |
| API e MCP | As APIs de produtos, pedidos, carrinhos, cupons e e-commerce, a receita nas [estatísticas de campanha](/pt/docs/api-reference/campaigns/stats/) e as ferramentas de e-commerce do MCP | `403` com `error: "commerce_alpha"`. As estatísticas de campanha deixam de fora `commerce`. |
| Chaves de API e o script de rastreamento | Funcionam em workspaces que pertencem a um administrador da plataforma Emailit. | `403` com `error: "commerce_alpha"`. Os comandos `product`, `cart` e `purchase` do script de rastreamento são rejeitados com a mesma mensagem, e as visualizações de página são ignoradas. |

As campanhas e automações que já usam um recurso de e-commerce continuam funcionando para todos no workspace.

## O que você pode fazer

| Recurso | Onde |
| --- | --- |
| Receita gerada pelos e-mails, principais produtos e principais campanhas | **Email Marketing → Commerce** |
| Receita, pedidos e taxa de conversão por campanha, e testes A/B vencidos pela receita | [Relatórios de campanha](/pt/docs/campaigns/reports/), [Testes A/B](/pt/docs/campaigns/ab-testing/) |
| Grades de produtos, recomendações, códigos de cupom únicos e o carrinho nos e-mails | [Produtos, cupons e o carrinho](/pt/docs/campaigns/products-and-coupons/) |
| Segmentos por pedidos, gastos, risco de churn, produtos comprados ou vistos, carrinhos e cupons | [Segmentos](/pt/docs/api-reference/segments/create/#activity-rules) (também em alfa) |
| Automações para carrinhos abandonados e novos pedidos | [Gatilhos de automação](/pt/docs/automations/triggers/) |
| Tirar quem comprou de uma sequência ou criar ramificações conforme o que a pessoa comprou | [Condições de saída e metas](/pt/docs/automations/exits-and-goals/), [Condition (If/Else)](/pt/docs/automations/steps/#condition-ifelse) |
| Um perfil de compras em cada contato | A página do contato no painel |

## Enviar os dados da sua loja

| Dados | Como chegam ao Emailit |
| --- | --- |
| **Produtos** | A [API de produtos](/pt/docs/api-reference/products/), ou as visualizações de produtos do script de rastreamento, que adicionam os produtos que ainda não estão no seu catálogo. |
| **Pedidos** | A [API de pedidos](/pt/docs/api-reference/orders/create/), a partir do backend da sua loja, com uma chave de acesso total ou uma chave **Events Only**. O comando de compra do script de rastreamento também funciona, mas os navegadores podem bloqueá-lo. |
| **Carrinhos** | O script de rastreamento, a cada mudança no carrinho, ou a [API de carrinhos](/pt/docs/api-reference/carts/upsert/). |
| **Visualizações de produtos e atividade no site** | O [script de rastreamento](/pt/docs/events/tracking-script/) do [rastreamento de eventos](/pt/docs/events/). |

[Conectar a sua loja](/pt/docs/commerce/connect-your-shop/) trata da API e do script de rastreamento.

Um pedido com um endereço de e-mail que ainda não é um contato cria o contato. O contato não é inscrito em nenhuma lista de contatos, a menos que o pedido indique que o comprador aceita marketing, então as campanhas não alcançam compradores que não deram opt-in.

## Como os pedidos são atribuídos aos e-mails

Cada novo pedido é atribuído ao e-mail de campanha ou de automação em que o comprador **clicou** por último dentro da janela de cliques antes do pedido (5 dias por padrão). Sem um clique, ele é atribuído ao e-mail que o comprador **abriu** por último dentro da janela de aberturas (1 dia por padrão). Os cliques têm prioridade sobre as aberturas porque alguns apps de e-mail carregam as imagens, e assim contam uma abertura, sem que ninguém leia o e-mail.

- A janela conta a partir do clique ou da abertura, e não do envio do e-mail: quem clica em uma campanha de uma semana atrás e compra no dia seguinte conta.
- Os visitantes que chegam por um link de e-mail levam uma identidade assinada, então a compra é atribuída mesmo quando é feita em outra sessão do navegador, desde que o clique esteja dentro da janela.
- Os pedidos importados com [`historical`](/pt/docs/api-reference/orders/batch/) não são atribuídos a e-mails e não iniciam automações.
- A receita é o total do pedido menos os reembolsos. Os pedidos cancelados não contam.

Cada pedido atribuído mostra **Credited to** com a campanha ou a automação e se ele veio de um clique ou de uma abertura.

## Configurações

**Email Marketing → Commerce → Settings** tem:

| Configuração | Padrão | Valores permitidos |
| --- | --- | --- |
| **Currency** | USD | Um código de moeda de três letras, usado nos pedidos e nos carrinhos que não indicam uma moeda. |
| **Click window (days)** | 5 | De 1 a 30. |
| **Open window (days)** | 1 | De 0 a 30. Com 0, só os cliques são atribuídos. |
| **Cart abandoned after (minutes)** | 60 | De 15 a 10.080. O carrinho de um contato conhecido que fica sem mudanças por esse tempo passa a ser abandonado. |

A página de configurações também tem os trechos de código do script de rastreamento e um exemplo de requisição de pedido. Na API, use [Obter as configurações de e-commerce](/pt/docs/api-reference/commerce/get-settings/) e [Atualizar as configurações de e-commerce](/pt/docs/api-reference/commerce/update-settings/).

## As páginas de e-commerce

- **Overview** mostra, para os últimos 7, 30 ou 90 dias: **Revenue**, **Revenue from email** (dividida entre campanhas e automações), **Orders** com o valor médio do pedido, **Customers** (novos e recorrentes), a receita por dia, os carrinhos (ativos, abandonados, valor abandonado e recuperados), **Top products** e **Top campaigns by revenue**. Os valores são separados por moeda, e a moeda principal aparece primeiro.
- **Products**, **Orders**, **Carts** e **Coupons** listam o que o Emailit tem, com pesquisa e filtros. Selecione um pedido para ver os itens dele e o e-mail ao qual ele é atribuído.
- **Settings**: veja acima.

### Carrinhos abandonados

Um carrinho passa para **Abandoned** quando pertence a um contato conhecido, tem itens e não muda durante o intervalo de abandono. O Emailit então emite [`cart.abandoned`](/pt/docs/webhooks/events/cart/abandoned/), que pode iniciar uma [automação de carrinho abandonado](/pt/docs/automations/recipes/#abandoned-cart-reminder). Um carrinho passa para **Converted** quando um pedido o indica com `cart_id` ou quando o mesmo contato faz um pedido.

### Perfil de compras

Um contato com pedidos, carrinhos ou atividade no site tem um card **Purchases** na página dele: pedidos, total gasto, pedido médio, último pedido, próximo pedido previsto, última atividade no seu site, fuso horário, **Churn risk**, o carrinho aberto, os produtos vistos recentemente e os pedidos recentes.

**Expected next order** é o último pedido mais o tempo médio do contato entre pedidos, a partir do segundo pedido. **Churn risk** compara o tempo desde o último pedido com esse intervalo (no mínimo 14 dias), ou com 90 dias para quem comprou uma única vez: **low** dentro dele, **medium** até o dobro, **high** depois disso.

## Eventos

O e-commerce registra o que acontece na sua loja como eventos do sistema, no mesmo lugar que todos os outros eventos. Eles aparecem em **Email API → Events** (escopo **System**), na atividade do contato, na [API de eventos](/pt/docs/api-reference/events/list/), nos [webhooks](/pt/docs/webhooks/) e nas automações:

| Evento | Quando |
| --- | --- |
| [`order.placed`](/pt/docs/webhooks/events/order/placed/) | Um pedido é armazenado pela primeira vez, exceto nas importações históricas. Inicia as automações **Placed an order** e encerra as execuções que têm essa condição de saída. |
| [`order.updated`](/pt/docs/webhooks/events/order/updated/) | Um pedido armazenado muda, por exemplo o status ou um reembolso. |
| [`cart.updated`](/pt/docs/webhooks/events/cart/updated/) | Um carrinho é criado, ou os itens, o total, o status ou o contato dele mudam. Enviar o mesmo carrinho de novo não o dispara. |
| [`cart.abandoned`](/pt/docs/webhooks/events/cart/abandoned/) | Um carrinho é abandonado. Um carrinho que muda e fica parado de novo o dispara outra vez. Inicia as automações **Abandoned a cart**. |
| [`product.viewed`](/pt/docs/webhooks/events/product/viewed/) | O script de rastreamento registra uma visualização de produto, de um contato ou de um visitante anônimo. |

`cart.updated` e `product.viewed` vêm do tráfego do site, então um webhook que recebe **All events** não os recebe. Inscreva o webhook neles pelo nome, assim como nos [eventos do workspace e personalizados](/pt/docs/webhooks/event-types/#workspace-and-custom-events). Os eventos de e-commerce também atualizam, em cerca de um minuto, os [segmentos rastreados](/pt/docs/segments/tracked/) com regras de compra, de carrinho ou de visualização de produto.

## Próximos passos

  - [Conectar a sua loja](/pt/docs/commerce/connect-your-shop/): Envie pedidos do seu backend e adicione o script de rastreamento.
  - [Produtos, cupons e o carrinho](/pt/docs/campaigns/products-and-coupons/): Personalize os e-mails com o seu catálogo.
  - [Cupons](/pt/docs/commerce/coupons/): Códigos únicos para cada destinatário.
  - [Receitas de automação](/pt/docs/automations/recipes/): Fluxos de carrinho abandonado e de agradecimento.

---
Fonte: https://emailit.com/pt/docs/commerce/