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

O que é uma macro?

Uma macro é um placeholder ou código pré-definido que se expande automaticamente para um valor ou conjunto de valores específicos. No contexto dos seus links de CTA, uma macro insere informação de forma dinâmica, tornando os seus links mais personalizados e funcionais sem exigir atualizações manuais.

Como usar macros em links de CTA

Usar macros nos seus links de CTA é simples. Veja como fazer:

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

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

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

Onde podem ser usadas as macros?

As macros podem ser utilizadas 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ção relevante.

Lista de macros disponíveis

Aqui está uma lista das macros que pode usar, juntamente com as 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, garante que os seus links de CTA estão sempre atualizados e personalizados, aumentando o envolvimento dos utilizadores 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 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%

Isto permite 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 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 utilizados para chamar a nossa API para verificar a informação desse utilizador.

Isto permite-lhe buscar e apresentar dados abrangentes do utilizador de forma dinâmica com base nos valores das macros, proporcionando uma experiência 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 DO APLICAÇÃO do jogo atual em execução.
%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 a data 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 aderiu à newsletter.
%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 das macros retornados são processados utilizando 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: 16/11/2024