Resgatar recompensas

Se você ofereceu recompensas reais, a entrega é gerenciada na página Recompensas reais. Aqui você verifica o código de confirmação de um convidado, entrega a recompensa e registra a entrega. Seus convidados podem retirar (solicitar) uma recompensa no app – confirmar e entregar, só você ou a sua equipe no ponto de entrega.

Tudo aqui é opcional

As recompensas reais são um extra opcional. Você não precisa usar nada disso – seu evento funciona igualmente bem sem elas. Esta página só é necessária se você quiser vincular um prêmio de verdade (um brinde, um vale-presente ou algo parecido) a uma conquista desbloqueada. Ela serve apenas para gerenciar a entrega das suas recompensas.

Celular

Computador

A página Recompensas reais. ① A trilha de navegação Conquistas › Recompensas reais – o primeiro item leva de volta à aba de conquistas. ② O cabeçalho da página com a descrição curta. ③ O cartão fixo Como funciona. ④ A primeira etapa dele, O convidado ganha; as outras três ficam ao lado, no celular embaixo.

Como funciona o processo

Bem no topo da página, um cartão fixo Como funciona explica todo o caminho de uma recompensa real em quatro etapas:

1. O convidado ganha – o convidado cumpre desafios e desbloqueia uma conquista com recompensa real.

2. Código gerado – um código de confirmação de 6 dígitos exclusivo é criado e exibido para o convidado no app.

3. Você verifica – no seu ponto de entrega, você digita o código para conferir a autenticidade e os dados do usuário.

4. Entregar o prêmio – você confirma e entrega a recompensa física. O status é atualizado automaticamente.

O código é um número

O código de confirmação é um código numérico de 6 dígitos, exibido no formato XXX-XXX. Os marcadores representam dígitos, não letras – um exemplo seria 123-456. Na digitação, só a sequência de números importa; tanto faz digitar com ou sem hífen.

Como chego à página?

Desde a reformulação da administração, Recompensas reais fica na barra lateral – como subitem de Desafios e pontos.

1. Pela barra lateral (recomendado): no grupo Galeria, clique em Desafios e pontos. O item se expande e mostra, abaixo das suas três abas, as duas páginas seguintes Recompensas reais e Vencedores. Escolha Recompensas reais. Se você tiver acesso à página, abaixo dela também se expandem os seus quatro subitens: Todas as recompensas, Estatísticas, Estoque, Verificar código.

   

   “Recompensas reais” e “Vencedores” ficam como páginas seguintes de “Desafios e pontos”. ① Desafios e pontos na barra lateral. Assim que você está nessa área, abaixo dele se expandem as três abas Desafios, Conquistas e Configuração de pontos, além das páginas seguintes Recompensas reais e Vencedores. ② As mesmas três abas no topo da página. Elas sempre aparecem; se o seu plano não incluir um dos recursos, a aba mostra um aviso sobre o plano no lugar da lista. ③ Criar conquista – o botão pertence à aba Conquistas; na aba Desafios, ele se chama Criar desafio.

2. Pela lista de conquistas: abra Desafios e pontos ▸ Conquistas. Assim que pelo menos uma conquista tiver uma recompensa real, aparece o cartão informativo “Recompensas reais detectadas!” com o link Recompensas reais – um clique leva você direto para cá.

3. Pelo link direto ou pela trilha de navegação: no topo, a página mostra a trilha Conquistas › Recompensas reais. O primeiro item leva de volta à aba de conquistas. Caminho direto na área de administração: /admin/gallery/achievement-tracking.

4. Pela busca global: use a busca no topo da área de administração e digite, por exemplo, “recompensas”, “conquistas” ou “tracking” – o resultado Recompensas reais leva você na hora para esta página.

Nota

Se o seu plano não incluir conquistas, o item fica oculto em eventos de marca; se mesmo assim você abrir o endereço, verá uma página de bloqueio com a mesma trilha de navegação, em vez de uma tabela vazia.

Favorito para o ponto de entrega

No ponto de entrega, salve nos favoritos um link direto para a aba de verificação: /admin/gallery/achievement-tracking?tab=verify. Assim, ao abrir a página, a sua equipe cai direto na verificação de código.

As quatro abas

A página tem quatro abas. Cada uma tem um link direto pelo parâmetro ?tab=…, para você abri-la diretamente ou salvá-la nos favoritos. Em telas estreitas, você vê só os ícones das abas.

Celular

Computador

As quatro abas em ordem fixa: ① Todas as recompensas (`?tab=list`), ② Estatísticas (`?tab=stats`), ③ Estoque (`?tab=inventory`), ④ Verificar código (`?tab=verify`). No celular, elas mostram só o ícone – a ordem continua a mesma.

• Todas as recompensas (?tab=list) – a lista completa, filtrável e exportável, de todas as recompensas resgatáveis. É a aba padrão ao abrir a página.
• Estatísticas (?tab=stats) – cartões de totais e um detalhamento por conquista.
• Estoque (?tab=inventory) – o estoque de cada recompensa, com a quantidade restante.
• Verificar código (?tab=verify) – o caminho rápido para entregar uma recompensa diretamente ao convidado.

Aba “Todas as recompensas”

Esta aba lista cada recompensa real obtida por um convidado. É ideal para manter a visão geral, filtrar de forma direcionada, gerenciar casos individuais e exportar a lista de distribuição.

Celular

Computador

A aba Todas as recompensas. ① A busca por texto livre – ela procura na conquista, no e-mail, no apelido e no código. ② O menu suspenso Conquista – o único filtro que também vale na exportação CSV. ③ Exportar CSV. ④ Uma linha de dados: um clique nela abre o diálogo Gerenciar recompensa real.

Barra de filtros

Acima da tabela, sob o título Filtros, você encontra quatro campos:

• Pesquisar… – texto livre. Procura no nome da conquista, no e-mail, no apelido e no código de confirmação (com ou sem hífen).
• Conquista – menu suspenso com Todas as conquistas e cada conquista com recompensa real. Assim você oculta tudo, menos uma conquista específica.
• Status de retirada – Todos os status / Retiradas / Não retiradas.
• Status de confirmação – Todos os status / Confirmadas / Não confirmadas.

Assim que um filtro ou uma busca está ativo, aparece o botão vermelho Limpar tudo, que redefine todos os filtros, a busca e o número da página.

Tabela e exportação

Acima da tabela, à esquerda, aparece a indicação “Mostrando 1-50 de … recompensas” e, à direita, o botão Exportar CSV. A tabela mostra em cada linha:

• Usuário – o apelido do convidado; se ele não tiver definido um, aparece “Nenhum apelido definido”.
• Conquista – o nome da conquista.
• Código – o código de confirmação de 6 dígitos no formato XXX-XXX.
• Ganha em – a data em que a conquista foi obtida.
• Status – dois chips: o status de retirada (Retirada em azul / Não retirada em cinza) e o status de confirmação (Confirmada em verde / Não confirmada em amarelo).

A lista é paginada com 50 itens por página. Se não houver resultados, aparece “Nenhuma recompensa encontrada”.

A exportação não inclui o texto da busca

A exportação CSV aplica os filtros de conquista, de status de retirada e de status de confirmação – o texto da busca livre só vale na exibição e não entra na exportação. Se quiser exportar algo específico, filtre primeiro pelo menu suspenso de conquistas em vez de usar a busca. O nome do arquivo começa com received_achievements_.

Gerenciar um caso individual

Um clique em uma linha abre o diálogo Gerenciar recompensa real – aqui você gerencia exatamente essa recompensa. O diálogo mostra:

Celular

Computador

O diálogo Gerenciar recompensa real. ① O código de confirmação de 6 dígitos. ② Retirada em – essa data só aparece se o convidado tiver solicitado a recompensa no app. ③ O Status atual como dois chips. ④ Os dois botões: Cancelar retirada (vermelho) e Confirmar e entregar (verde).

• o nome da Conquista e o Usuário (apelido ou “Nenhum apelido definido”);
• o Código de confirmação em destaque, no formato XXX-XXX;
• os campos de data Ganha em, Retirada em (se houver) e Confirmada em (se houver);
• o Status atual como chips.

Embaixo ficam – conforme o status – dois botões:

• Confirmar e entregar (verde) – aparece enquanto a recompensa ainda não foi confirmada. Marca a recompensa como entregue. É a alternativa à verificação de código quando você quer confirmar uma recompensa direto pela lista.
• Cancelar retirada (vermelho) – aparece assim que houve retirada ou confirmação. Desfaz a retirada e a confirmação. É o caminho certo para desfazer uma confirmação feita por engano.

Só dá para desfazer aqui

Na aba Verificar código, não há como desfazer. Para reverter uma confirmação, abra a linha em Todas as recompensas e toque em Cancelar retirada.

Aba “Estatísticas”

A aba de estatísticas mostra rapidamente como estão as suas recompensas reais.

Celular

Computador

A aba Estatísticas. ① Total ganho – quantas vezes conquistas com recompensa real foram obtidas. ② Não confirmadas – todas as ainda em aberto, incluindo as que nem foram retiradas. ③ O Detalhamento por conquista. ④ Cada linha é clicável e leva, já filtrada, para Todas as recompensas.

No topo ficam quatro cartões de totais. Eles contam exclusivamente conquistas que têm uma recompensa real vinculada (tipo physical, voucher ou custom) – conquistas só de pontos nunca aparecem aqui:

• Total ganho – quantas vezes, no total, conquistas com recompensa real foram obtidas.
• Total retirado – quantas delas os convidados solicitaram.
• Confirmadas – quantas você entregou e confirmou (verde).
• Não confirmadas – todas as demais recompensas conquistadas, ou seja, também as que ainda nem foram retiradas (amarelo).

Como os quatro cartões somam

Confirmadas + Não confirmadas = Total ganho – e não “Total retirado”. Na imagem acima: 4 conquistadas, 2 delas retiradas, 1 confirmada, 3 não confirmadas – ou seja, a retirada ainda em aberto mais as duas que ninguém solicitou ainda.

Abaixo vem o Detalhamento por conquista, com as colunas Conquista, Ganhas, Retiradas e Confirmadas. Cada linha é clicável: um clique leva automaticamente para a aba Todas as recompensas, já filtrada exatamente por essa conquista. O detalhamento só aparece quando alguma recompensa já foi obtida.

Perceba cedo quando repor

Fique de olho na aba de estatísticas durante o evento: quando o Total retirado se aproximar da quantidade em estoque, você fica sabendo a tempo de que precisa repor.

Aba “Estoque”

Sob o título Gerenciamento de estoque, você mantém o estoque de cada recompensa real. A aba mostra só conquistas que têm uma recompensa real vinculada.

Celular

Computador

A aba Estoque. ① O chip com o tipo de recompensa. ② Ganhas e Retiradas desta recompensa. ③ O ícone de lápis abre a edição da quantidade. ④ O segundo cartão mostra Restantes ∞ – é assim que aparece um estoque ilimitado.

Para cada recompensa, você vê um cartão com imagem (ou ícone de troféu), nome, um chip com o tipo de recompensa (physical, voucher ou custom) e os números Ganhas e Retiradas. À direita, em destaque, aparece o valor em Restantes – ou o símbolo de infinito, se o estoque for ilimitado.

1. Toque no ícone de lápis ao lado de uma recompensa para editar o estoque.

2. No campo Estoque, digite a quantidade total. A dica “Vazio = ilimitado” significa: se você deixar o campo vazio, o estoque é considerado ilimitado.

3. Salve com o visto verde ou descarte com o X.

Estoque = quantidade total

Em Estoque, informe a quantidade total, não a quantidade restante. O valor em Restantes desconta automaticamente as recompensas já retiradas (estoque menos retiradas, no mínimo 0). Para remover um limite definido por engano, esvazie o campo – internamente, isso salva “ilimitado”.

Se nenhuma conquista tiver uma recompensa real ainda, a aba mostra Nenhuma recompensa real encontrada, com a dica para criar em Conquistas e recompensas uma conquista com recompensa física, vale-presente ou personalizada.

Aba “Verificar código” – o fluxo principal

Este é o caminho mais rápido no ponto de entrega: digitar o código, conferir a pessoa, entregar, confirmar. O cartão tem o título Verificar código de confirmação.

Celular

Computador

A aba Verificar código antes da verificação. ① O campo Código de confirmação – a entrada é formatada como XXX-XXX enquanto você digita. ② Verificar, clicável só a partir do sexto dígito. ③ O cartão Como usar logo abaixo. ④ A segunda etapa dele descreve exatamente essa digitação.

1. O convidado mostra a você o código de confirmação de 6 dígitos que aparece no app (veja Resgatar recompensas reais).

2. Digite o código no campo Código de confirmação (marcador XXX-XXX). A entrada é formatada automaticamente enquanto você digita; o botão Verificar só fica ativo quando os 6 dígitos estiverem digitados. Toque em Verificar.

3. Se o código estiver correto, aparece o aviso “Código válido!”, junto com o pedido para conferir os detalhes. Abaixo, um cartão de detalhes mostra Conquista, Usuário (apelido e e-mail), Ganha em e, em Status, dois chips (Retirada pelo usuário ou Não retirada e Confirmada ou Não confirmada). Confira pelo apelido e pelo e-mail se a pessoa certa está na sua frente.

4. Agora entregue a recompensa.

5. Só depois da entrega, toque em Confirmar e entregar recompensa (verde). Aparece “Recompensa confirmada e marcada como entregue!” – a recompensa passa a constar como confirmada e entregue. A dica abaixo do botão diz o mesmo: primeiro entregar, depois clicar.

6. Toque em Redefinir para limpar o campo para o próximo convidado.

Se algo não estiver certo, a página mostra uma mensagem de erro: “O código deve ter 6 dígitos”, quando ainda não foram digitados 6 dígitos, ou “Código não encontrado. Confira os dígitos.”, quando o código é desconhecido. Se a recompensa já tiver sido entregue, aparece “Esta recompensa já foi confirmada e entregue.” Abaixo do campo de entrada, o cartão Como usar resume o processo em cinco etapas e avisa: os convidados podem retirar a recompensa no app por conta própria, mas só a sua equipe pode confirmar.

Sempre entregar primeiro, depois confirmar

Nunca confirme antes da entrega. A confirmação registra que a recompensa foi realmente entregue. Na aba Verificar código não há como desfazer – isso só é possível no diálogo da linha, em Todas as recompensas (Cancelar retirada).

Celular

Computador

Depois de Verificar. ① A mensagem Código válido!. ② O cartão de detalhes com Conquista, Usuário (apelido e e-mail) e Ganha em – aqui você confere se a pessoa certa está na sua frente. ③ Os dois chips de status. ④ Confirmar e entregar recompensa – toque só depois da entrega. O botão Redefinir substitui Verificar no topo assim que a verificação dá certo.

Exemplo

Uma convidada está no bar com o celular na mão e mostra a você o código 418-207.

Você abre a aba Verificar código, digita os seis dígitos no campo Código de confirmação – só com o sexto dígito o botão Verificar fica clicável – e toca nele. Aparece “Código válido!” e, abaixo, o cartão de detalhes: Conquista Caçadora de fotos, Usuário com apelido e e-mail, além dos chips de status Retirada pelo usuário e Não confirmada.

“Retirada”, neste ponto, só quer dizer que ela solicitou a recompensa no app – ela ainda não tem nada nas mãos. Você confere o apelido, entrega a taça a ela e só depois toca em Confirmar e entregar recompensa. Em seguida, Redefinir para o próximo convidado.

Se você tivesse confirmado cedo demais, nada nesta aba ajudaria – só dá para desfazer no diálogo da linha, em Todas as recompensas, com Cancelar retirada.

Retirada, confirmada, revogada

Três termos aparecem o tempo todo – veja como eles se relacionam:

• Retirada: o convidado solicita a recompensa no app. É só uma declaração de intenção, ainda não é a entrega.
• Confirmada: só você confirma, depois da entrega real. Isso registra que a recompensa foi entregue.
• Revogada: desfaz a retirada e a confirmação – pelo botão vermelho no diálogo da linha.

Não confunda

Retirada significa apenas “solicitada pelo convidado” – a recompensa ainda está com você. Só Confirmada significa que ela realmente está com o convidado. No diálogo da linha, você reconhece as duas situações pelos campos de data Retirada em e Confirmada em.

Esta página não é para os vencedores do ranking

Aqui você gerencia exclusivamente as recompensas de conquistas. Para o modo vencedores do ranking – em que, no final, as primeiras colocações são premiadas – existe uma página própria, com um verificador de código próprio. Ou seja, um código de vencedor não pode ser verificado aqui e também não aparece em nenhuma lista.

Tudo sobre colocações, congelamento da classificação e entrega de prêmios está em Vencedores do ranking.

Perguntas frequentes e solução de problemas

• “Código não encontrado. Confira os dígitos.” ou “Esta recompensa já foi confirmada e entregue.”: erro de digitação, evento errado ou o código já foi confirmado ou revogado. Busque o código em Todas as recompensas e confira o status. Se for um código de vencedor, ele pertence à página Vencedores do ranking.
• Convidado sem apelido: aparece “Nenhum apelido definido”. Confira a pessoa pelo endereço de e-mail nos detalhes da verificação.
• Confirmada por engano: abra a linha em Todas as recompensas e toque em Cancelar retirada.
• Estoque limitado por engano: esvaziar o campo Estoque = ilimitado de novo.
• “Nenhuma recompensa real encontrada” mesmo com conquistas cadastradas: a conquista não tem recompensa real. Corrija isso em Conquistas e recompensas.
• Exportação incompleta: o texto da busca livre não vale no CSV. Antes de exportar, filtre pelo menu suspenso de conquista ou de status.

Recurso Premium

As recompensas reais são um recurso Premium. Você as configura em Conquistas e recompensas; como os convidados solicitam a recompensa é mostrado em Resgatar recompensas reais. Os desafios e as conquistas em si são gerenciados em Criar desafios. Para ter acesso, você precisa da função Administrador ou Proprietário.