Foursquare
Foursquare es una plataforma de datos de ubicación que proporciona segmentación por datos de ubicación en tus Campaigns de Braze. Utiliza el SDK Pilgrim de Foursquare en aplicaciones iOS y Android para desencadenar eventos en tiempo real basados en la ubicación, lo que te permitirá aprovechar las potentes capacidades de geosegmentación de Foursquare para enviar mensajes relevantes y personalizados con Braze.
Esta integración está mantenida por Foursquare.
Requisitos previos
| Requisito | Descripción |
|---|---|
| Cuenta de Foursquare | Se requiere una cuenta de Foursquare para aprovechar esta integración. |
| Clave de API REST de Braze | Una clave de API REST de Braze con permisos de users.track. Se puede crear en el panel de Braze desde Configuración > Claves de API. |
| Espacio de trabajo e ID de aplicación de Braze | El espacio de trabajo y los ID de aplicación de Braze se pueden encontrar en la consola para desarrolladores. |
Integración
Para integrar las dos plataformas, debes integrar los dos SDK y mapear los campos de usuario coincidentes. Después de integrar el SDK de Pilgrim, recibirás eventos de ubicación en el dispositivo o a través de un webhook.
Paso 1: Mapear los campos de ID de usuario
Para mapear correctamente los campos entre los dos SDK, establece el mismo ID de usuario en ambos sistemas utilizando el método changeUser en el SDK de Braze y el método setUserId de PilgrimUserInfo en el SDK de Pilgrim.
Paso 2: Configurar la consola de Pilgrim
Busca el espacio de trabajo y los ID de la aplicación en la consola para desarrolladores de Braze. A continuación, introduce tu clave de API REST de Braze y los ID de la aplicación en la consola de Foursquare Pilgrim.
Una vez que hayas configurado la consola de Pilgrim, el SDK de Pilgrim registrará los eventos de ubicación y los reenviará a Braze, lo que te permitirá reorientar y segmentar a los clientes cualificados. Consulta el sitio para desarrolladores de Foursquare para obtener más detalles.
El SDK de Pilgrim requiere que habilites los servicios de ubicación.
Desencadenar mensajes
Una vez configurada la integración, puedes configurar una Campaign o Canvas que responda a los eventos de ubicación generados por el SDK de Pilgrim. Esta ruta de integración es ideal para mensajería en tiempo real justo después de que los usuarios entren en un lugar de interés, o para comunicaciones de seguimiento diferidas después de que se hayan ido, como una nota de agradecimiento o un recordatorio.
Para enviar una Campaign que enviará mensajes basados en una ubicación establecida:
- Crea una Campaign o Canvas de Braze que se envíe con entrega basada en acciones
- Para tu desencadenador, usa un evento personalizado de
arrivalcon un filtro de propiedad de evento paralocationTypecomo se muestra en la siguiente captura de pantalla.
Reorientación
Para reorientar a tus usuarios, utiliza el SDK de Pilgrim para establecer un atributo personalizado last_location en los perfiles de usuario de tus usuarios de Braze. A continuación, puedes usar la comparación matches regex para reorientar a los usuarios que visitaron un lugar concreto en el mundo real, por ejemplo, segmentando a todos los usuarios que estuvieron recientemente en una pizzería.
También puedes segmentar a los usuarios en Braze que visitaron un tipo particular de establecimiento basándote en el primaryCategoryId de Foursquare dentro de una ventana de tiempo determinada. Para aprovechar este punto de datos en tus ejemplos de reorientación, registra primaryCategoryId como una propiedad de evento durante tu proceso de segmentación de audiencia. Para identificar los usuarios y las propiedades utilizados por la API de Foursquare y el SDK de Pilgrim, consulta el sitio para desarrolladores de Foursquare.