Pular para o conteúdo principal
— Passo a passo conceitual

Entrega em ZIP vs. arquivos individuais

O Alva Digital Downloads entrega os arquivos de um mapeamento de produto de uma de duas maneiras: agrupados em um único arquivo ZIP, ou servidos como arquivos INDIVIDUAL separados. ZIP é o padrão e é ideal para produtos com vários arquivos; Individual é ideal para produtos de um único arquivo e recupera um download travado.

Os dois modos de entrega

O Alva Digital Downloads armazena um downloadType em cada mapeamento de produto, definido como ZIP ou INDIVIDUAL. ZIP agrupa todos os arquivos de um mapeamento em um único arquivo que o cliente baixa com um clique. INDIVIDUAL serve cada arquivo como seu próprio link de download.

Quando usar ZIP

Escolha ZIP - All files in a single ZIP archive para packs e produtos com vários arquivos — coleções de fontes, sample packs, módulos de curso, kits de marca. O cliente recebe um único arquivo organizado em vez de clicar em links separados, e o mesmo ZIP cacheado é reaproveitado em downloads repetidos. ZIP é o padrão para novos mapeamentos.

Quando usar Individual

Escolha Individual - Each file separately para produtos de um único arquivo. Embrulhar um único arquivo em um ZIP obriga o cliente a descompactá-lo sem nenhum benefício e adiciona uma etapa de construção de arquivo que pode falhar. A entrega individual serve o arquivo diretamente, sem ZIP para gerar ou cachear.

Como alternar o modo de entrega de um mapeamento

1. Abra o produto no Alva

No admin do Alva, abra o produto cujo mapeamento você quer alterar. A página de detalhes do produto mostra o mapeamento com suas configurações atuais.

2. Expanda o painel de configurações

Clique em Edit na linha de configurações para expandi-la. O painel mostra o status do mapeamento, o ZIP File Title e o controle Download Type.

3. Defina o Download Type

Use o seletor Download Type para escolher ZIP ou INDIVIDUAL, depois salve. O controle fica oculto em produtos personalizados, que sempre entregam arquivos por pedido pelo fluxo personalizado.

Resolvendo um download com 'Nenhum arquivo disponível'

Um mapeamento definido como ZIP cujo arquivo nunca foi gerado não tem chave de ZIP cacheada. O resolvedor de download e o bloco da página de agradecimento procuram esse ZIP, não encontram nada e mostram Nenhum arquivo disponível — mesmo que o arquivo subjacente esteja perfeito.

A solução rápida é alternar esse mapeamento para entrega Individual. Sem ZIP para resolver, o Alva serve os arquivos subjacentes diretamente e o download — junto com o bloco da página de agradecimento — volta a funcionar imediatamente.

  • Defina mapeamentos de um único arquivo como Individual — um ZIP de um arquivo só não acrescenta nada.
  • Se um mapeamento ZIP de vários arquivos mostrar Nenhum arquivo disponível, mude-o para Individual para restaurar a entrega enquanto o ZIP é reconstruído.
  • Um fallback automático e gracioso para arquivos individuais é a solução adequada de longo prazo e está no roadmap.

O spinner de geração de ZIP travado é um bug de exibição

Se o spinner de geração de ZIP parecer nunca terminar, o ZIP quase sempre já foi construído. Esse é um bug conhecido de sincronização de estado na tela, não uma falha de entrega nem uma configuração que você controla. Recarregue a página para limpar o spinner travado — nunca mude o modo de entrega para "consertar" isso.

Perguntas frequentes

Onde fica o seletor de modo de entrega?

Abra o produto no admin do Alva, expanda o painel de configurações no mapeamento e use o seletor Download Type. Ele oferece ZIP - All files in a single ZIP archive ou Individual - Each file separately. O seletor fica oculto em produtos personalizados.

Um produto de um único arquivo deve usar ZIP ou Individual?

Use Individual. Um ZIP de um arquivo só embrulha um único arquivo em um arquivo compactado que o cliente precisa descompactar sem nenhum benefício, e adiciona uma etapa de geração de ZIP que pode falhar. A entrega individual serve o arquivo diretamente.

Por que o link do e-mail diz 'Nenhum arquivo disponível'?

Um mapeamento definido como entrega ZIP cujo arquivo nunca foi gerado não tem chave de ZIP cacheada, então o resolvedor de download não encontra nada para servir. Mude esse mapeamento para entrega Individual e os arquivos subjacentes são entregues imediatamente.

O spinner de geração de ZIP nunca para — o download está quebrado?

Quase nunca. O spinner travado é um bug de exibição conhecido, não uma falha de entrega. O ZIP geralmente já terminou de ser construído em segundo plano. Recarregue a página para limpar o spinner travado — não mude nenhuma configuração para consertar.

Mudar para Individual altera como os downloads contam contra os limites?

Sim. Um ZIP conta como um download mesmo contendo vários arquivos. Com a entrega Individual, cada arquivo é seu próprio download, então um produto com vários arquivos consome mais de um limite de download por cliente.

Veja também

Foi útil?

Ainda travado? Escreva para nós.

Última atualização 2026-06-01