Gerir Campos de Segmento
Gerir Campos de Segmento encontra-se em Definições → CRM → Gerir Campos de Segmento na navegação do lado esquerdo. É o local central onde pode configurar os atributos de dados disponíveis ao criar segmentos de jogadores no Fast Track CRM.
A página contém três separadores; este artigo irá focar-se em Campos de Segmento mas pode encontrar mais informações sobre os outros separadores aqui:
Campos de Segmento definem que pontos de dados do jogador — como montantes de bónus, rondas jogadas, GGR ou contagens de depósitos — estão disponíveis como critérios de filtro no Segment Builder.
De onde vêm os Campos de Segmento?
A lógica por trás dos campos de segmento é obtida do repositório analytics-config — especificamente dos ficheiros de patch e de configuração configurados para cada parceiro. O ficheiro de patch que um parceiro está a usar pode ser confirmado no módulo OCD analytics-config. Ao adicionar ou resolver problemas num campo, verifique sempre se o campo existe e está corretamente definido no ficheiro de patch relevante antes de o configurar no CRM.
Permissões e Controlo de Acesso
O acesso a Gerir Campos de Segmento é limitado a utilizadores com as seguintes permissões:
| Permissão | O que permite |
|---|---|
Visualizar | Navegar e pesquisar na lista de Campos de Segmento |
Editar | Modificar Campos de Segmento existentes |
Criar | Adicionar novos Campos de Segmento |
A Lista de Campos de Segmento
O separador Campos de Segmento apresenta todos os campos configurados numa lista ordenável com as seguintes colunas:
| Coluna | Descrição |
|---|---|
Estado | Um ponto verde indica que o campo está ativo (Está Ativado). |
Nome | O identificador ao nível do sistema para o campo (por exemplo, bonus_activity-bonus_amount_granted). Isto é usado internamente e em integrações. |
Etiqueta | O nome legível apresentado no Query Builder (por exemplo, Montante de Bónus Concedido). Alguns campos também apresentam um Alias por baixo da etiqueta. |
Descrição | Uma breve explicação do que o campo representa (por exemplo, Montante Total de Bónus Concedido). |
Tipo de Valor | O tipo de dados do campo, como double ou integer. |
Número de Segmentos | O número de segmentos que estão atualmente a usar este campo como critério. |
Pesquisar e Ordenar
- Use a barra de Pesquisar (canto superior direito da lista) para filtrar campos por nome ou etiqueta.
- Clique no cabeçalho da Nome coluna para ordenar a lista alfabeticamente.
Exportar Campos de Segmento
Para exportar a lista completa de campos de segmento, clique no botão Exportar Campos de Segmento no canto superior direito. Isto transfere a lista para referência ou fins de auditoria.
Criar um Novo Campo de Segmento
- Clique no cabeçalho da Novo Campo botão no canto superior direito.
- O painel Detalhes do Campo de Segmento será aberto. Complete os campos em duas secções: Detalhes Gerais e Definições do Query Builder.
- Assim que todos os campos obrigatórios estiverem concluídos, clique em Adicionar (canto superior direito do painel) para guardar.
Detalhes Gerais
| Campo | Descrição |
|---|---|
Nome | A chave ao nível do sistema para o campo (usa underscores, sem espaços). Esta é só de leitura depois de guardada. Deve seguir o formato NomeDaTabela-NomeDaColuna para garantir o mapeamento correto dos dados (por exemplo, bonus_activity-bonus_amount_granted). |
Etiqueta | O nome apresentado no Query Builder (por exemplo, Montante de Bónus Concedido). |
Valor de Exemplo | Um valor de exemplo opcional para ajudar a להבין que dados este campo pode conter. |
Descrição | Uma explicação em linguagem simples do que este campo representa (por exemplo, Montante Total de Bónus Concedido). |
Tipo de Campo | O tipo de dados. Selecione no menu pendente — veja Tipos de Campo abaixo. |
É Dados Sensíveis? | Assinale esta caixa se o campo contiver dados pessoais identificáveis ou dados sensíveis do jogador. |
Está Ativado? | Ative para tornar o campo ativo e disponível no Query Builder. |
Tabelas das quais nunca deve adicionar campos:
- Nunca adicione campos da tabela daily_player_activity . Fazer isso fará com que a base de dados falhe.
- Nunca adicione campos de tabelas de eventos. Fazer isso fará com que a base de dados falhe.
Tipos de Campo
Ao criar um campo, o Tipo de Campo determina como os dados são armazenados e como podem ser filtrados no Query Builder.
| Tipo de Campo | Descrição | Exemplos de Utilização |
|---|---|---|
double | Um número com precisão decimal | Montante de Bónus Concedido, GGR, NGR, Total de Apostas |
integer | Um número inteiro | Bónus Concluídos, Rondas Jogadas, Contagem de Depósitos |
boolean | Um valor verdadeiro/falso | Fez Depósito, É VIP, Está Inscrito |
string | Texto livre ou um valor de texto fixo | Código de País, Etiqueta do Jogador, Código Promocional |
date | Uma data de calendário | Data de Registo, Data do Último Login |
datetime | Uma data com carimbo de data/hora | Hora da Última Transação, Hora de Ativação do Bónus |
array | Uma lista de vários valores | Categorias de Jogos Preferidas, Canais Inscritos |
mediaurl | Um URL que aponta para um recurso multimédia | Avatar do Jogador, Banner Promocional, Imagem de Perfil |
Dica: Use double para qualquer valor monetário ou baseado em rácio. Use integer para contagens. Escolher o tipo errado pode limitar a forma como o campo pode ser filtrado no Query Builder.
Definições do Query Builder
| Campo | Descrição |
|---|---|
Tipo de Entrada | Determina como o campo é apresentado como filtro no Query Builder (por exemplo, Number ou ). |
Grupo de Campo (opcional) | Agrupa o campo sob uma categoria no Query Builder para facilitar a navegação (por exemplo, 1 - FEED EM TEMPO REAL). |
Sugestão | Uma dica curta apresentada aos operadores quando passam o rato sobre o campo no Query Builder. |
Mais Informação | Uma descrição mais longa apresentada como um parágrafo por baixo da regra no Query Builder — útil para fornecer contexto sobre como o campo é calculado ou obtido. |
Configurar Opções de Menu Pendente
Quando o Tipo de Entrada nas Definições do Query Builder estiver definido como Menu Pendente, aparece uma tabela adicional de Opções de Menu Pendente . Isto permite mapear os valores brutos enviados pela integração para etiquetas legíveis, que os operadores podem selecionar ao criar segmentos — em vez de terem de conhecer ou introduzir o código subjacente.
Por exemplo, um campo de idioma que recebe códigos ISO da integração (fr, es, en) pode ser mapeado para ser apresentado como Francês, Espanhol, Inglês no criador de segmentos.
Adicionar Opções de Menu Pendentes
- Abra o campo e defina Tipo de Entrada para Menu Pendente na secção de Definições do Query Builder.
- O painel Opções de Menu Pendente a tabela irá aparecer. Clique no botão + (canto superior direito da tabela) para adicionar uma nova linha.
- Para cada opção, preencha o seguinte:
| Coluna | Descrição |
|---|---|
Valor | O valor bruto tal como é enviado pela integração (por exemplo, fr, es, en). Este deve corresponder exatamente ao que a plataforma envia. |
Texto | A etiqueta legível apresentada aos operadores no criador de segmentos (por exemplo, Francês, Espanhol, Inglês). |
Ativado | Assinale para tornar esta opção selecionável. Desmarque para a ocultar do criador de segmentos sem a eliminar. |
Adicionar aos Favoritos | Clique no ícone da estrela para fixar esta opção no topo da lista de opções — útil para valores usados com frequência. |
- Repita para cada valor que a integração possa enviar.
- Para remover uma opção, clique no ícone do caixote do lixo nessa linha.
- Clique em Atualizar para guardar todas as alterações.
Dica: Os valores na coluna Valor devem corresponder exatamente ao que a integração envia. Se chegar um valor sem uma opção de menu pendente correspondente, ele não será selecionável no criador de segmentos. Em caso de dúvida, verifique os valores brutos no ficheiro de patch analytics-config ou confirme através do módulo OCD analytics-config.
Editar um Campo de Segmento Existente
- Na lista de Campos de Segmento, clique no campo que pretende editar. O painel Detalhes do Campo de Segmento será aberto.
- Reveja o Número de Segmentos na lista antes de editar — os campos com uma contagem acima de 0 estão em uso ativo.
- Atualize as definições pretendidas. Note que o Nome (chave do sistema) está bloqueado e não pode ser alterado após a criação.
- Clique em Atualizar para guardar as suas alterações.
Nota: Os campos atualmente usados em segmentos em produção têm um Número de Segmentos superior a 0. Modificar ou desativar estes campos pode afetar a segmentação ativa de campanhas. Verifique sempre a Contagem de Segmentos antes de fazer alterações.
Dica: Use o ícone de histórico (ícone de relógio, canto superior direito do painel) para rever versões anteriores da configuração do campo.
Ativar ou Desativar um Campo de Segmento
- Para desativar um campo sem o eliminar, abra o campo e desmarque o interruptor Está Ativado? e depois clique em Atualizar. O ponto verde de estado será removido da lista.
- Para reativar um campo, ative novamente o interruptor Está Ativado? e clique em Atualizar.
Desativar um campo remove-o do Query Builder para novos segmentos, mas não o remove dos segmentos em que já está a ser usado.