O nome, o e-mail, o telefone e as outras respostas que os jogadores escrevem no Formulário de registo são guardados juntamente com a partida e descarregam-se em Excel a partir do painel web da conta activationking.com. Este artigo descreve para onde vão os dados, quando chegam à nuvem, onde se descarrega o Excel, que colunas contém e o que acontece sem internet.
- No momento em que o jogador prime Estou pronto, as respostas são escritas no dispositivo; com internet, vão para a nuvem em segundos.
- Dentro da aplicação não há descarga de Excel nem de CSV. A exportação faz-se no painel web activationking.com.
- No painel web, Eventos → evento → Mais → Exportar contatos descarrega um ficheiro Excel. Cada jogador é uma linha à parte.
- No Excel estão os seus campos do formulário, o resultado, a duração da partida, a data e a hora do consentimento de privacidade (RGPD). As datas estão em UTC.
Para onde vão os dados
Respostas do formulário
Os dados a perguntar definem-se no separador Sessão → Pesquisa; os dois jogadores preenchem o mesmo formulário. Quando um jogador prime Estou pronto no seu cartão, as respostas desse jogador são escritas de imediato no dispositivo. Os dois jogadores ficam separados dentro do mesmo registo de partida; as respostas de um não são escritas por cima das do outro.
Cada resposta é guardada com o nome visível que deu ao campo. Se no separador Pesquisa escreveu O seu e-mail no campo, o cabeçalho da coluna no Excel também é O seu e-mail. Um campo deixado vazio não é guardado.
Para o jogador que prime Pular por agora não é escrita nenhuma resposta; esse jogador não aparece no Excel. Este botão só aparece quando o formulário não tem nenhum campo obrigatório. Quando se prime Cancelar, a partida é cancelada, mas as respostas do jogador que já tinha dito Estou pronto ficam no registo e vão para o Excel; as células do resultado e da duração ficam vazias.
Detalhes: artigo Como pedir o nome e o consentimento aos jogadores?.
Envio para a nuvem
Se o dispositivo estiver ligado à internet, o envio é acionado logo após cada registo; as respostas e o resultado da partida ficam na nuvem em segundos. O painel web só mostra os registos que chegaram à nuvem. O próprio evento também tem de ter ido à nuvem pelo menos uma vez; as partidas de um evento criado sem internet e nunca ligado não correspondem ao evento e não aparecem na exportação. Crie o evento com internet.
Se usar o mesmo evento em vários dispositivos, os jogadores de todos os dispositivos são reunidos num único Excel.
Consentimento de privacidade (RGPD)
Com Isenção de responsabilidade ligado, cada cartão de jogador tem uma caixa de consentimento e Estou pronto não funciona enquanto a caixa não for marcada. O momento em que a caixa é marcada é guardado e aparece no Excel na coluna Consent (UTC). A hora do consentimento é um único valor por partida: como os dois jogadores consentem, no registo fica o momento do último consentimento dado, ou seja, nas linhas dos dois jogadores aparece a mesma hora.
Quando o consentimento é dado, o texto em si não é guardado. Se alterar o texto do Isenção de responsabilidade durante o evento, não é possível deduzir do registo a que texto foi dado cada consentimento; anote você mesmo quando alterou o texto. Se Isenção de responsabilidade estiver desligado, o consentimento não é pedido e esta coluna fica vazia. Como a caixa de consentimento está dentro do formulário, com Pesquisa desligado o consentimento também não é pedido.
Há exportação dentro da aplicação?
Não. O único sítio da aplicação que mostra dados dos jogadores é o separador Sessão → Partidas; aí veem-se os nomes e os resultados e pode ocultar-se uma partida do ecrã do convidado, mas não se descarrega nenhum ficheiro. O Excel só se descarrega no painel web. Ocultar uma partida com Ocultar não a retira do Excel; os jogadores da partida oculta também constam do ficheiro. Detalhes: artigo Como gerir a lista de partidas?.
Descarregar o Excel no painel web
Passos
- Abra activationking.com no navegador e inicie sessão com a conta que usa na aplicação.
- Passe à página Eventos no menu lateral. A descrição da página é Eventos que você criou nos apps. Como os eventos de jogo não têm fotografias, o número de média no cartão aparece vazio; é normal.
- Clique no cartão do evento; abre-se a página do evento.
- Abra o menu Mais no canto superior direito e clique em Exportar contatos. O ficheiro Excel é descarregado. O nome do ficheiro começa por leads_ e inclui a identidade do evento e a data; a folha dentro do ficheiro chama-se Leads.
Se ainda nenhum jogador tiver chegado à nuvem, o ficheiro não é descarregado e na página aparece a nota Ainda não há dados de contatos capturados neste evento.; não é um erro. Se o ficheiro não puder ser gerado, aparece o aviso Não foi possível exportar os dados de contatos. Tente novamente.; tente de novo passado algum tempo.
A estrutura do Excel
Cada jogador é uma linha à parte; os dois jogadores de uma partida ficam em linhas consecutivas. As colunas, por ordem:
| Coluna | Conteúdo |
|---|---|
| SessionId | A identidade da partida. Os dois jogadores da mesma partida têm o mesmo valor; é por aqui que emparelha as partidas |
| Player | 1 = Jogador 1 (X), 2 = Jogador 2 (O) |
| Os seus campos do formulário | Uma coluna com o nome que deu no separador Pesquisa. Uma resposta deixada vazia é uma célula vazia. As respostas de escolha múltipla são separadas por vírgulas |
| Score | O número de rodadas ganhas por esse jogador. 0 é um resultado real |
| Duration (s) | A duração da partida, em segundos. Igual para os dois jogadores |
| Date (UTC) | O momento em que a partida começou |
| Consent (UTC) | O momento do consentimento de privacidade (RGPD). Igual para os dois jogadores |
O que precisa de saber:
- Os cabeçalhos SessionId, Player, Score, Duration (s), Date (UTC) e Consent (UTC) são em inglês e fixos; não mudam com o idioma do painel web. As colunas do formulário são as etiquetas que escreveu.
- As colunas Player, Score, Duration (s) e Consent (UTC) só aparecem se existirem nos dados. Num evento sem nenhum consentimento recolhido não há coluna Consent (UTC).
- As datas e as horas de consentimento estão em UTC. Para a hora local, some a diferença do seu fuso horário (em Portugal continental, 0 h no inverno e 1 h no verão). No Excel pode selecionar a coluna e mudar o formato da hora; o valor vem como data.
- Num jogo cancelado antes do fim da partida, o jogador que disse Estou pronto aparece na linha e as células Score e Duration (s) ficam vazias.
- Se alterar a etiqueta de um campo a meio do evento, a etiqueta antiga e a nova passam a ser duas colunas separadas. Se der a mesma etiqueta a dois campos, as respostas juntam-se numa só coluna. Defina as etiquetas antes de o evento começar.
- O ficheiro é uma fotografia do momento. Para novos jogadores, descarregue de novo; o ficheiro antigo não se atualiza sozinho.
Jogos anteriores à atualização
Os jogos jogados antes desta atualização da aplicação não aparecem no Excel; a versão anterior não marcava a partida como "tem formulário" e a exportação não recolhe esses registos. Todas as partidas jogadas depois da atualização entram no ficheiro. Nos registos vindos da versão antiga, a coluna Consent (UTC) também está vazia.
Sem internet
O jogo joga-se sem internet; as respostas do formulário e os resultados acumulam-se no dispositivo. Quando a ligação volta, os registos acumulados são enviados por ordem; mesmo que a aplicação feche e abra entretanto, o envio continua de onde ficou. Estes registos só entram no Excel depois de a nuvem os receber. Ou seja, se não houve internet durante o evento, faça a exportação alguns minutos depois de a ligação voltar. Ao fechar o stand, para que a última partida seja enviada, espere alguns segundos com a internet ligada antes de fechar a aplicação.
A aplicação não mostra quantos registos estão à espera. Se comparar o número de jogadores no Excel com o número de partidas no separador Sessão → Partidas, percebe se falta alguma coisa: cada partida dá, no máximo, duas linhas.
Procurar um botão de Excel ou CSV na aplicação: não existe. A exportação está no painel web.
Desligar Sessão → Pesquisa e esperar dados: o formulário não aparece, nem sequer o nome é pedido e os jogadores dessas partidas não constam do Excel.
Não tornar nenhum campo obrigatório: aparece o botão Pular por agora e o jogador que salta não aparece no Excel. Deixe pelo menos o campo do nome obrigatório.
Alterar a etiqueta de um campo a meio do evento: a mesma informação divide-se em duas colunas.
Tomar as horas do Excel por hora local: estão em UTC; some a diferença do seu fuso horário.
Fechar o stand sem internet: os jogadores das últimas partidas não conseguem ir para a nuvem e faltam no Excel. Se a aplicação for aberta quando a ligação voltar, completa-se.
Procurar jogadores antigos: os jogos anteriores à atualização não entram no ficheiro.
