Entrada basada en API
La entrada basada en API le permite lanzar un customer journey en el momento en que ocurre un evento de negocio específico. Para iniciar una campaña, debe enviar una solicitud de API especial.
Aquí hay algunos casos de uso para una entrada basada en API:
- Informar a los clientes cuando los productos vuelven a estar en stock
- Avisar a los usuarios que el precio de un producto popular ha bajado
- Notificar a los suscriptores cuando se publique un nuevo episodio de podcast
A diferencia de los Eventos regulares, todos estos eventos de negocio pueden ocurrir fuera de la aplicación. Por ejemplo, la disponibilidad de un producto solo se puede verificar en una base de datos externa. Aquí es donde una entrada basada en API es útil: puede configurar el envío de una solicitud para lanzar un journey cada vez que ocurran ciertos cambios fuera de la aplicación (por ejemplo, en su base de datos externa).
Funciona de la siguiente manera:
- Cree un journey con una entrada basada en API. En la configuración de la entrada, encontrará la plantilla de la solicitud que lanza el journey.
- Añada condiciones de segmentación a la solicitud utilizando el Lenguaje de segmentación. También puede añadir marcadores de posición de contenido a la solicitud para cambiar el contenido del mensaje según el contexto.
- Automatice la solicitud si es necesario. Por ejemplo, la información sobre un cambio de precio se puede enviar inmediatamente desde la base de datos al webhook. Una vez que esto sucede, el webhook debe enviar automáticamente la solicitud para lanzar el journey. También puede enviar la solicitud manualmente si no necesita automatización.
Puede enviar la solicitud un número ilimitado de veces para cambiar las condiciones de segmentación o el contenido del mensaje.
Para más detalles, siga las instrucciones a continuación.
Configurar un journey con entrada basada en API
Anchor link to- Cree un journey con una entrada basada en API:
-
Haga doble clic en el paso de entrada basada en API. Se abrirá la ventana de configuración de la entrada.
-
Puede modificar el contenido de los mensajes push y de los emails cada vez que se lance el journey utilizando marcadores de posición de contenido. El valor de cada marcador de posición se puede cambiar en la solicitud. Si no necesita esta opción, puede omitir este paso.
Por ejemplo, está creando un journey para notificar a los suscriptores cuando se lanza un nuevo episodio de podcast. Usando un marcador de posición de contenido, puede cambiar el título del podcast cada vez que lance el journey.
Primero, añada los nombres de los marcadores de posición en la ventana de configuración de la entrada basada en API. Puede usar cualquier nombre que le resulte conveniente.
Ahora, cree un preset de push o contenido de email e inserte el marcador de posición en lugar del texto que desea modificar. El marcador de posición debe estar en uno de los siguientes formatos según sus necesidades:
{placeholder_name|format_modifier|}– si el valor del marcador de posición no se especifica al lanzar la campaña, los usuarios verán un espacio vacío en su lugar.{placeholder_name|format_modifier}– si el valor del marcador de posición no se especifica y no ha sido asignado previamente a un usuario (en caso de que haya utilizado un Tag como marcador de posición), el mensaje no se enviará.
Modificadores de formato
- CapitalizeFirst – pone en mayúscula la primera letra del valor de un marcador de posición
- CapitalizeAllFirst – pone en mayúscula la primera letra de todas las palabras en el valor de un marcador de posición
- UPPERCASE – convierte todas las letras a mayúsculas
- lowercase – convierte todas las letras a minúsculas
- regular – inserta el valor de un marcador de posición exactamente como se especifica en la solicitud
Al configurar el elemento Push o Email en su journey, seleccione el preset creado y active la opción Personalizar mensaje con atributos de evento.
Seleccione los marcadores de posición que desea modificar en la solicitud al lanzar el journey. Elija la entrada de tipo API-based entry como fuente y el nombre del marcador de posición como atributo dinámico:
Haga clic en Aplicar para guardar los cambios.
- En la ventana de configuración de la entrada, copie la plantilla de la solicitud para modificarla:
- Añada filtros de audiencia al parámetro
"filter"utilizando el Lenguaje de segmentación o copie el lenguaje de segmentación de sus segmentos. Configure los Tags necesarios con antelación.
Por ejemplo, para dirigirse a los usuarios que añadieron el artículo Socks a su Wishlist, el valor de "filter" debe tener el siguiente aspecto:
"filter": "A(\"12345-12345\") * "T(\"Wishlist\", EQ, \"Socks\")"
En este ejemplo, debe tener un Tag Wishlist configurado en su aplicación.
- Si ha configurado marcadores de posición, especifique el contenido deseado como sus valores:
- Si planea reiniciar su campaña con frecuencia y no quiere que los mismos usuarios entren en el journey varias veces, establezca Límites de entrada a la campaña.
Por ejemplo, ha creado una campaña para notificar a los usuarios sobre una reducción de precio de un producto específico. Desea relanzar el journey varias veces enviando varias solicitudes con diferentes filtros de audiencia. En este caso, puede añadir límites de entrada a la campaña para que la notificación no se envíe repetidamente a los usuarios que coincidan con múltiples filtros.
- Si desea que un journey se lance cada vez que ocurra un determinado evento de negocio, automatice la solicitud utilizando el webhook. Una vez que ocurra el evento, el webhook deberá enviar automáticamente la solicitud para iniciar el journey.
También puede enviar la solicitud manualmente si no necesita automatización.