Easypromos permite pasar parámetros de la URL entrante a la promoción a propiedades del usuario participante. De esta forma el administrador de la promoción dispone de una funcionalidad que permite añadir campos identificativos a los usuarios participantes a partir de la URL de referencia con la que llegó a la promoción. 

Un ejemplo práctico:

Una marca envía una newsletter a sus suscriptores con el enlace a una encuesta. Todos los que rellenen la encuesta entrarán en el sorteo de un premio. En este caso, la marca incluirá en la newsletter el enlace a la encuesta con parámetros que permitirán obtener el nombre, apellidos y email del suscriptor. Cuando el usuario reciba la newsletter y haga clic en el enlace, el usuario completará la encuesta sin la necesidad de proporcionar su nombre y correo electrónico, ya que Easypromos leerá los parámetros de identificación de la URL y añadirá estos valores como una propiedad del usuario participante.

En este tutorial explicamos todos los pasos para pasar por URL los parámetros  de identificación única de los usuarios.

Nota: La funcionalidad de pasar parámetros por URL únicamente está disponible para promociones del tipo Marca Blanca.

Éstos son los contenidos del tutorial:

1. Cómo construir la URL con los parámetros de identificación de usuario

   • 1.1. Formato de los parámetros en la URL

   • 1.2. Cómo construir la URL de la promoción con los parámetros

2. Configuración avanzada: Pasar parámetros adicionales por URL

   • 2.1. Características del paso de parámetros personalizados por URL

   • 2.2. Cómo pasar parámetros adicionales a través por URL

3. ¿Puedo utilizar esta funcionalidad si la promoción está incrustada como Widget?

1. Cómo construir la URL con los parámetros de identificación de usuario

Puedes añadir los siguientes parámetros en la URL: dirección de email, nombre y apellidos del usuario.

Cuando el usuario acceda al registro de la promoción, si estos campos están presentes en el formulario, aparecerán prerellenados automáticamente. Si no están presentes en el formulario, el usuario se registrará igualmente y los valores de los parámetros en la URL se guardarán automáticamente.

En las siguientes tres secciones te explicamos:
1) el formato de los parámetros,
2) cómo construir la URL correctamente,
3) y cómo ocultar los campos de nombre, apellidos y email del formulario de registro.

Nota: Puedes enviar más parámetros a través de la URL. Esta funcionalidad avanzada se explica en la sección 2 del tutorial.

1.1. Formato de los parámetros en la URL

Para poder obtener los valores de Nombre, Apellidos y Email se deberán utilizar los siguientes parámetros:

• fn (First Name): Parámetro que puede llevar el nombre del participante.
• ln (Last Name): Parámetro que puede llevar el apellido del participante.
• em (Email): Parámetro que puede llevar el email del participante.

Estos parámetros se deben añadir a la URL de la promoción, de forma que si la plataforma detecta estos parámetros, guardará los valores en una cookie durante la sesión del participante en la promoción, y al terminar el registro a la promoción, se guardarán como el nombre, apellido e email del usuario.

No es necesario utilizar los 3 parámetros, se pueden utilizar, los 3, 2 o únicamente 1, en función de los datos que se quieran obtener.

Nota: En caso que el formulario de registro esté habilitado, los campos de Nombre, Apellidos e Email vendrían pre-rellenados con estos valores.

1.2. Cómo construir la URL de la promoción con los parámetros

Para poder obtener los valores de Nombre, Apellidos e Email a través de la URL de la promoción, el administrador deberá añadir los parámetros fn, ln y em a la URL, utilizando el formato que mostramos a continuación:

https://a.cstmapp.com/p/996721?fn=USER_FIRST_NAME&ln=USER_LAST_NAME&em=USER_EMAIL

Por ejemplo:

https://a.cstmapp.com/p/996721?fn=Mary&ln=Smith&em=marysmith@email.com

De esta forma, cuando la usuaria May Smith reciba la newsletter y haga clic en el enlace a la encuesta, verá esta URL en su navegador:

Y, al llegar a la página del Formulario de registro, en caso que los campos Nombre, Apellidos y Email estén habilitados, éstos vendrán pre-rellenados con los valores de la usuaria:

Nota: El nombre de la etiqueta de cada campo que se quiera pasar a través de la URL varía en función del gestor de correo que se utilizará para el envío de la newsletter. Por lo tanto, el administrador de la promoción deberá consultar con su equipo sobre el formato de las etiquetas que utiliza su gestor de correo. 

Ejemplo: En el caso de utilizar Mailchimp, es necesario escribir el nombre de la etiqueta con el siguiente formato:

https://a.cstmapp.com/p/996721/?fn=*|FNAME|*&ln=*|LNAME|*&em=*|EMAIL|*

2. Configuración avanzada: Pasar parámetros adicionales a la URL

Adicionalmente, el administrador puede pasar parámetros personalizados a la URL, para así obtener valores adicionales a través de la URL de la promoción, que quedarán también reflejados en la ficha de cada usuario registrado. 

2.1. Características del paso de parámetros personalizados por URL

1. Puedes añadir tantos parámetros como desees por URL. Cada parámetro será una nueva propiedad del usuario participante.
2. Los parámetros pueden ser de uso único. Quiere decir, que si se habilita esta opción, el sistema controlará que no haya ningún otro participante con este valor registrado previamente.
3. Se pueden añadir reglas de validación en los parámetros. Únicamente podrán participar, participantes con valores en los parámetros en la URL que cumplan estas reglas de validación.
4. Los parámetros pueden ser opcionales.
5. Las propiedades de usuario por paso de parámetro se pueden usar como filtro de participantes en el panel de control de la promoción. Ej: buscar participante con referencia externa XXX, o filtrar todos los usuarios con valor de parámetro YYY.
6. Las propiedades de usuario por paso de parámetro se pueden utilizar para añadir participaciones adicionales. Ejemplo: Dar participaciones adicionales a todos los usuarios que tengan el parámetro VIP igual 1.
7. Las propiedades de usuario por paso de parámetro está disponibles en los ficheros de exportación a CSV y en la exportación de participantes por REST API

2.2. Cómo pasar parámetros adicionales a través por URL

Para poder pasar parámetros adicionales a través de la URL de la promoción se deberán utilizar los "Campos ocultos por parámetro URL", que se deberá añadir al formulario de registro de la promoción. De esta forma, se deberá crear un nuevo campo oculto por cada parámetro adicional que el administrador de la promoción quiera pasar a través de la URL.

Para ello, se deberán seguir los pasos que describimos a continuación:

1. Ve a Editor > Login y registro > Registro > Campos.

2. Añade un nuevo campo del tipo "Campo oculto por parámetro URL":

3. Configura las siguientes opciones del campo:

• Título corto: El nombre de la propiedad. Así es como mostraremos la propiedad de usuario en tu panel de gestión de usuarios.
• Nombre del parámetro: Es el nombre exacto del parámetro GET que pasarás por URL. Easypromos revisará que haya un parámetro en la URL entrante de la promoción con exactamente este nombre.
• Validación: Habilítala si quieres que los valores de este parámetro sean de un solo uso o bien si quieres poner reglas de validación con expresión regular sobre los valores del parámetro.
• Campo obligatorio: Habilítalo si quieres que este parámetro siempre sea obligatorio en el registro de usuarios.

Ejemplo

En este ejemplo, la marca quiere registrar participantes con el ID de miembro de su comunidad, y quiere registrar también si el usuario es VIP, porque los usuarios VIP tendrá una participación adicional en el sorteo.

Para ello la marca ha creado un sorteo, y ha creado dos campos ocultos por parámetro URL que son:

• member_id
• vip

El campo Member ID permite pasar el parámetro member_ID, que deberá ser un valor numérico de 6 cifras y además deberá ser un valor de un solo uso, para que únicamente pueda registrarse un único participante con este valor. Por otro lado, el campo Member VIP permitirá pasar el parámetro member_vip, que podrá tener dos valores: "0" para miembros no VIP y "1" para miembros VIP. 

Si la URL de la promoción es: https://a.cstmapp.com/p/33129, la marca deberá pasarle el siguiente enlace al miembro 789001, que además es miembro VIP:

https://a.cstmapp.com/p/33129?member_ID=789001&vip_member=1

De esta forma, al hacer clic el usuario verá ambos parámetros en la URL:

Nota: este enlace con parámetros dinámicos lo debe programar la marca desde su sistema de acuerdo con los parámetros de los campos creados en el formulario de registro.

Si el usuario se registra, la marca verá en su panel de control: 

Adicionalmente podrá aplicar filtros para saber cuáles son todos los miembros VIP que se han registrado, y aplicar acciones masivas al segmento de usuarios filtrado:

3. ¿Puedo utilizar esta funcionalidad si la promoción está incrustada como Widget?

Sí, es posible utilizar esta funcionalidad en promociones que se han incrustado en una web, etc. con el widget de la promoción, el widget pop-up o el widget link. Funciona igual que sin widget. En el código del widget, hay el atributo "src", que es donde se indica la url que carga el widget. Se deberán añadir los parámetros a esta URL dentro del código del widget.