Como funciona
O Alva Digital Downloads não tem conexão direta com o Google. Suas exportações em CSV cobrem o histórico, e um fluxo do Shopify Flow que você monta adiciona uma linha para cada novo download ou entrega. Um CSV é um retrato do momento, então exporte de novo para ter números atualizados.
Abra uma exportação no Google Sheets
1. Exporte o CSV
No admin do Alva, clique em uma exportação no topo da página. As datas aparecem como dd-MM-yyyy HH:mm no fuso horário da sua loja.
- Pedidos → Exportar Pedidos: uma linha por compra, com cliente, produto, status de acesso e chaves de licença.
- Pedidos → Exportar atividade de download: uma linha por visita à página de download ou clique em botão. Na caixa de diálogo, os dias opcionais De e Até, no fuso horário da sua loja, limitam o período; clique em Exportar.
- Produtos → Exportar catálogo: uma linha por arquivo, pacote, link ou pool de chaves de licença em cada produto.
Página Pedidos do Alva com a caixa de diálogo Exportar atividade de download aberta: campos de data De e Até preenchidos com datas de exemplo e o botão Exportar. Mantenha o cabeçalho da página com Exportar Pedidos e Exportar atividade de download visível atrás dela. Sem dados reais de cliente visíveis.
2. Importe no Google Sheets
Escolha Arquivo → Importar → Fazer upload e selecione o CSV. Defina Local de importação como Substituir planilha, ou Inserir nova(s) página(s) para manter suas outras abas, e Tipo de separador como Vírgula. Clique em Importar dados. Abrir o CSV pelo Google Drive também funciona.
Caixa de diálogo Importar arquivo do Google Sheets depois de escolher um CSV do Alva: Local de importação definido como Substituir planilha, Tipo de separador definido como Vírgula. Apenas nome de arquivo de exemplo.
3. Confira as datas
Se dia e mês parecerem trocados, ou as datas continuarem como texto, escolha uma localidade que escreve o dia primeiro, como Brasil, em Arquivo → Configurações e importe de novo.
O que a exportação de atividade de download contém
Colunas: Date, Event, Customer Email, Customer Name, Order Number, IP Address, User Agent e Source. Event é Download page opened (uma visita à página de download) ou File downloaded (um clique em um botão de arquivo ou de ZIP na página de agradecimento, na página de status do pedido, na conta do cliente ou na página de download). Linhas mais antigas também podem trazer Admin download: você baixando seu próprio arquivo pelo admin do Alva, o que o Alva não registra mais.
Uma linha é uma visita ou um clique, não uma contagem de downloads: não some as linhas para contar downloads.
O que a exportação do catálogo contém
Uma linha por item de entrega em cada produto. Um produto personalizado (feito sob encomenda) recebe uma linha personalized mais uma linha para cada link anexado a ele; seus pools de chaves de licença não são listados, porque compras personalizadas não recebem chaves. Um produto sem nada anexado recebe uma linha. As URLs dos links nunca são exportadas.
- Product title, Variant titles, Shopify product ID, Shopify variant IDs e Mapping active. Os títulos dos produtos vêm do Shopify; se o Shopify estiver ocupado ou o produto tiver sido excluído, a exportação usa o último título que o Alva viu, ou Unknown product.
- Item type, Item name, File size (bytes) (um pacote mostra o total dos seus arquivos) e Content type.
- Buyers with access: clientes distintos cujo acesso está ativo, incluindo pedidos ainda em revisão antifraude.
- Product downloads: cliques nos botões de download do produto, repetidos em cada uma das suas linhas, não por arquivo. Redefinir os limites de download de um cliente reduz esse número, e downloads feitos na página de agradecimento antes de o pedido terminar de sincronizar não são incluídos.
Variant titles lista as variantes para as quais um item é entregue, ou informa:
- All variants: todas as variantes do produto.
- All other variants: todas as variantes que outro mapeamento do mesmo produto não lista.
- No variants (another mapping takes priority): este mapeamento não entrega a nenhuma variante, porque outro mapeamento do produto prevalece.
- Conflict (more than one mapping covers the same variants): dois ou mais mapeamentos empatam nas mesmas variantes.
- Azul (conflict): outro mapeamento do produto também reivindica essa variante, e a célula então começa com o rótulo Conflict.
- All other variants; plus: Verde: o rótulo e, depois, as variantes que este mapeamento também lista. As partes são separadas por ponto e vírgula.
Adicione novas linhas automaticamente com o Shopify Flow
Monte o fluxo você mesmo no Shopify Flow: o trigger Arquivo digital baixado ou Compra digital entregue do Alva, seguido da ação Adicionar linha à planilha do Google Sheets. Colunas sugeridas para downloads: Data, Pedido, E-mail do cliente, Produto, Arquivo. Para entregas: Data, Pedido, E-mail do cliente, Produtos, Arquivos (número de arquivos).
Arquivo é o arquivo clicado, ou Multiple files para um ZIP ou botão de vários arquivos, ou Unknown file quando o produto não tem arquivos. Produtos mostra o nome de entrega do ZIP (ou um nome gerado), não o título do produto no Shopify, exceto para produtos só com chaves de licença, que mostram o título do produto.
1. Prepare a planilha
Crie a aba primeiro, com uma linha de cabeçalho para suas colunas, começando na coluna A.
2. Adicione o trigger e a ação
No Shopify Flow, clique em Criar fluxo. Escolha o trigger Arquivo digital baixado ou Compra digital entregue do Alva e, depois, adicione a ação Adicionar linha à planilha do Google Sheets.
3. Conecte o Google Sheets no Flow
Quando o Flow pedir, faça login na sua própria conta do Google e permita que ele edite planilhas. O Alva nunca vê essa conta.
4. Preencha a ação e ative
Cole a URL da planilha e digite o Nome da aba exatamente. Em Conteúdo da linha (separado por vírgulas), cole a linha do seu fluxo como uma única linha. Cada valor preenche uma coluna na ordem da sua linha de cabeçalho, e as vírgulas são removidas dos valores de texto para que não dividam uma coluna.
Fluxo de downloads (Data, Pedido, E-mail do cliente, Produto, Arquivo):
{{ "now" | date: "%Y-%m-%d %H:%M" }},{{ order.name | replace: ",", " " }},{{ order.email | replace: ",", " " }},{{ product.title | replace: ",", " " }},{{ fileName | replace: ",", " " }}
Fluxo de entregas (Data, Pedido, E-mail do cliente, Produtos, Arquivos):
{{ "now" | date: "%Y-%m-%d %H:%M" }},{{ order.name | replace: ",", " " }},{{ order.email | replace: ",", " " }},{{ productNames | replace: ",", ";" }},{{ totalFiles | round }}
E-mail do cliente usa order.email porque um pedido de visitante não tem cliente. Se um valor que começa com = aparecer como fórmula na sua planilha, adicione | prepend: "'" aos valores de texto, nunca a Data ou Arquivos. Clique em Ativar fluxo.
Editor do Shopify Flow: o trigger Arquivo digital baixado do Alva conectado à ação Adicionar linha à planilha do Google Sheets. Mostre os campos URL da planilha, Nome da aba e Conteúdo da linha preenchidos com valores de exemplo. Sem dados reais de cliente visíveis.
O que os seus clientes veem
Nada muda para os clientes, mas suas planilhas guardam dados pessoais deles: nomes, e-mails e, na exportação de atividade, endereços IP e navegadores. Compartilhe-as só com quem precisa delas.
Limitações
- Só daqui para frente. Sem retroativo: use os CSVs para qualquer coisa anterior à ativação do fluxo, ou do período em que ele esteve desativado.
- Só acrescenta. Um reembolso ou um acesso revogado não remove uma linha.
- Sem células iniciais em branco. O Sheets grava cada linha a partir da primeira coluna com conteúdo.
- Limites de taxa do Google. Cerca de 60 gravações por minuto por conta, então uma loja muito movimentada pode ver erros no histórico de execuções do Flow. Essas linhas podem faltar; os CSVs as têm.
- Reenvios adicionam linhas; algumas vendas não adicionam nenhuma. Um fluxo de entregas adiciona uma linha para cada e-mail de download enviado com sucesso, então reenviar um pela página do pedido, pela página de reenvio do cliente ou pelo Sidekick adiciona outra linha para esse pedido. Produtos personalizados (feitos sob encomenda) e pedidos cujo e-mail de download não é enviado (e-mails desativados ou falha no envio) não adicionam linha de entrega. Vendas presenciais no PDV sem conta de cliente não adicionam linha alguma.
Solução de problemas
| Sintoma | Causa provável | Correção |
|---|---|---|
| Exportar atividade de download diz “Nenhuma atividade de download para exportar” | Nenhuma visita ou clique cai entre os seus dias De e Até ou, sem datas definidas, ainda não há atividade. | Amplie o período, ou deixe as duas datas em branco para exportar toda a atividade. |
| O Flow mostra um 403 na etapa do Google Sheets | A conta do Google conectada no Flow não pode editar a planilha. | Dê acesso de edição a essa conta, ou reconecte-a e permita edições. |
| As linhas caem nas colunas erradas | Células iniciais em branco, ou uma vírgula dentro de um valor: cada vírgula inicia uma coluna. | Exclua as células em branco e adicione | replace: ",", " " aos valores de texto em Conteúdo da linha. |
| Os downloads do catálogo não batem com a exportação de atividade | As linhas de atividade são visitas e cliques; Product downloads conta cliques e diminui após uma redefinição. | Compare só com as linhas File downloaded. |
Perguntas frequentes
Não diretamente. O Alva não tem conexão própria com o Google. Use as exportações em CSV para o histórico e um fluxo do Shopify Flow que você mesmo monta para novos downloads e entregas.
Não. As três exportações e os triggers do Alva para o Flow funcionam em todos os planos do Alva Digital Downloads, inclusive o Gratuito.
Cada linha é uma visita à página de download ou um clique no botão de download, então um comprador pode gerar várias linhas. Filtre Event por File downloaded para contar cliques.
Não. Links e pools de chaves de licença aparecem só pelo nome. As chaves atribuídas a cada pedido estão na exportação de pedidos.
Veja também
Foi útil?
Última atualização 2026-10-29