Entrada basada en API
Cómo funciona
Anchor link toLa 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.
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 Events 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 iniciar 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 inicia el journey.
- Añada condiciones de segmentación a la solicitud usando 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 dependiendo del contexto.
- Automatice la solicitud si es necesario. Por ejemplo, la información sobre un cambio de precio puede enviarse inmediatamente desde la base de datos al webhook. Una vez que esto suceda, 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.
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 push y los emails 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 lance 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, 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 un 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 dependiendo de 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 ha sido asignado previamente a un usuario (en caso de que haya usado 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 las primeras letras 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 iniciar el journey. Elija la 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.
- 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"usando 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 ser el siguiente:
"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. Quiere 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 quiere 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.