A nossa plataforma suporta macros para links call-to-action (CTA), permitindo-lhe adicionar valores dinâmicos que se preenchem automaticamente para simplificar o seu fluxo de trabalho e proporcionar uma experiência mais personalizada ao utilizador.

O que é uma macro?

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

Como utilizar macros em links CTA

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

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

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

Guarde e visualize: 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 dentro dos seus links CTA como parâmetros de consulta.

Ao utilizar macros, pode criar links CTA mais úteis 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 sobre o 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%

Incluir estas macros garante que os seus links 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%

Isto permite-lhe 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-lhe atribuir qual visitante veio de qual jogo através do 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, em seguida, usados para chamar a nossa API para verificar a informação desse utilizador.

Isto permite-lhe buscar e exibir dados abrangentes do utilizador de forma dinâmica 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 que está a ser jogado.
%ID_UNIC%	Retorna o identificador único para o 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 para o perfil do utilizador.
%PROFIL_TITLE%	Retorna o título do perfil do utilizador.
%PRIZE_UID%	Retorna o identificador único para o 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 que o utilizador levou em segundos.
%LOCALE%	Retorna a localidade do utilizador.

Nota:
Todos os dados de macro retornados 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 problemas potenciais com caracteres reservados ou inseguros. Por exemplo, um espaço aparecerá como %20 e caracteres especiais como & serão codificados como %26.

Actualizado em: 01/03/2025