> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.drimify.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Estrutura de Dados & API

Existem 3 formas para ligar à nossa API:

* Usar Zapier - https://help.drimify.com/pt/article/integracao-com-o-zapier-pidoat/
* Usar Make - https://help.drimify.com/pt/article/integracao-com-makecom-dmxzv0/
* Chamadas diretas à API - documentação e exemplos disponíveis aqui: https://endpoint.drimify.com/api/docs?ui=re_doc# Estrutura de Dados da API

Aqui está como você poderia preencher a coluna **Dados Example** com base nos formatos comuns para esses tipos de campos:

| Chave | Descrição | Exemplo de Dados |
| ---- |
| **Id** | ID único. | `123456` |
| **appId** | ID da Aplicação. | `123456` |
| **appRef** | Referência interna da Aplicação. | `my campaign` |
| **idunic** | Dados recolhidos para o campo ID único. | `ABC123XYZ` |
| **gender** | Dados recolhidos para o campo de género. | `Male` / `Female` / `Prefer not para say` |
| **username** | Dados recolhidos para o campo de nome de utilizador. | `johndoe` |
| **firstName** | Dados recolhidos para o campo de primeiro nome. | `John` |
| **lastName** | Dados recolhidos para o campo de apelido. | `Doe` |
| **email** | Dados recolhidos para o campo de email. | `johndoe@example.com` |
| **dob** | Dados recolhidos para o campo de data de nascimento. | `1990-01-01T00:00:00+01:00` |
| **address** | Dados recolhidos para o campo de morada. | `123 Main St, Apt 4B` |
| **cp** | Dados recolhidos para o campo de código postal. | `12345` |
| **town** | Dados recolhidos para o campo de cidade. | `New York` |
| **country** | Dados recolhidos para o campo de país. | `United States` |
| **phoneNumber** | Dados recolhidos para o campo de número de telefone. | `+12025550199` |
| **companyName** | Dados recolhidos para o campo de nome da empresa. | `Example Corp.` |
| **website** | Dados recolhidos para o campo de site. | `https://www.example.com` |
| **optinNewsletter** | Dados recolhidos para o checkbox de opt-in. | `true` / `false` |
| **customText** | Dados recolhidos para o campo de texto personalizado. | `Custom entry value` |
| **customFormat** | Dados recolhidos para o campo de formato personalizado. | `Custom entry value` |
| **profil** | Resultado de Perfil se aplicação de teste/quiz/pesquisa de personalidade. | `Explorer` |
| **profilUid** | ID único de Perfil se aplicação de teste/quiz/pesquisa de personalidade. | `EXPL123` |
| **score** | Pontuação do utilizador se aplicação baseada em pontuação. | `85` |
| **prizeUid** | UID do prémio, se nenhum prémio for ganho retorna "lost". | `0f8e4a298ba5c036c7db5e5ef1ce422e85ceb5e3` / `lost` |
| **prizeTitle** | Título do Prémio registrado quando o utilizador ganha um prémio. | `Gold Membership` |
| **prizeRef** | Referência do Prémio registrada quando o utilizador ganha um prémio. | `GOLD2023` |
| **code** | Código ganho pelo utilizador. | `WIN12345` |
| **date** | Carimbo de tempo do servidor. | `2024-11-10T19:09:32+01:00` |
| **publisherId** | ID do publicador. | `PUB123` |
| **sessionId** | ID da sessão do utilizador. | `Session_296c9d74f159eacf374a2ac4e9d6f028` |
| **countryCode** | Código do país baseado no IP do utilizador. | `FR` |
| **selectValue** | Dados recolhidos para o menu suspenso personalizado. | `Option A` |
| **selectValue2** | Dados recolhidos para o segundo menu suspenso personalizado. | `Option B` |
| **customCheckbox** | Dados recolhidos para a lista de caixa de seleção personalizada. Se múltiplas opções forem selecionadas, os valores serão separados por uma barra vertical. (`∣`) | `Option 1 ∣ Option 2` |
| **timeTaken** | Tempo gasto pelo utilizador na aplicação em segundos. | `360` |
| **levelsPlayed** | Total de níveis completados pelo utilizador em Combo™, Percurso Dinâmico™, ou experiências Calendário De Advento. Retorna null para qualquer outro tipo de jogo. | `123456` |
| **referral** | Indicação de fonte de tráfego. | `direct` |
| **updatedAt** | Dados de quando as informações foram atualizadas. | `2024-11-10T19:09:32+01:00` |
| **connectionCountry** | País baseado no IP do utilizador. | `France` |
| **updatedAtTimeStamp** | Carimbo de tempo de quando os dados foram atualizados. | `1731262172` |
| **dateWithTimezone** | Carimbo de tempo convertido para o fuso horário da aplicação. | `2024-11-10T17:09:32+01:00` |
| **played** | Indicador que retorna `true` se o utilizador jogou a mecânica do jogo, caso contrário `false` | `true` / `false` |
| **locale** | Idioma da aplicação usado durante a experiência do utilizador. | `en` |
| **ipAddress** | Endereço IP do utilizador. | `192.168.1.1` |