A nossa plataforma suporta macros para links de call-to-action (CTA), permitindo-lhe adicionar valores dinâmicos que são automaticamente preenchidos para simplificar o seu fluxo de trabalho e tornar a experiência do utilizador mais personalizada.

O que é uma macro?

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

Como utilizar macros em links de CTA

Utilizar macros nos seus links de CTA é fácil. Veja como pode fazê-lo:

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

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

Guardar e visualizar: Guarde as suas alterações e visualize o link de 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 dentro dos seus links de CTA como parâmetros de consulta.

Ao usar macros, pode criar links de CTA mais úteis que se atualizam automaticamente com informações relevantes.

Lista de macros disponíveis

Aqui está uma lista das macros que pode usar, juntamente com descrições do que 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 assegurar que os seus links de CTA estão sempre atualizados e personalizados, melhorando o envolvimento do utilizador e a experiência geral.

Exemplos de Macros em Ação

Para lhe dar uma melhor compreensão, aqui estão alguns exemplos:

Antes: https://example.com/profile

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

Isso permite-lhe identificar a sessão única de cada visitante através do link de CTA.

Antes: https://example.com/newsletter

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

Isso permite-lhe atribuir quais visitantes no link de CTA vieram de qual jogo.

Estes exemplos mostram como as macros podem tornar os seus CTAs mais relevantes e ajudá-lo a obter 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 usados para chamar a nossa API para verificar a informação daquele utilizador.

Isto permite-lhe buscar 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%	Retorna o ID da sessão atual do utilizador.
%APP_ID%	Retorna o ID da APLICAÇÃO do jogo atual sendo jogado.
%ID_UNIC%	Retorna o identificador único do utilizador.
%GENDER%	Retorna o gênero do utilizador.
%USERNAME%	Retorna o nome de utilizador do utilizador.
%FIRSTNAME%	Retorna o nome do utilizador.
%LASTNAME%	Retorna o sobrenome do utilizador.
%EMAIL%	Retorna o endereço de e-mail do utilizador.
%PHONE_NUMBER%	Retorna o número de telefone do utilizador.
%ADDRESS%	Retorna o endereço do utilizador.
%ZIP_CODE%	Retorna o código postal do utilizador.
%TOWN%	Retorna a cidade do utilizador.
%COUNTRY%	Retorna o país do utilizador.
%DOB%	Retorna os dados de nascimento do utilizador no formato AAAA-MM-DD.
%COMPANY_NAME%	Retorna o nome da empresa do utilizador.
%WEBSITE%	Retorna o site do utilizador.
%PROFIL_UID%	Retorna o identificador único do perfil do utilizador.
%PROFIL_TITLE%	Retorna o título do perfil do utilizador.
%PRIZE_UID%	Retorna o identificador único do prêmio.
%PRIZE_TITLE%	Retorna o título do prêmio.
%PRIZE_REF%	Retorna a referência do prêmio.
%PRIZE_CODE%	Retorna o código associado ao prêmio.
%OPTIN_NEWSLETTER%	Retorna se o utilizador optou por receber newsletters.
%CUSTOM_TEXT%	Retorna qualquer texto personalizado associado ao utilizador.
%CUSTOM_FORMAT%	Retorna qualquer formato personalizado associado ao utilizador.
%SCORE%	Retorna a pontuação do utilizador.
%SELECT_VALUE%	Retorna o primeiro valor selecionado.
%SELECT_VALUE2%	Retorna o segundo valor selecionado.
%CUSTOM_CHECKBOX%	Retorna o valor da caixa de seleção personalizada.
%TIME_TAKEN%	Retorna o tempo gasto pelo utilizador em segundos.
%LOCALE%	Retorna o local do utilizador.

Nota:
Todos os dados dos macros retornados são processados usando rawurlencode para garantir compatibilidade em URLs. Isso significa que caracteres especiais são codificados para uso seguro em links, mantendo a funcionalidade e evitando 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: 22/02/2025