A nossa plataforma suporta macros para links de chamada para ação (CTA), permitindo-lhe adicionar valores dinâmicos que se preenchem automaticamente para otimizar o seu fluxo de trabalho e proporcionar uma experiência mais personalizada para o utilizador.

O que é uma macro?

Uma macro é um espaço reservado ou código predefinido que se expande automaticamente para um valor ou conjunto de valores específicos. No contexto dos seus links CTA, uma macro insere informação dinamicamente, tornando os seus links mais personalizados e funcionais sem necessidade de atualizações manuais.

Como utilizar macros em links CTA

Usar macros nos seus links CTA é simples. Veja como pode fazê-lo:

Identificar a macro: Escolha a macro adequada da lista fornecida abaixo.

Inserir a macro: Adicione o código da macro no seu link CTA onde deseja que o valor dinâmico apareça.

Guardar e visualizar: Guarde as suas alterações e visualize o link CTA para garantir que a macro é corretamente substituída pelo valor pretendido.

Onde podem ser usadas as macros?

As macros podem ser usadas em qualquer URL nos seus links CTA como parâmetros de consulta.

Ao usar macros, pode criar links CTA mais eficazes que se atualizam automaticamente com informação relevante.

Lista de macros disponíveis

Aqui está uma lista das macros que pode utilizar, juntamente com descrições do que elas fazem:

%SESSION_UID%: Insere o uid 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, pode garantir que os seus links CTA estão sempre atualizados e personalizados, aumentando o envolvimento do utilizador e a experiência geral.

Exemplos de Macros em Ação

Para uma melhor compreensão, aqui estão 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 do link CTA.

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

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

Isto permite atribuir de que jogo vieram os visitantes para o link CTA.

Estes exemplos mostram como as macros podem tornar os seus CTAs mais relevantes e ajudá-lo a recuperar dados da sua aplicação, a partir do link direcionado.

Os valores das macros, como %SESSION_UID% e %APP_ID%, podem ser recuperados do link direcionado e depois usados para chamar a nossa API para verificar a informação desse utilizador.

Isto permite-lhe obter e exibir dinamicamente dados abrangentes do utilizador com base nos valores das macros, proporcionando uma experiência de utilizador 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 do jogo atual 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 primeiro nome do utilizador.
%LASTNAME%	Devolve o sobrenome do utilizador.
%EMAIL%	Devolve o endereço de e-mail do utilizador.
%PHONE_NUMBER%	Devolve o número de telefone do utilizador.
%ADDRESS%	Devolve o endereço 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 AAAA-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 para o 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%	Informa se o utilizador optou por 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 gasto pelo utilizador em segundos.
%LOCALE%	Devolve a localidade do utilizador.

Nota:
Todos os dados dos macros devolvidos são processados usando rawurlencode para garantir compatibilidade em URLs. Isso significa que caracteres especiais são codificados para uso seguro em links, preservando a funcionalidade e evitando possíveis problemas com caracteres reservados ou inseguros. Por exemplo, um espaço aparecerá como %20, e caracteres especiais como & serão codificados como %26.

Actualizado em: 23/02/2025