Radar

Radar es la principal plataforma de geovallado y seguimiento de ubicación. La plataforma Radar tiene tres productos principales: Geofences, Trip Tracking y Geo APIs. La combinación de la plataforma de interacción líder del sector de Braze y las capacidades de geovallado líderes del sector de Radar te permite impulsar los ingresos y la fidelización 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, y más.

Esta integración está mantenida por Radar.

Sobre la integración

La integración de Braze y Radar te permite acceder a sofisticados activadores de campañas basados en la ubicación y al enriquecimiento del perfil de usuario con datos de ubicación enriquecidos y de primera mano. Cuando se generan eventos de geovalla de 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 ubicació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 ubicación.

Además, las Geo APIs de Radar pueden utilizarse para enriquecer o personalizar tus campañas de marketing a través del Contenido conectado.

Requisitos previos

Integración

Para mapear datos entre los SDK de Braze y Radar, debes 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:

1. En Radar, en la página Integrations, localiza Braze.
2. Establece Enabled en Yes.
3. Introduce el identificador de tu aplicación y las claves de API.

Nota

Puedes establecer claves de API distintas para los entornos de prueba y en vivo.

4. Selecciona tu punto de conexión de Braze.
5. Introduce cualquier filtro de eventos o atributos de eventos para garantizar que solo se envían a Braze los datos relevantes para el marketing de interacció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 tus claves de API de iOS; los eventos y atributos de usuario de dispositivos Android se enviarán utilizando tus claves de API de Android.

Nota

Por defecto, el userId de Radar se mapea al external_id de Braze para los usuarios registrados. Sin embargo, puedes realizar un seguimiento de los usuarios que han cerrado sesión o especificar mapeados personalizados configurando metadata.brazeAlias o metadata.brazeExternalId de Radar. Si estableces metadata.brazeAlias, también debes añadir un alias correspondiente en Braze con la etiqueta radarAlias.

Casos de uso basados en eventos y atributos

Puedes 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ígete a cualquier usuario que haya visitado tu 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ás tener a mano tu clave de API publicable de Radar para utilizarla en tus 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 de Braze dirigido y personalizado con Contenido conectado, puedes utilizar el atributo de Braze most_recent_location como entrada para el parámetro near en la URL de la solicitud de la 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 de Braze.

En el siguiente ejemplo, el filtrado de cadena de 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 puedes 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, así es como se verí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 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!

Consejo

Visita la documentación de Radar para ver todas las API de Radar que pueden utilizarse en el Contenido conectado.