Radar
Radar es la principal plataforma de geovallado y seguimiento de ubicación. La plataforma Radar tiene tres productos principales: Geovallas, seguimiento de viajes y API geográficas. La combinación de la plataforma de compromiso líder del sector de Braze y las capacidades de geofencing líderes del sector de Radar le permite impulsar los ingresos y la fidelidad a través de una amplia gama de experiencias de productos y servicios basadas en la ubicación. Entre ellas se incluyen el seguimiento de la recogida y la entrega, las notificaciones activadas por la ubicación, la personalización contextual, la verificación de la ubicación, los localizadores de tiendas, la función de autocompletar direcciones, etc.
La integración de Braze y Radar le permite acceder a sofisticados activadores de campañas basados en la ubicación y al enriquecimiento del perfil del usuario con datos de ubicación enriquecidos y de primera mano. Cuando se generan eventos de geovalla Radar o de seguimiento de viajes, los eventos personalizados y los atributos de usuario se envían a Braze en tiempo real. Estos eventos y atributos pueden utilizarse para lanzar campañas basadas en la localización, impulsar operaciones de recogida y entrega en el último kilómetro, supervisar la logística de flotas y envíos o crear segmentos de usuarios basados en patrones de localización.
Además, las Geo API de Radar pueden aprovecharse para enriquecer o personalizar sus campañas de marketing a través del Contenido Conectado.
Requisitos previos
Requisito | Descripción |
---|---|
Cuenta radar | Se necesita una cuenta Radar para beneficiarse de esta asociación. |
Clave REST API de Braze | Una clave de API REST de Braze con permisos users.track . Puede crearse en el panel Braze desde Configuración > Claves API. |
Identificador de la aplicación | Puede encontrar el identificador de su aplicación en el panel de control de Braze, en Configuración > Claves de API. |
Clave API de iOS Clave API de Android |
Estas claves API se pueden encontrar en el panel de control de Braze desde Configuración > Configuración de la aplicación. |
Integración
Para asignar datos entre los SDK de Braze y Radar, debe establecer los mismos ID de usuario o alias de usuario en ambos sistemas. Esto puede hacerse utilizando el método changeUser()
del SDK de Braze y el método setUserId()
del SDK de Radar.
Para activar la integración:
- En Radar, en la página Integraciones, localice Braze.
- Establezca Activado en Sí.
- Introduce el identificador de tu aplicación y las claves API.
Puedes establecer claves de API distintas para los entornos de prueba y en vivo.
4. Selecciona tu punto final Braze. 5. Introduzca cualquier filtro de eventos o atributos de eventos para garantizar que sólo se envían a Braze los datos relevantes para el marketing de captación. Siempre que se generen eventos Radar, Radar enviará eventos personalizados y atributos de usuario a Braze. Los eventos de dispositivos iOS se enviarán utilizando sus claves API de iOS; los eventos y atributos de usuario de dispositivos Android se enviarán utilizando sus claves API de Android.
Por defecto, Radar userId
mapea a los external_id
de Braze para los usuarios registrados. Sin embargo, puede realizar un seguimiento de los usuarios que han cerrado sesión o especificar asignaciones personalizadas configurando Radar metadata.brazeAlias
o metadata.brazeExternalId
. Si establece metadata.brazeAlias
, también debe añadir un alias correspondiente en Braze con la etiqueta radarAlias
.
Casos de uso basados en eventos y atributos
Puede utilizar eventos personalizados y atributos de usuario para crear segmentos basados en la ubicación o activar campañas basadas en la ubicación.
Activar una notificación de llegada a la tienda para la recogida en acera
Envía una notificación push al usuario con instrucciones de llegada cuando llegue a tu tienda para una recogida en acera.
Crear un segmento de audiencia de visitantes recientes de la tienda
Por ejemplo, diríjase a cualquier usuario que haya visitado su tienda en los últimos 7 días, tanto si ha realizado una compra como si no.
Contenido conectado
El siguiente ejemplo muestra cómo realizar una promoción para llevar a los usuarios cercanos a la tienda con una oferta digital.
Para empezar, necesitará tener a mano su clave de API publicable de Radar para utilizarla en sus URL de solicitud.
A continuación, dentro de una etiqueta connected_content
, haz una petición GET a la API Search Places. La API de búsqueda de lugares devuelve ubicaciones cercanas basadas en Radar Places: una base de datos de ubicaciones de lugares, cadenas y categorías que proporciona una visión completa del mundo.
El siguiente fragmento de código es un ejemplo de lo que Radar devolverá como objeto JSON de la llamada a la API:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
{
"meta": {
"code": 200
},
"places": [
{
"_id": "5dc9b0fd2004860034bf2b06",
"name": "Target",
"location": {
"type": "Point",
"coordinates": [
-74.42653983613333,
40.548302893822985
]
},
"categories": [
"shopping-retail",
"department-store"
],
"chain": {
"slug": "target",
"name": "Target",
"domain": "target.com"
}
},
{
"_id": "5dc9b3d82004860034bfec54",
"name": "Walmart",
"location": {
"type": "Point",
"coordinates": [
-74.44121885326864,
40.554603296187224
]
},
"categories": [
"shopping-retail"
],
"chain": {
"slug": "walmart",
"name": "Walmart",
"domain": "walmart.com"
}
}
]
}
Para construir el mensaje Braze personalizado y orientado al contenido conectado, puede aprovechar el atributo Braze most_recent_location
como entrada para el parámetro near
en la URL de la solicitud de API. El atributo most_recent_location
se recoge a través de la integración de eventos Radar o directamente a través del SDK Braze.
En el siguiente ejemplo, el filtrado de la cadena Radar se aplica a las ubicaciones de Target y Walmart, y el radio de búsqueda de las ubicaciones cercanas se establece en 2 km.
1
{% connected_content https://api.radar.io/v1/search/places?radius=2000&near={{${most_recent_location}.latitude}},{{${most_recent_location}.longitude}}&chains=target,walmart&limit=5 :method get :headers {"Authorization": "<yourRadarPublishableKey>"} :content_type application/json :save nearbyplaces %}
Como puede ver en la etiqueta connect_content
, el objeto JSON se almacena en la variable local nearbyplaces
añadiendo :save nearbyplaces
después de la URL.
Puedes probar cuál debería ser la salida consultando {{nearbyplaces.places}}
.
Uniendo nuestro caso de uso, he aquí cómo sería la sintaxis de la campaña. El siguiente código itera a través del objeto nearbyplaces.places
, extrayendo valores únicos y concatenándolos con delimitadores legibles por humanos adecuados para el mensaje.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
{% connected_content https://api.radar.io/v1/search/places?radius=2000&near={{${most_recent_location}.latitude}},{{${most_recent_location}.longitude}}&chains=target,walmart&limit=5 :method get :headers {"Authorization": "<yourRadarPublishableKey>"} :content_type application/json :save nearbyplaces %}
{% if nearbyplaces.**http_status_code** != 200 %}
{% abort_message('Connected Content returned a non-200 http status code') %}
{% endif %}
{% if nearbyplaces.meta.code != 200 %}
{% abort_message('Connected Content returned a non-200 meta code') %}
{% endif %}
{% if nearbyplaces.places.size == 0 %}
{% abort_message('Connected Content returned no nearby places') %}
{% else %}
{% assign delimiter = ", " %}
{% assign names = nearbyplaces.places | map: 'name' | uniq %}
{% if names.size == 2 %}
{{ names | join: ' and ' }}
{% elsif names.size > 2 %}
{% assign names_final_str = "" %}
{% for name in names %}
{% if forloop.first == true %}
{% assign names_final_str = names_final_str | append: name %}
{% elsif forloop.last == true %}
{% assign names_final_str = names_final_str | append: ", and " | append: name %}
{% else %}
{% assign names_final_str = names_final_str | append: delimiter | append: name %}
{% endif %}
{% endfor %}
{{ names_final_str }}
{% else %}
{{ names }}
{% endif %}
near you!
Visita la documentación de Radar para ver todas las API de Radar que pueden aprovecharse en el contenido conectado.