Artigos sobre: Programadores e API
Este artigo também está disponível em:

Passagem de Informação do Utilizador através de Parâmetros URL

As experiências Drimify agora suportam o pré-preenchimento de informação de utilizador diretamente através do URL utilizando parâmetros de query string. Isto permite uma experiência mais personalizada e simplifica a recolha de dados.


✅ Parâmetros de URL Suportados


Pode passar as seguintes variáveis opcionais no URL:


Parâmetro

Descrição

Exemplo de Valor

fname

nome

John ou codificado em base64 (Sm9obg==)

lname

apelido

apelido ou codificado em base64 (RG9l)

email

endereço de e-mail

Texto simples ou codificado em base64 (am9obi5kb2VAZXhhbXBsZS5jb20=)


🔗 Exemplos de URLs


Valores codificados em Base64:

https://apps.drimify.com/your-experience-id/?session_uid=ABC123&fname=Sm9obg==&lname=RG9l&email=am9obi5kb2VAZXhhbXBsZS5jb20=


Valores em texto simples:

https://apps.drimify.com/your-experience-id/?session_uid=ABC123&fname=John&lname=Doe&email=john.doe@example.com


🔒 Lógica de Codificação e Decodificação


  • Pode passar os valores como texto simples ou como strings codificadas em Base64.
  • A Drimify detetará automaticamente os valores codificados em Base64 e irá decodificá-los.
  • Seja codificado em Base64 ou não, todos os valores também são decodificados pelo URL do nosso lado para garantir que caracteres especiais, como espaços (%20), @, ou =, sejam corretamente interpretados.


⚠️ Importante para Integradores


Assegure-se de que:


  • Se enviar texto simples, deve ser codificado pelo URL antes de ser adicionado ao URL.
  • Se enviar Base64, deve:


  1. Primeiro codificar pelo URL o valor original (exemplo, John Doe → John%20Doe)
  2. Depois codificar esse resultado em Base64 (John%20Doe → Sm9obiUyMERvZQ==)
  3. Passá-lo na string de query
  4. Quando passar valores pelos parâmetros de URL, as strings codificadas em Base64 devem incluir o padding correto (=). Sem o padding correto, o sistema pode não decodificar o valor corretamente e será tratado como texto simples.


Porquê?


Isto assegura que os caracteres especiais são preservados e corretamente decodificados em todos os casos.


✉️ Validação de Email


Para segurança e integridade dos dados:


  • O parâmetro email só será utilizado se passar a validação de formato padrão de email.
  • Se o valor não corresponder a um formato válido, será ignorado e não armazenado.


💡 Casos de Uso


  • Tal como suportamos session_uid para identificar uma sessão de utilizador, agora suportamos fname, lname e email para pré-preencher dados de utilizador e evitar apresentar um formulário de recolha de dados.
  • Isto é ideal ao lançar experiências de campanhas de email ou ferramentas de CRM, onde a informação do participante já é conhecida.
  • Rastrear sessões individuais de utilizador de forma mais eficiente
  • Proporcionar uma experiência de utilizador fluida e personalizada


❓Precisa de Ajuda?


Se não tem a certeza de como codificar os valores corretamente ou deseja orientação na integração com a sua plataforma, sinta-se à vontade para [contactar a nossa equipa de suporte] ou consulte o nosso [guia de integração para programadores].

Actualizado em: 13/09/2025

Esse artigo foi útil?

Partilhe o seu feedback

Cancelar

Obrigado!