Activar Customer Journeys mediante una entrada basada en API
La entrada basada en API le permite iniciar 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.
Configuración
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 pushes y los correos electrónicos cada vez que se inicie 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 publique un nuevo episodio de podcast. Usando un marcador de posición de contenido, puede cambiar el título del podcast cada vez que inicie el Journey.
Primero, agregue 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 correo electrónico 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 iniciar 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 se ha asignado previamente a un usuario (en caso de que haya utilizado una etiqueta 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 las primeras letras de todas las palabras en el valor de un marcador de posición si el valor consta de más de una palabra;
- UPPERCASE – cambia todas las letras a mayúsculas;
- lowercase – cambia todas las letras a minúsculas;
- regular – inserta el valor de un marcador de posición exactamente como se especifica en la solicitud, sin modificaciones.
Al configurar el paso de Push o Correo electrónico 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 iniciar el Journey. Elija una Entrada basada en API como origen y el nombre del marcador de posición como atributo dinámico:
Haga clic en Aplicar para guardar los cambios.
4. En la ventana de configuración de la entrada, copie la plantilla de solicitud para modificarla:
- Agregue filtros de audiencia al parámetro “filter” usando el lenguaje de segmentación. Tenga en cuenta que necesita configurar las etiquetas necesarias con antelación.
Por ejemplo, si desea dirigir el Journey a los usuarios que agregaron 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 una etiqueta Wishlist configurada en su aplicación.
- Si ha configurado marcadores de posición, especifique el contenido deseado como sus valores:
- Si la opción Límites de tasa de mensajes está habilitada, se limitará el número de usuarios que ingresan al Journey a la vez cada segundo. Puede usar el valor predeterminado de 5000 usuarios por segundo o establecer otro número.
- Si planea reiniciar su campaña con frecuencia y no quiere que los mismos usuarios entren en el Journey varias veces, establezca el Límite de frecuencia.
Por ejemplo, ha creado una campaña para notificar a los usuarios sobre una reducción de precio para un producto específico. Desea volver a lanzar el Journey varias veces enviando varias solicitudes con diferentes filtros de audiencia. En este caso, puede agregar un Límite de frecuencia 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 inicie cada vez que ocurra un determinado evento de negocio, automatice la solicitud utilizando el webhook. Una vez que ocurra el evento, el webhook debería enviar automáticamente la solicitud para iniciar el Journey.
También puede enviar la solicitud manualmente si no necesita automatización.