Este artigo também está disponível em:

Macros

A nossa plataforma permite utilizar macros nas ligações de chamada para ação (CTA), para inserir automaticamente valores dinâmicos, simplificar o seu trabalho e proporcionar uma experiência mais personalizada aos utilizadores.

O que é uma macro?

Uma macro é um marcador de posição ou código predefinido que é substituído automaticamente por um valor específico ou um conjunto de valores. Nas ligações CTA, as macros inserem informações de forma dinâmica, tornando as ligações mais personalizadas e funcionais, sem necessidade de atualizações manuais.

Como utilizar macros nas ligações CTA

Utilizar macros nas suas ligações CTA é simples. Basta seguir estes passos:

Escolha a macro: Selecione a macro adequada na lista abaixo.

Insira a macro: Adicione o código da macro à ligação CTA, no local onde pretende que apareça o valor dinâmico.

Guarde e pré-visualize: Guarde as alterações e pré-visualize a ligação CTA para confirmar que a macro é substituída pelo valor pretendido.

Onde podem ser utilizadas as macros?

As macros podem ser utilizadas como parâmetros de consulta em qualquer URL das suas ligações CTA.

Com as macros, pode criar ligações CTA mais úteis, que se atualizam automaticamente com informações relevantes.

Lista de macros disponíveis

Seguem-se as macros que pode utilizar e a descrição do que faz cada uma:

%SESSION_UID%: Insere o identificador único da sessão do jogador.

Exemplo: https://example.com/profile?session=%SESSION_UID%

%APP_ID%: Insere o ID do jogo atual.

Exemplo: “https://example.com/events?game_id=%APP_ID%

Ao incluir estas macros, garante que as suas ligações CTA estão sempre atualizadas e personalizadas, promovendo o envolvimento dos utilizadores e melhorando a experiência global.

Exemplos de macros em ação

Para perceber melhor como funcionam, veja alguns exemplos:

Antes: “https://example.com/profile”

Depois: “https://example.com/profile?session=%SESSION_UID%”

Isto permite identificar a sessão única de cada visitante através da ligação CTA.

Antes: “https://example.com/newsletter”

Depois: “https://example.com/newsletter?game_id=%APP_ID%”

Isto permite identificar o jogo de origem dos visitantes que acederam à ligação CTA.

Estes exemplos mostram como as macros podem tornar as suas chamadas para ação mais relevantes e ajudar a obter dados da sua aplicação a partir da ligação de destino.

Os valores das macros, como %SESSION_UID% e %APP_ID%, podem ser obtidos a partir da ligação de destino e utilizados para fazer chamadas à nossa API e consultar as informações desse utilizador.

Desta forma, pode obter e apresentar dinamicamente informações detalhadas sobre o utilizador com base nos valores das macros, proporcionando uma experiência personalizada e eficiente.

Macros disponíveis

Macro	Função
%SESSION_UID%	Devolve o ID da sessão atual do utilizador.
%APP_ID%	Devolve o ID da aplicação correspondente ao jogo em curso.
%ID_UNIC%	Devolve o identificador único do utilizador.
%GENDER%	Devolve o género do utilizador.
%USERNAME%	Devolve o nome de utilizador.
%FIRSTNAME%	Devolve o nome próprio do utilizador.
%LASTNAME%	Devolve o apelido do utilizador.
%EMAIL%	Devolve o endereço de e-mail do utilizador.
%PHONE_NUMBER%	Devolve o número de telefone do utilizador.
%ADDRESS%	Devolve a morada do utilizador.
%ZIP_CODE%	Devolve o código postal do utilizador.
%TOWN%	Devolve a cidade do utilizador.
%COUNTRY%	Devolve o país do utilizador.
%DOB%	Devolve a data de nascimento do utilizador no formato `YYYY-MM-DD`.
%COMPANY_NAME%	Devolve o nome da empresa do utilizador.
%WEBSITE%	Devolve o site do utilizador.
%PROFIL_UID%	Devolve o identificador único do perfil do utilizador.
%PROFIL_TITLE%	Devolve o título do perfil do utilizador.
%PRIZE_UID%	Devolve o identificador único do prémio.
%PRIZE_TITLE%	Devolve o título do prémio.
%PRIZE_REF%	Devolve a referência do prémio.
%PRIZE_CODE%	Devolve o código associado ao prémio.
%OPTIN_NEWSLETTER%	Devolve a indicação de que o utilizador aceitou ou não receber newsletters.
%CUSTOM_TEXT%	Devolve qualquer texto personalizado associado ao utilizador.
%CUSTOM_FORMAT%	Devolve qualquer formato personalizado associado ao utilizador.
%SCORE%	Devolve a pontuação do utilizador.
%SELECT_VALUE%	Devolve o primeiro valor selecionado.
%SELECT_VALUE2%	Devolve o segundo valor selecionado.
%CUSTOM_CHECKBOX%	Devolve o valor da caixa de seleção personalizada.
%TIME_TAKEN%	Devolve o tempo que o utilizador demorou, em segundos.
%LOCALE%	Devolve a definição de idioma e região do utilizador.
%REF%	Devolve a origem da participação: o parâmetro `ref` do URL do jogo, caso tenha sido definido; caso contrário, o domínio de referência ou `direct`, se nenhum dos anteriores estiver disponível.

Nota: Todos os dados devolvidos pelas macros são processados com rawurlencode para garantir a compatibilidade com os URLs. Isto significa que os caracteres especiais são codificados para poderem ser utilizados em segurança nas ligações, mantendo o seu funcionamento e evitando possíveis problemas com caracteres reservados ou não seguros. Por exemplo, um espaço aparece como %20 e os caracteres especiais, como &, são codificados como %26.

Actualizado em: 29/10/2026

Esse artigo foi útil?

Obrigado!