Posição premiada e o pool de prêmios

É a modalidade em que a campanha monta um pool de posições e cada participação consome uma delas. Se a posição consumida paga prêmio, o participante entra em análise; se não paga, ele vê o vídeo de não premiado. Vale-brinde é o nome comercial dessa modalidade — é como o participante a vê no hotsite e como o cliente a chama no regulamento. Não é uma modalidade separada: é a mesma posição premiada.

Premiável e distribuída

Cada posição do pool tem duas marcas distintas, e confundi-las é a origem de quase toda dúvida:

• premiável é configuração: a posição paga prêmio? Quando não paga, ela é posição de enchimento;
• distribuída é resultado: a posição já foi entregue a alguém.

Separar as duas é o que permite distinguir a posição de enchimento (que nunca paga) da posição premiável que ainda não saiu. Posição de enchimento ocupa uma vaga do pool e pode ser consumida, mas não gera premiação — é ela que faz o hotsite mostrar o vídeo de não premiado. Ao gravar uma posição como não premiável, o sistema zera prêmio, descrição e valor, para não deixar prêmio fantasma pendurado.

Os prêmios

Os prêmios são filhos da campanha; não existe catálogo global. Cada prêmio pertence a uma modalidade, e é isso que impede pagar uma posição com prêmio de sorteio.

O que a posição paga não muda depois que ela sai. Posição distribuída não troca de prêmio nem vira enchimento, e prêmio já entregue não muda de nome nem de valor — as duas coisas são recusadas. O motivo é direto: o nome e o valor são lidos ao vivo do catálogo pela fila de apuração, pelo e-mail de aprovação e pela lista de ganhadores, então editá-los reescreveria o que já foi aprovado e comunicado. Numa promoção regulada, isso é o valor do prêmio mudando depois do fato. Imagem, ordem e rede continuam editáveis; para pagar outra coisa, cadastra-se outro prêmio e vinculam-se as posições que ainda não saíram.

Fila global ou por rede

A fila de posições pode ser global (uma fila só) ou por rede (uma fila por rede), e isso vem das regras ativas da modalidade. A posição é cadastrada para o escopo que vale no momento, e trocar o escopo depois não move as posições que já estão no pool: elas ficariam no pool e nunca sairiam, sem erro em lugar nenhum. Por isso a troca é recusada enquanto houver posição no pool, com mensagem que diz a campanha, quantas posições estão lá e o que fazer — desativar ou excluir as posições, ou desfazer a importação que as criou.

A posição é única no pool pela combinação de campanha, posição, rede e data do prêmio. A data do prêmio é data pura, sem hora, para que a mesma posição não entre duas vezes.

A importação de posições

Na importação, o arquivo traz data, posição e a marcação de premiável — não traz prêmio nem rede. O operador escolhe no formulário um prêmio ativo da modalidade, e toda linha premiável aponta para ele (as de enchimento entram sem prêmio); a rede, quando é o caso, vale para o arquivo inteiro. Campanha por rede exige a rede, e campanha sem rede a recusa — nos dois casos o arquivo inteiro é recusado, porque posição do lado errado da fila fica no pool e nunca sai.

A marcação de premiável aceita várias formas: true ou false, 1 ou 0, S ou N, SIM ou NÃO, V ou F, VERDADEIRO ou FALSO. Marcação ausente ou não reconhecida recusa a linha: assumir um lado geraria prêmio indevido ou posição que deveria pagar e não paga, e os dois erram em silêncio, no dinheiro.

Atenção para quem vem do sistema anterior: lá a coluna "premiado" queria dizer "já saiu". Aqui o sentido é outro, então arquivo antigo não deve ser reaproveitado sem conferir a marcação. Layouts antigos (4 colunas com a rede na frente, ou 5 e 6 colunas com descrição e valor, do sistema anterior) são recusados com erro que indica o layout atual.

O que o participante vê

Na área logada, o participante vê a posição com uma situação reduzida a três estados: em análise, aprovada ou reprovada. Internamente há muito mais estados, e eles não aparecem de propósito — alguns dizem em que ponto o provedor de pagamento está e carregam o nome dele, outros são pendência vista de dentro. Os estados de erro saem como "em análise", porque do lado de quem espera o prêmio o desfecho ainda não existe. A posição de enchimento não tem situação, porque não passa por apuração.

O vídeo do resultado é escolhido pela API, não pela tela: pelo par "a posição premiou" e "o vídeo é de premiado", entre os vídeos ativos da campanha. Vídeo inativo é ignorado mesmo sendo o único do lado pedido — inativar é como a operação tira um vídeo do ar. Faltando o vídeo daquele lado, a tela simplesmente não mostra player, e isso é caso normal; o que não pode acontecer é cair no vídeo do outro lado, que diria ao premiado que ele não ganhou.

Ações de comunidade usam posições, mas são outra campanha

As ações de comunidade (as jogadas pelo WhatsApp criadas pela plataforma parceira) também sorteiam sobre posições premiadas, mas numa campanha própria, marcada como ação. Uma campanha de sorteio comum, com posições por nota, não recebe jogadas — as duas filas disputariam as mesmas posições. As regras das jogadas estão no artigo de ações de comunidade.

Vale-brinde e posição premiada são a mesma coisa: vale-brinde é o nome comercial, posição premiada é como a configuração aparece. O cliente monta um pool, e cada participação ocupa uma posição dele.

As posições de enchimento são parte da mecânica, não erro de cadastro: elas existem para que a maioria das participações tenha um resultado "não premiado" e ainda assim consuma uma vaga da fila.

Duas coisas que o cliente precisa saber antes de pedir mudança: depois que uma posição saiu, o que ela paga não muda mais — nem o prêmio, nem o nome, nem o valor. Para pagar outra coisa, cadastra-se um prêmio novo e vinculam-se as posições que ainda não saíram. E a troca entre fila global e fila por rede só é possível com o pool vazio.

• Falha: a campanha tem posições cadastradas e nenhuma sai para os participantes.
• Possivel causa: as posições foram cadastradas num escopo de fila diferente do que vale hoje — por exemplo, cadastradas sem rede numa campanha que passou a ser por rede. O motor procura do outro lado e elas ficam no pool.
• Como orientar: confira se as regras ativas da modalidade usam premiação por rede e se as posições do pool têm rede compatível. Desativar ou desfazer a importação e recadastrar no escopo certo resolve.
• Quando escalar: se o escopo bater e as posições continuarem sem sair, acionar o time de desenvolvimento urgentemente e abrir issue no Jira (projeto DEV) com as evidências.

• Falha: o operador não consegue trocar a premiação de global para por rede ou o contrário.
• Possivel causa: existe posição ativa e não distribuída no pool. A troca é recusada porque ela deixaria essas posições presas.
• Como orientar: a mensagem diz a campanha e quantas posições estão no pool. Desative ou exclua essas posições, ou desfaça a importação que as criou, e troque depois.
• Quando escalar: não é falha. Só escalar se a contagem da mensagem não corresponder ao pool.

• Falha: a importação de posições foi recusada, inteira ou em parte.
• Possivel causa: a rede está ausente numa campanha por rede ou presente numa campanha sem rede (o arquivo inteiro cai), ou o layout é antigo, ou alguma linha está com a marcação de premiável vazia ou não reconhecida (a linha é recusada).
• Como orientar: use o modelo baixado da própria tela. O layout atual é data, posição e premiável — o prêmio e a rede saem do formulário, não do arquivo. Confira a coluna de premiável linha por linha.
• Quando escalar: se o arquivo seguir o modelo e a recusa continuar, abrir issue no Jira (projeto DEV) com as evidências.

• Falha: o cliente pediu para trocar o prêmio de uma posição e o sistema recusou.
• Possivel causa: a posição já foi distribuída, ou o registro já foi aprovado, ou já existe ganhador. Nesses casos o prêmio, o nome e o valor não mudam mais.
• Como orientar: explique que isso protege o que já foi aprovado e comunicado ao participante. Para pagar outra coisa, cadastre um prêmio novo e vincule as posições que ainda não saíram.
• Quando escalar: não é falha. Só escalar se a recusa aparecer em posição que nunca saiu.

• Falha: o participante não vê vídeo nenhum no resultado da posição.
• Possivel causa: a campanha não tem vídeo ativo do lado correspondente, ou o vídeo daquele lado foi inativado.
• Como orientar: confira os vídeos da campanha e se estão ativos. Ausência de vídeo é caso normal, não erro — a tela só não mostra o player.
• Quando escalar: se o participante premiado estiver vendo o vídeo de não premiado, ou o contrário, acionar o time de desenvolvimento urgentemente e abrir issue no Jira (projeto DEV) com as evidências.