¿Cómo acelerar un programa de recomendación con Voucherify, Segment, Braze y Branch?
Publicado: 2022-04-18Han pasado varias semanas desde Braze Forge, una excelente conferencia organizada por uno de los líderes de la industria de CRM. Presentó cómo Braze planea ampliar la frontera de la tecnología de marketing en tiempo real en los próximos años, pero, lo que es más interesante, la conferencia mostró cómo hoy en día los usuarios avanzados de MarTech ganan el mercado. Uno de ellos es Pomelo Fashion, quien ganó el premio Braze de Tech Partner Use Case . En este artículo, presentamos cómo puede copiar su configuración de personalización de CRM (Braze, Segment, Branch, Voucherify) para crear sus campañas de referencia en días.
{{CLIENTE}}
{{CLIENTE FINAL}}
Reglas del programa de recomendación
Pomelo creó una experiencia de mensajería altamente personalizada al:
- Transmisión de datos de usuario a Segment.
- Creación de mensajes de referencia relevantes en Braze.
- Uso de enlaces profundos de Branch para garantizar que los usuarios lleguen a la página de la aplicación y a la tienda de aplicaciones.
- Aprovechando Voucherify para entregar mensajes personalizados y administrar los códigos de referencia.

Pomelo usó un programa de referencia de dos caras que recompensaba tanto al defensor como a sus amigos. Cuando se trata de la lógica promocional, se deben cumplir varios requisitos para garantizar que la campaña impulse la adquisición de clientes:
- Friend no es un cliente existente de Pomelo.
- Un amigo usa el código de promotor para hacer su primera compra de Pomelo.
- Un amigo obtiene un descuento de 200 THB en su compra.
- Advocate recibe un cupón de 200 THB enviado a su cuenta CADA VEZ que un nuevo amigo se convierte en cliente.
- Las referencias de amigos deberían funcionar tanto en la web como en los canales móviles.
Pero la verdadera dificultad tenía que ver con la escala de Pomelo. Como líder de la industria, Pomelo atiende a millones de clientes en una docena de países diferentes. El verdadero desafío era lanzar y, lo que es más importante, mantener la agilidad de marketing de la campaña de recomendación en todos los mercados y equipos.
Bloques de construcción basados en API de la campaña de referencia
Pomelo cree que con la tecnología y la estrategia de marketing adecuadas, es posible hacer que la personalización se produzca de manera receptiva y a gran escala.
Dado que la personalización hoy en día significa analizar grandes volúmenes de datos de clientes y sincronizarlos en sistemas y bases de datos dispersos, Pomelo se ha convertido en un usuario avanzado de las primeras plataformas API.
Así es como los conectaron para lograr:
- Tiempo de comercialización más rápido.
- Flexibilidad de personalización.
- Manejo de picos de tráfico.
Ahora, ensuciémonos las manos recreando esta configuración. Antes de continuar, asegúrese de tener estos proporcionados:
- Cuentas Voucherify, Braze, Branch y Segment (necesitamos las claves API).
- Postman (o cualquier otra herramienta que le permita enviar y recibir solicitudes HTTP). Lo usaremos para simular una aplicación y un backend intercambiando mensajes.
Nota: Siga estos enlaces para encontrar la documentación de la API de Voucherify , Segment , Braze y Branch .
Nota: si desea repasar Postman y las plataformas API operativas en general, puede visitar nuestro artículo introductorio .
Nota: aquí puede encontrar la colección Postman de las solicitudes que usamos en este tutorial.
Paso 1: rellene los usuarios en todas las plataformas (segmento)
Antes de saltar al diseño de la lógica de referencia, debemos asegurarnos de que los conceptos básicos estén en su lugar. Lo primero en la lista es la integridad de los datos del cliente : nos aseguraremos de que un cliente se identifique correctamente en cada plataforma.
Imaginemos un nuevo usuario registrándose en nuestra tienda. Necesitamos completar esta información en Braze, Branch y Voucherify para que los datos del cliente sean procesables. Esa es una tarea perfecta para Segment. Proporciona una abstracción coherente para identificar clientes, rastrear su comportamiento en varios puntos de contacto y distribuir estos datos a los sistemas relevantes.
Nos vamos al segmento. Crearemos la primera conexión. La conexión recibirá datos de una aplicación o de su backend (fuente) y los enviará a Braze y Voucherify (destinos).
Vaya a Fuentes , agregue una nueva fuente y elija la opción HTTP API. Esto le permite enviar solicitudes HTTP a los servidores de Segment desde Postman. Asigne un nombre a la fuente y, opcionalmente, agregue etiquetas para filtrar las fuentes en el futuro.

Probemos la conexión. Haga clic en la fuente y copie su clave de escritura.

Ahora, abra Postman y cree una nueva solicitud de API.
- Cambie el método a POST .
- Establezca la URL en https://api.segment.io/v1/identify.
- En la pestaña Autorización, seleccione Autenticación básica como TIPO y proporcione su clave API de segmento como Nombre de usuario.
- Vaya a Cuerpo, seleccione Raw y JSON. Coloque el siguiente fragmento en el cuerpo:
{{CÓDIGO}}
{
"ID de usuario": "[email protected]",
"rasgos": {
"correo electrónico": "[email protected]",
"nombre": "Jim Halpert"
}
}
{{ENDCODE}}
Para simplificar, usamos correos electrónicos como identificadores de clientes y alias de correo electrónico para probar los mensajes.


Los datos de clientes anteriores sirven como ejemplo. Para probar la conexión de la API de segmento, debe proporcionar el ID de usuario, la dirección de correo electrónico y el nombre del cliente.
Ahora ENVÍA la solicitud. Cuando vea "success": true , abra Debugger en Segment. Debería ver una confirmación de que su fuente ha recibido datos de Postman.

Ahora que tenemos la fuente escuchando las solicitudes, pasemoslas a Braze y Voucherify.
Agregar Voucherify como Destino
- Vaya a Destinos y haga clic en Agregar destino.
- Seleccione Voucherify del Catálogo y configure la integración.
- Obtenga sus claves API y péguelas en Segment. Puede encontrar sus claves en la configuración del proyecto en el panel de control de Voucherify. Asegúrese de que la URL de la API se corresponda con su configuración de Voucherify.
- El ID de aplicación de Voucherify sirve como clave de API del segmento. La clave secreta de Voucherify es el token API del segmento.

A continuación, encienda su destino y vaya a Event Tester . Seleccione Identificar como tipo de evento y Enviar evento. En el lado derecho, debería ver la confirmación de que Voucherify ha creado un usuario de prueba. Del mismo modo, cuando vaya a Clientes en el panel de control de Voucherify, debería ver el usuario de prueba recién creado.

Agregar Braze como destino
Agregar el destino de Braze es bastante similar, así es como se vería la configuración (asegúrese de que su clave REST API tenga permisos de datos de usuario). Encontrará los datos que necesita en la Configuración de la aplicación en Braze.

Ahora, la tarea final en este paso es activar todo el flujo de trabajo. Asegúrese de que ambos destinos estén activados, vuelva a Postman y presione ENVIAR una vez más. Segment recibirá la solicitud y la traducirá de manera que Voucherify y Braze la puedan digerir. Como resultado, Jim Halpert debería estar visible en ambas plataformas.

Paso 2: generar códigos de referencia (Voucherify)
Ahora que tenemos a nuestros clientes sincronizados, invitémoslos a unirse al programa de referencia. Comenzaremos con la generación de códigos de referencia con Voucherify. Comience proporcionando detalles generales de su programa de referencia.
- Cree una nueva campaña de Códigos de recomendación.
- Defina el nombre y el patrón de código para nuestro programa (es posible que desee dar un prefijo y eliminar los caracteres engañosos como O, 5, I de los códigos de referencia).
- Imponga algunos límites de tiempo, son opcionales pero generalmente de gran importancia para el éxito de una campaña.

La tercera etapa es fundamental. Aquí, necesitamos diseñar en qué condiciones Voucherify debería recompensar a las personas. En nuestro caso, queremos dar 200 THB tanto al promotor como al nuevo cliente, por lo que elegimos una recompensa de doble cara .
Ahora al evento de conversión. De forma predeterminada, Voucherify premia a los defensores cuando se canjea su código de referencia. A veces, sin embargo, esto no es suficiente para dar cuenta de una referencia exitosa. Es posible que desee esperar el envío o el período de devolución del evento. Es por eso que Voucherify le permite definir un evento personalizado para este propósito (siempre que Voucherify reciba dicho evento a través de la API, se cuenta la referencia válida).

Sabemos cuándo se premia a un cliente, pero todavía nos falta la recompensa real. Continúe con la siguiente pantalla para configurarlo. Primero, definimos cómo premiamos a los amigos referidos; en nuestro caso, es un cupón de descuento por valor de 200 THB.

En este punto, deberíamos pensar en algunas reglas básicas del programa. Primero, un amigo debe ser referido solo una vez. En segundo lugar, podríamos querer aumentar el gasto con un valor de carrito mínimo para el primer pedido del cliente referido. Finalmente, podemos excluir a los clientes del programa en función de cualquier atributo, como la ubicación o el método de pago. El generador de reglas de validación de Voucherify lo ayudará a lograrlo con un editor simple.
Saltémonos los pasos de Notificaciones y Recompensa de referencia (volveremos a ellos en un minuto) y guardemos la campaña. De esta forma, Voucherify estará listo para generar códigos de referencia.
Paso 3: asigne códigos de referencia a los perfiles de usuario (Braze)
Es hora de invitar a los clientes al programa de recomendación. Primero, llamemos al segmento de identificación nuevamente para tener al menos dos usuarios. Aquí hay una llamada a la API de ejemplo:
{{CÓDIGO}}
{
"ID de usuario": "[email protected]",
"rasgos": {
"correo electrónico": "[email protected]",
"nombre": "Michael Scott"
}
}
{{ENDCODE}}
A continuación, creemos una campaña de Braze que llame a Voucherify para obtener un código de referencia único y lo asigne a cada nuevo usuario. Para ello, utilizaremos Contenido conectado.
- Cree una nueva campaña de correo electrónico.
- Seleccione su plantilla y cree una copia de correo electrónico.
- Cambie al editor de HTML y pegue el siguiente fragmento en algún lugar dentro de la etiqueta <body> (preferiblemente entre las etiquetas <table>), sustituyendo las credenciales de la API y el identificador de la campaña de referencia (obténgalo de la URL en el panel de control de Voucherify).
{{CÓDIGO}}
{% asignar id_campaña = {{campaña.${api_id}}} %}
{% asignar ID_cliente = {{${id_usuario}}} %}
{% asignar id_fuente = id_campaña | agregar: id_cliente %}
{% contenido_conectado https://api.voucherify.io/v1/publications
:publicación de método
:headers { "X-App-Id": "TU ID DE APLICACIÓN", "X-App-Token": "TU SECRETO DE APLICACIÓN" }
:bodycampaña=campamento_YOUR_CAMPAIGN_ID&customer={{${user_id}}}&channel=Braze&source_id={{source_id}}
:aplicación tipo_contenido/json
:guardar publicación %}
{{ENDCODE}}
- En el editor de HTML, coloca {{publication.voucher.code}} donde quieras mostrar el código.
- Configure otros parámetros de la campaña y guárdelo.

Hemos utilizado entrega programada con envío inmediato. Sin embargo, puede activar el envío de correo electrónico en función de múltiples eventos y atributos.
Una vez que se lanza la campaña, sucede lo siguiente:
- Voucherify genera un nuevo código de referencia único de acuerdo con el patrón que definimos.
- Voucherify lo publica para un usuario cuya identificación se envía con una llamada a la API de contenido conectado. (Una vez publicado, no se volverá a utilizar para otro usuario).
- Voucherify envía el nuevo código a Braze como respuesta a la llamada a la API.
- Braze coloca el código en el lugar correcto y envía el correo electrónico.
Si todo funcionó según lo planeado, deberíamos recibir correos electrónicos y códigos de referencia únicos asignados a Jim y Michael en sus perfiles de Voucherify.


Paso adicional: cargue códigos a los perfiles de usuario en Braze
Gracias a Connected Content, Braze pudo enviar el código de referencia asignado en un mensaje. Sin embargo, no se conservará en el perfil de usuario de Braze. Es posible que desee cargarlo para tenerlo al alcance de la mano para una mayor participación en la campaña.

Para lograr esto, puede configurar la campaña de referencia para enviar los códigos de referencia correspondientes a través del atributo personalizado.
- Editemos nuestra campaña de referidos en Voucherify.
- Vaya a Notificaciones y seleccione Enviar código de referencia al remitente.
- Desplácese hacia abajo y seleccione Braze como canal. (Necesitará una clave API de Braze con el permiso users.track habilitado).
- Proporcione el nombre del atributo personalizado que almacenará el código de referencia.

Guarda la campaña. De ahora en adelante, cada nueva llamada conectada completará el atributo de código de referencia de un usuario en Braze.

Paso 4: cree niveles para los referentes (Voucherify)
Terminemos la configuración actual. Gracias a Segment, cada nuevo usuario se sincroniza con Voucherify y Braze. Luego, la campaña Braze activa recupera un código de referencia único de Voucherify y lo envía por correo electrónico al nuevo usuario. El código es administrado por Voucherify, está vinculado con el usuario y el motor de promociones lo trata como un cupón de descuento de 200 THB por cada nuevo cliente referido. Puede validar el código de referencia para confirmar esto.
Cree una nueva solicitud de Postman y llame al punto final de validación desde la API de Voucherify.
- Seleccione el método POST y coloque la siguiente URL https://api.voucherify.io/v1/vouchers/{CODE}/validate reemplazando CODE con su código de referencia.
- Agregue los encabezados X-App-Id y X-App-Token y rellénelos con el ID de la aplicación y la clave secreta, respectivamente.
- Establezca el encabezado Content-Type en application/json.
- Configure el siguiente cuerpo para simular un amigo que intenta canjear el código de referencia y ENVIAR.
{{CÓDIGO}}
{
"cliente" : {
"source_id": "[email protected]"
}
}
{{ENDCODE}}
Voucherify debe responder con la información sobre el código de referencia.

Sin embargo, lo que todavía nos falta es algo que mueva la aguja: un incentivo real para los defensores. Démosles 200 THB por cada amigo recomendado.
- Edite su campaña de referencia y vaya a Recompensas de referencia.
- Cree el primer y único nivel que premia al referente cada vez que se produce un evento de referencia. Puede crear muchos más para emplear algún tema de gamificación. Además de la cantidad de referencias exitosas, puede agregar más reglas de validación, como la ubicación o el presupuesto, por nombrar algunos ejemplos.

Ve a Recompensas y CREA NUEVA RECOMPENSA. Nuestro plan es dar un cupón de 200 THB por cada recomendación. Asigne un nombre a su recompensa para ayudarlo a hacer referencia a ella en los informes (algo así como "200 THB de descuento") y haga clic en CREAR NUEVA CAMPAÑA. Aquí seleccione Cupones de tipo de cantidad de valor de 200 THB y AHORRE. Ahora AGREGAR RECOMPENSA para asignar recompensa a su campaña de referencia.

El último paso es notificar a un defensor sobre la recompensa. Para hacerlo, enviaremos un código de cupón de recompensa a los perfiles de promotores en Braze. Habilite el canal Braze y defina cómo Voucherify debe nombrar los atributos personalizados relacionados con la recompensa

Guarde la campaña y la parte de Voucherify está lista. Ya es hora de que probemos lo que hemos construido hasta ahora de principio a fin. Simularemos el escenario de Jim refiriendo el servicio a su querido amigo: Dwight. En efecto:
- Dwight obtiene un descuento de 200 THB en su primer pedido.
- Jim obtiene una recompensa de cupón de 200 THB.
- Dwight recibe una invitación al programa de referencia con un código de referencia único.
Cambie a Postman y siga estos pasos:
Dwight instala la aplicación y crea una cuenta; el backend detecta un nuevo registro; llame a la solicitud de identificación de segmento con el cuerpo a continuación para notificar a Braze y Voucherify sobre un nuevo registro. Vaya a los paneles en Voucherify y Braze para ver si los datos de Dwight se completaron correctamente.
{{CÓDIGO}}
{
"ID de usuario": "[email protected]",
"rasgos": {
"correo electrónico": "[email protected]",
"nombre": "Dwight Schrute"
}
}
{{ENDCODE}}
Dwight usa el código de referencia en la caja: el motor de comercio electrónico debe aplicar el código al carrito. Llame a Voucherify Redemption para validar el código de referencia y calcular el precio del pedido con descuento.
{{CÓDIGO}}
{
"cliente" : {
"source_id": "[email protected]"
},
"pedido": {
"cantidad": 80000 // cantidad multiplicada por 100 para manejar decimales
}
}
{{ENDCODE}}

Dwight recibe su primer pedido en la granja: el backend escucha el estado del envío y notifica a las plataformas de CRM sobre las actualizaciones; llame a Segment Track Referral para notificar que se debe contar una referencia exitosa.
{{CÓDIGO}}
{
"ID de usuario":"[email protected]",
"evento":"referencia",
"remisión":{
"código":"torchie-MYRATKCP"
}
}
{{ENDCODE}}
Cuando miramos el panel del programa de referencia, deberíamos ver dos cosas:
- El código de referencia de Jim ya se usó una vez (por Dwight).
- Un código recién generado para Dwight.

Cuando visita el perfil de Jim en Braze, puede ver que recibió su primer cupón de recompensa por recomendación.

Cuando vuelva a invitar a nuevos usuarios al programa de recomendación, Voucherify generará el código de recomendación de Dwight a través de Contenido conectado y lo enviará a su perfil en Braze.
El último paso es notificar a Jim sobre la recompensa. La forma más fácil de lograrlo es crear una campaña basada en acciones que use el activador Cambiar valor de atributo personalizado . Por lo tanto, siempre que el código_cupón_de_recompensa cambie su valor con notificaciones de recompensa sucesivas de Voucherify, Braze envía un mensaje con el código de cupón de recompensa.
En un entorno de producción, puede y debe integrar perfiles de clientes en la aplicación con Voucherify para mostrar su billetera promocional completa, incluido el código de referencia, las estadísticas y, sobre todo, las recompensas. Para la versión web, puede usar cabinas preconstruidas de Voucherify.

Paso de bonificación: agregue más niveles (Voucherify)
Si la campaña funciona demasiado bien, puede agregar fácilmente más niveles para gamificar el frenesí de referencias y proteger su presupuesto. Por ejemplo, es posible que desee enviar una recompensa por un cliente referido y luego otra, pero solo si un promotor gana al menos cinco clientes referidos, es decir, dos recompensas en total, independientemente de la cantidad de referencias exitosas. Para aplicar esto a su programa, simplemente edite su campaña, vaya a la sección de niveles y:
- Edite el nivel original, de modo que el número de Clientes recomendados sea superior a 0.
- Cree otro nivel y establezca la condición en Clientes recomendados es más de 5.

Paso 5: incorporación con enlaces profundos (sucursal)
El rompecabezas que falta es cómo podemos atribuir las instalaciones de la aplicación a nuestra campaña de referencia y cómo enviar a los usuarios recién registrados el acuerdo de referencia. Con nuestra configuración actual, el promotor tiene que enviar un código de referencia a sus amigos. Luego, deben guardarlo de alguna manera para pegarlo durante la etapa de pago. ¿Qué pasaría si pudiéramos modificar el enlace de referencia de manera que permita que la tienda de aplicaciones aplique el código automáticamente?
Para lograr este objetivo, necesitamos enlaces profundos. Muchos de ustedes ya usan una de las plataformas de enlaces profundos, pueden usarla aquí para mantener la integridad. En nuestro caso, iremos con Branch.
Si bien la integración de Braze x Branch tiene algunos beneficios avanzados para los enlaces profundos de marca, esto está más allá del alcance de este tutorial. Vamos a utilizar enlaces largos para mostrar lo sencillo que es atribuir instalaciones a nuestra campaña de referencia y cómo dirigir a los nuevos usuarios a una vista específica.
Cuando un nuevo usuario hace clic en nuestro enlace profundo, Branch lo redirigirá a un lugar correspondiente, ya sea App Store, Google Store o una página web. Luego, cuando se instala la aplicación, los parámetros que pasamos con la URL serán leídos por el SDK de Branch en la aplicación móvil. De esta manera, la aplicación podrá reconocer el código de referencia y almacenarlo en el perfil del usuario. Así es como se construye nuestro enlace profundo:
<dominio> + <parámetro de campaña para seguimiento> + <código de referencia único> + <otros parámetros>
Implementémoslo con Branch:
- Abre el panel de control de tu sucursal y ve a Configuración.
- Proporcione los enlaces a las tiendas y un enlace alternativo para la vista web. (Como no usamos aplicaciones reales en este ejemplo, omitimos los enlaces almacenados).

Desplácese hacia abajo hasta Vincular dominio y configure su dominio. (Nuevamente, por simplicidad usamos los predeterminados).

Abra Postman, cree una nueva solicitud GET y escriba el siguiente enlace largo:
g9xol.test-app.link/?~campaign=referral&code=torchie-MYRATKCP&$fallback=https%3A%2F%2Fshowcase.voucherify.io
Antes de hacer clic en ENVIAR, analicemos cada parte de nuestro enlace largo:
- g9xol.test-app.link : nuestro dominio de sucursal (puede configurar uno personalizado para una mejor marca).
- ~campaign=referral — decirle a Branch cómo atribuir el clic.
- code=torchie-MYRATKCP — Código de referencia de Jim.
- $fallback=https%3A%2F%2Fshowcase.voucherify.io : (opcional) le dice a Branch dónde redirigir al usuario después de hacer clic en el modo alternativo (configuramos el modo principal en el panel de control de Branch).
Ahora, cuando presiona ENVIAR, simulando que un usuario hace clic en el enlace, la solicitud va a Branch, que redirigirá al usuario al lugar correcto.

Cuando abra Fuente y compare por campaña, verá que el clic se atribuyó correctamente a nuestra campaña de referencia.

Ahora, regrese a la campaña de invitación de recomendación de Braze y agregue nuestro enlace al mensaje. En la URL, recuerde reemplazar el código de Jim con {{publication.voucher.code}} para asegurarse de que cada registro obtenga su propio código único.
Paso 6: inicie, rastree y mantenga su campaña de referencia
En estos cinco pasos, hemos creado una POC completa del programa de recomendación . Gracias a las poderosas herramientas de mar-tech, pudimos generar una campaña de referencia altamente específica en horas. El enfoque de API primero nos permitió subcontratar la parte de backend sin dejar de tener flexibilidad sobre la mecánica del cálculo de referencia. Lo que es más importante, con la colaboración entre Braze, Segment, Branch y Voucherify, puede disfrutar de experiencias 100 % personalizadas en la marca con puntos de contacto de clientes web y de aplicaciones.
¿La mejor parte? Se requieren menores esfuerzos de desarrollo. Tanto de la parte de implantación como de mantenimiento. Con Voucherify, puede cambiar las condiciones del programa de referencia por su cuenta. Piense en realizar pruebas A/B con referencias limitadas por promotor o referencias en total, agregando un valor mínimo gastado al pedido del amigo o excluyendo clientes específicos o segmentos completos del programa.
El paso final es definir los requisitos para sus desarrolladores. En aproximadamente un día, deberían poder traducir nuestras solicitudes de Postman al código de producción (consulte los SDK oficiales). El lanzamiento inicial puede requerir la sincronización de algunos clientes masivos y, dependiendo de su tráfico, debe considerar las políticas de limitación de velocidad de las plataformas; aquí es donde la documentación oficial de la API resulta útil.
Con Voucherify y su pila mar-tech puede lanzar muchos más incentivos personalizados. Visite nuestros documentos para saber qué novedades vienen con nuestra API, obtener nuestra colección Postman y ¡feliz piratería!
{{CTA}}
Inicie programas de referencia galardonados con Voucherify
Empezar
{{ENDCTA}}
