--- title: "Raspadinhas" slug: "scratchcard" updated: 2026-06-12T10:30:59Z published: 2026-06-12T10:30:59Z canonical: "docs.xtremepush.com/scratchcard" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.xtremepush.com/llms.txt > Use this file to discover all available pages before exploring further. # Raspadinha ## Visão Geral do Jogo[](/docs/pt-br/scratchcard#game-overview) *Raspadinha* é um jogo no estilo cassino em que o usuário recebe um tabuleiro contendo várias peças que ele risca na esperança de revelar imagens combinando para ganhar um prêmio. Por exemplo, um jogador pode revelar 3 imagens iguais para ganhar uma promoção de apostar 5 ou ganhar 10 em um jogo a dinheiro, ou pode não revelar imagens iguais e ter que voltar a jogar em outro dia. O vídeo de exemplo abaixo mostra [o que ele mostra]. [VÍDEO AQUI] Você pode personalizar totalmente a aparência do jogo substituindo os recursos padrão, como tiles, fundos e sons, para atender às necessidades da sua marca. O jogo inteiro é construído e gerenciado dentro da plataforma Xtremepush e pode ser incorporado diretamente no seu site. ## Principais Recursos e Requisitos[](/docs/pt-br/scratchcard#key-features-and-requirements) ## Principais Recursos[](/docs/pt-br/scratchcard#key-features) - Grade de prêmios com tipos de prêmios personalizáveis por segmento de público. - Número personalizável de jogadas por jogador por dia/semana/campanha. - Personalização completa do Asset: Todos os assets visuais e sonoros são totalmente personalizáveis, incluindo os tiles, o fundo e os sons da interface. - Modelo de Jogo Personalizável: O jogo é construído a partir de um modelo com um layout padrão de grade 3x3, que pode ser modificado manualmente adicionando ou removendo peças. ## Configuração do Prêmio[](/docs/pt-br/scratchcard#prize-configuration) - Controlar a probabilidade de quais resultados é revelada atribuindo um peso relativo a cada prêmio. Por exemplo, uma mensagem personalizada pode ter um peso alto para ser revelada com mais frequência, enquanto um prêmio grande teria um peso muito baixo. - Defina um limite de volume para cada prêmio, que controla o total de vezes que esse prêmio pode ser concedido durante toda a duração da campanha. - Ajuste as chances de ganhar para diferentes segmentos de clientes definindo ponderações únicas para cada grupo. Por exemplo *, VIPs* vs. *Novos Usuários*. Para mais informações, consulte a seção [Configurar Prêmios](/documentation/docs/pt-br/scratchcard#configure-prizes) abaixo. ## Análise e Rastreamento[](/docs/pt-br/scratchcard#analytics-and-tracking) A plataforma Xtremepush rastreia automaticamente os seguintes dados de engajamento para o jogo *Advent Calendar* : - Um registro de cada usuário que jogou o jogo. - Carimbos de data e hora de quando o jogo foi aberto e quando um prêmio foi revelado. - Detalhes sobre quais usuários ganharam um prêmio. - Carimbos de data e hora de quando um prêmio foi aceito ou recusado. ## Pré-requisitos para a Configuração do Jogo[](/docs/pt-br/scratchcard#prerequisites-of-game-setup) - Segmentos de Usuário: Para direcionar seu jogo a jogadores específicos, você precisará de segmentos pré-configurados. Esses devem ser criados na plataforma Xtremepush antes de começar. Para mais informações, [veja Antes de Criar uma Campanha de Jogo](/documentation/docs/pt-br/before-you-create-a-game-campaign). - Recursos do Jogo: Tenha seus recursos do jogo preparados. Incluem imagens do fundo do jogo, tiles e outros elementos da marca. ## Visão geral do processo de configuração[](/docs/pt-br/scratchcard#setup-process-overview) As seções a seguir fornecem uma visão geral geral dos passos necessários para configurar um jogo de raspadinha, com links para documentação mais detalhada. O infográfico abaixo destaca as quatro etapas principais do fluxo de trabalho de lançamento do jogo, desde a criação até o monitoramento: ### Criar Campanha Defina as regras do seu novo jogo. ✏️ 🎨 ### Design Personalizado Substitua assets e atualize os textos. ### Configurar Mecânica Configure prêmios e horários opcionais. ⚙️ 🚀 ### Lançamento & Monitoramento Incorpore seu jogo e veja a atividade dos jogadores. ## Crie sua Campanha de Jogo[](/docs/pt-br/scratchcard#create-your-game-campaign) The first step in creating your game is creating a game campaign. A campaign acts as the container for your game, allowing you to define crucial aspects like target audiences, campaign duration and more. It also contains your game’s design, text, and prize configurations. For more information on the required fields when setting up campaigns, see [Create a Game Campaign](/documentation/docs/create-a-game-campaign) Selecting a template automatically loads a complete layout file and the necessary assets into your campaign's **Assets** tab. This streamlines configuration, allowing you to easily replace the default assets with your own without needing to build the game's layout from scratch. Ao criar a campanha do jogo, certifique-se de selecionar o modelo desejado. Por exemplo **, Scratchcard Classic**. ## Faça Alterações de Design no Seu Jogo[](/docs/pt-br/scratchcard#make-design-changes-to-your-game) Após criar a campanha, o próximo passo é personalizar o design visual e o texto do jogo para combinar com sua marca. Isso envolve três áreas-chave: - Substituir ou Adicionar Recursos: O modelo que você selecionar fornece um pacote padrão de ativos, que inclui imagens padrão para o fundo, blocos e prêmios. Você tem duas opções de personalização: - Você pode substituir qualquer um dos assets padrão por suas próprias versões de marca. Para mais informações, [veja Substituir Ativos](/documentation/docs/pt-br/replace-assets). - Você também pode adicionar novos recursos que não fazem parte do pacote padrão. Para mais informações sobre como adicionar novos ativos, veja [Gerenciar Ativos](/documentation/docs/pt-br/manage-assets). Para uma visão geral dos assets do jogo, veja [Visão Geral dos Assets](/documentation/docs/pt-br/assets-overview) - Atualizar Textos do Jogo: Na aba **Textos** , você pode atualizar todo o texto padrão que aparece na interface do seu jogo. No entanto, o texto exibido quando um jogador revela um prêmio específico é configurado separadamente na **aba Prêmios** . Para mais informações, veja [Textos de Atualização](/documentation/docs/pt-br/update-game-texts) - Faça Alterações de Design no Editor: Para controle detalhado sobre a aparência do front-end do jogo, use o Editor. Ele permite fazer ajustes visuais detalhados, como redimensionar ou reposicionar elementos, modificar fontes e cores, ou adicionar novos componentes. Para mais informações, veja as seguintes páginas: - [Visão geral do editor](/documentation/docs/pt-br/editor-overview) - [Casos de Uso do Editor](/documentation/docs/pt-br/handle-prize-redirects-from-your-website) - [atualização para prêmios de raspadinha] [Adicione Dias Adicionais ao Calendário do Advento](/documentation/docs/pt-br/add-additional-days-to-the-advent-calendar) ## Configurar Mecânicas de Jogo[](/docs/pt-br/scratchcard#configure-game-mechanics) ### Configurar Prêmios[](/docs/pt-br/scratchcard#configure-prizes) No jogo de raspadinha, o prêmio é determinado com base no carregamento do jogo com base em um sistema de probabilidade ponderada e exibido ao usuário em um pop-up quando ele vence. A probabilidade de receber qualquer prêmio é determinada pelo seu peso em relação ao peso total de todos os outros prêmios disponíveis para o segmento desse jogador. Por exemplo, um prêmio com peso 40 de um pool com peso total de 100 tem 40% de chance de ser revelado. - Configure prêmios Win para matches bem-sucedidos e resultados No Win para todos os outros cenários. - Estabeleça uma estrutura de prêmios que defina recompensas únicas para diferentes combinações corretas. Por exemplo, bônus de €5 para uma combinação de símbolos e bônus de €20 para outra. - Controle as chances de ganhar atribuindo um peso relativo a cada prêmio potencial. - Controle a probabilidade de ganhar cada prêmio atribuindo um peso relativo, que pode ser ajustado para diferentes segmentos de clientes, por exemplo, VIPs vs Novos Usuários. Como o prêmio é usado para cada revelação, dependendo do valor do prêmio, os jogadores podem ganhar o mesmo prêmio mais de uma vez durante a campanha. Para isso, é possível definir limites para cada prêmio, como limites diários/semanais, ou até mesmo um volume total que pode ser ganho entre todos os jogadores. > [!NOTE] > Resultados sem saída > > [](/docs/pt-br/scratchcard#no-win-outcomes) > > Configure um caso sem saída criando um novo prêmio e ativando a opção **de não ganhar** , que vai remover as opções de configuração relacionadas a quantos símbolos combinados são necessários, pois isso se torna irrelevante. Para mais informações sobre como configurar os prêmios e os campos exigidos, veja [Configurar Prêmios](/documentation/docs/pt-br/configure-prizes). #### Exemplo de Configuração do Prêmio[](/docs/pt-br/scratchcard#example-prize-pool-configuration) [detalhes] | Prêmio | Peso (Jogadores VIP) | Peso (Jogadores Padrão) | | --- | --- | --- | | Prêmio Principal de €20 | 2 | 1 | | Bônus de €5 | 8 | 2 | | 5 Apostas Grátis | 15 | 10 | | 10 Rodadas Grátis | 25 | 20 | | 50 rodadas grátis | 25 | 20 | | Bônus de €1 | 15 | 7 | | Volte amanhã | 10 | 40 | ### Gerenciar Intervalos de Tempo[](/docs/pt-br/scratchcard#manage-time-slots) You can control your game's daily availability by setting up specific time slots when it can be played. For example, you could make the game available only during a 'happy hour' promotion from 5 PM to 7 PM. For more information, see [Manage Time Slots (Optional)](/documentation/docs/manage-time-slots-optional). ## Lançamento e Monitoramento do Jogo[](/docs/pt-br/scratchcard#launch-and-monitor-game) ### Inicie seu Jogo[](/docs/pt-br/scratchcard#launch-your-game) To launch your game, you must embed it on your website. For added security, you can also use a JWT token to ensure that only authenticated users are able to play. For more information, see the following pages: - [Launch your Game](/documentation/docs/launch-your-game) - [JWT Authentication Details](/documentation/docs/jwt-authentication-details). ### Monitore a Atividade do Jogador[](/docs/pt-br/scratchcard#monitor-player-activity) A plataforma Xtremepush rastreia automaticamente os seguintes dados de engajamento para o jogo *Raspadinha* , que você pode visualizar na aba **Jogos** da sua campanha: - Um registro de cada usuário que jogou o jogo. - Carimbos de tempo para quando o jogo foi aberto (**Criado em)** e quando um bloco foi revelado (**Aberto em).** - Detalhes sobre quais usuários ganharam um prêmio. - Carimbos de data e hora de quando um prêmio foi aceito ou recusado.