Artículos sobre: Desarrolladores y API
Este artículo también está disponible en:

Estructura de API y datos

Hay 3 formas de conectarse a nuestra API:



Qué devuelve la API


La API devuelve un registro por participación: los campos del formulario, el resultado (puntuación, perfil o premio) y los campos técnicos que se detallan en la tabla siguiente. No devuelve las respuestas individuales de cada jugador a las preguntas de una app de preguntas o encuesta. Para consultar cada respuesta, utiliza la exportación de datos de tu app, donde cada pregunta tiene su propia columna.


¿Quieres mostrar los resultados en directo en una pantalla grande, por ejemplo, durante un evento? Utiliza la clasificación de jugadores: tiene su propio enlace, se actualiza en tiempo real después de cada participación y se puede mostrar en una pantalla independiente.


Estructura de los datos de la API


Así puedes rellenar la columna Ejemplo de datos según los formatos habituales de estos tipos de campos:


Clave

Descripción

Ejemplo de datos

Id

Identificador único.

123456

appId

ID de la aplicación.

123456

appRef

Referencia interna de la aplicación.

my campaign

idunic

Datos recogidos en el campo de identificador único.

ABC123XYZ

gender

Datos recogidos en el campo de género.

Male / Female / Prefer not to say

username

Datos recogidos en el campo de nombre de usuario.

johndoe

firstName

Datos recogidos en el campo de nombre.

John

lastName

Datos recogidos en el campo de apellidos.

Doe

email

Datos recogidos en el campo de correo electrónico.

johndoe@example.com

dob

Datos recogidos en el campo de fecha de nacimiento.

1990-01-01T00:00:00+01:00

address

Datos recogidos en el campo de dirección.

123 Main St, Apt 4B

cp

Datos recogidos en el campo de código postal.

12345

town

Datos recogidos en el campo de ciudad.

New York

country

Datos recogidos en el campo de país.

United States

phoneNumber

Datos recogidos en el campo de número de teléfono.

+12025550199

companyName

Datos recogidos en el campo de nombre de la empresa.

Example Corp.

website

Datos recogidos en el campo de página web.

https://www.example.com

optinNewsletter

Datos recogidos en la casilla de consentimiento.

true / false

customText

Datos recogidos en el campo de texto personalizado.

Valor introducido por el participante

customFormat

Datos recogidos en el campo de formato personalizado.

Valor introducido por el participante

profil

Perfil obtenido en una app de test de personalidad, cuestionario o encuesta.

Explorer

profilUid

Identificador único del perfil obtenido en una app de test de personalidad, cuestionario o encuesta.

EXPL123

score

Puntuación del usuario en una app basada en puntos.

85

prizeUid

Identificador único del premio. Si no se ha ganado ningún premio, devuelve lost.

0f8e4a298ba5c036c7db5e5ef1ce422e85ceb5e3 / lost

prizeTitle

Título del premio registrado cuando el usuario gana un premio.

Gold Membership

prizeRef

Referencia del premio registrada cuando el usuario gana un premio.

GOLD2023

code

Código ganado por el usuario.

WIN12345

date

Marca de tiempo del servidor.

2024-11-10T19:09:32+01:00

publisherId

ID del editor.

PUB123

sessionId

ID de la sesión del usuario.

Session_296c9d74f159eacf374a2ac4e9d6f028

countryCode

Código del país según la dirección IP del usuario.

FR

selectValue

Datos recogidos en el menú desplegable personalizado.

Option A

selectValue2

Datos recogidos en el segundo menú desplegable personalizado.

Option B

customCheckbox

Datos recogidos en la lista personalizada de casillas de verificación. Si se seleccionan varias opciones, los valores se separan con una barra vertical (∣).

Option 1 ∣ Option 2

timeTaken

Tiempo que el usuario ha pasado en la app, en segundos.

360

levelsPlayed

Número total de niveles completados por el usuario en las experiencias Combo™, Recorrido Dinámico™ o Calendario De Adviento. Devuelve null para cualquier otro tipo de juego.

123456

referral

Fuente de procedencia del tráfico.

direct

updatedAt

Fecha de actualización de los datos.

2024-11-10T19:09:32+01:00

connectionCountry

País según la dirección IP del usuario.

France

updatedAtTimeStamp

Marca de tiempo de la actualización de los datos.

1731262172

dateWithTimezone

Marca de tiempo convertida a la zona horaria de la app.

2024-11-10T17:09:32+01:00

played

Indicador que devuelve true si el usuario ha jugado a la mecánica del juego y false en caso contrario.

true / false

locale

Idioma de la aplicación utilizado durante la experiencia del usuario.

en

ipAddress

Dirección IP del usuario.

192.168.1.1

Actualizado el: 19/10/2026

¿Este artículo te resultó útil?

Comparte tu opinión

Cancelar

¡Gracias!