Objeto de audiencia conectada

Una audiencia conectada es un filtro de audiencia dinámico que defines en línea dentro de tu solicitud de API, para que puedas dirigirte a los usuarios correctos en el momento del envío sin crear ni gestionar segmentos en el dashboard de Braze.

En lugar de crear previamente un segmento para cada posible combinación de audiencia, pasas los criterios de filtro directamente en el parámetro audience de tu llamada a la API. Braze evalúa a cada usuario contra esos criterios en tiempo real y entrega el mensaje solo a los usuarios que coincidan. Esto significa que una sola campaña, Canvas o definición de mensaje solo de API puede servir a un número ilimitado de variaciones de audiencia, impulsadas completamente por tu lógica de negocio.

Cómo funciona

1. Define tu mensaje creando una campaña activada por API o un Canvas en el dashboard de Braze, o define el contenido del mensaje completamente en línea usando los objetos de mensajería en tu solicitud de API. Usa propiedades de desencadenamiento o contexto de Canvas para personalización dinámica.
2. Llama a un punto de conexión compatible e incluye el parámetro audience con tus criterios de filtro. Puedes filtrar por atributos personalizados, estado de suscripción push, estado de suscripción de correo electrónico y hora de último uso de la aplicación.
3. Braze evalúa los filtros en el momento del envío, entregando el mensaje solo a los usuarios que coincidan con tus criterios.

Dado que la audiencia se define por solicitud, tus sistemas de backend pueden desencadenar mensajes contextualmente relevantes en respuesta a cualquier evento de negocio (un cambio de precio, una alerta meteorológica, una actualización de puntuación en vivo) sin intervención del dashboard.

Puntos de conexión compatibles

Puedes usar el objeto de audiencia conectada con el parámetro audience en estos puntos de conexión:

• /messages/send
• /campaigns/trigger/send
• /canvas/trigger/send
• /messages/schedule/create
• /campaigns/trigger/schedule/create
• /canvas/trigger/schedule/create

Casos de uso

Usa audiencias conectadas para escenarios en los que tus sistemas de backend detectan un evento y necesitan notificar a un conjunto de usuarios determinado dinámicamente:

En cada caso, una sola campaña o definición de mensaje solo de API maneja todas las variaciones. Tu backend determina los valores de filtro y los pasa en la solicitud de API, por lo que no necesitas crear un segmento o campaña separada para cada producto, programa, equipo o ubicación.

Ejemplo de solicitud

El siguiente ejemplo usa el punto de conexión /campaigns/trigger/send para dirigirse a los usuarios que han marcado como favorito un programa específico y han optado por recibir notificaciones push:

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
{
  "campaign_id": "YOUR_CAMPAIGN_ID",
  "audience": {
    "AND": [
      {
        "custom_attribute": {
          "custom_attribute_name": "favorite_shows",
          "comparison": "includes_value",
          "value": "Example Show"
        }
      },
      {
        "push_subscription_status": {
          "comparison": "is",
          "value": "opted_in"
        }
      }
    ]
  },
  "trigger_properties": {
    "show_title": "Example Show",
    "episode_title": "Season 3, Episode 1",
    "deep_link": "https://example.com/shows/example-show/s3e1"
  },
  "broadcast": false
}

Cuerpo del objeto

El objeto de audiencia conectada se compone de un único filtro de audiencia conectada o de varios filtros de audiencia conectada combinados con los operadores AND y OR.

Ejemplo con múltiples filtros:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
{
  "AND":
    [
      Connected Audience Filter,
      {
        "OR" :
          [
            Connected Audience Filter,
            Connected Audience Filter
          ]
      },
      Connected Audience Filter
    ]
}

Filtros de audiencia conectada

Combina varios filtros con los operadores AND y OR para crear un filtro de audiencia conectada.

Filtro de atributo personalizado

Este filtro te permite segmentar en función del atributo personalizado de un usuario. Estos filtros contienen hasta tres campos:

1
2
3
4
5
6
7
8
{
  "custom_attribute":
    {
      "custom_attribute_name": (String) the name of the custom attribute to filter on,
      "comparison": (String) one of the allowed comparisons to make against the provided value,
      "value": (String, Numeric, Boolean) the value to be compared using the provided comparison
    }
}

Comparaciones permitidas por tipo de datos

El tipo de datos del atributo personalizado determina las comparaciones válidas para un filtro determinado.

Advertencias sobre la comparación de atributos

Ejemplo de atributo personalizado

1
2
3
4
5
6
7
8
{
  "custom_attribute":
    {
      "custom_attribute_name": "eye_color",
      "comparison": "equals",
      "value": "blue"
    }
}

1
2
3
4
5
6
7
8
{
  "custom_attribute":
  {
    "custom_attribute_name": "favorite_foods",
    "comparison": "includes_value",
    "value": "pizza"
  }
}

1
2
3
4
5
6
7
8
{
  "custom_attribute":
  {
    "custom_attribute_name": "last_purchase_time",
    "comparison": "less_than_x_days_ago",
    "value": 2
  }
}

Filtro de suscripción push

Este filtro te permite segmentar en función del estado de suscripción push de un usuario.

Cuerpo del filtro

1
2
3
4
5
6
7
{
  "push_subscription_status":
  {
    "comparison": (String) one of the following allowed comparisons,
    "value": (String) one of the following allowed values
  }
}

• Comparaciones permitidas: is, is_not
• Valores permitidos: opted_in, subscribed, unsubscribed

Filtro de suscripción de correo electrónico

Este filtro te permite segmentar en función del estado de suscripción de correo electrónico de un usuario.

Cuerpo del filtro

1
2
3
4
5
6
7
{
  "email_subscription_status":
  {
    "comparison": (String) one of the following allowed comparisons,
    "value": (String) one of the following allowed values
  }
}

• Comparaciones permitidas: is, is_not
• Valores permitidos: opted_in, subscribed, unsubscribed

Filtro de última aplicación utilizada

Este filtro te permite segmentar en función de cuándo el usuario utilizó la aplicación por última vez. Estos filtros contienen dos campos:

Cuerpo del filtro

1
2
3
4
5
6
7
{
  "last_used_app":
  {
    "comparison": (String) one of the allowed comparisons listed,
    "value": (String) the value to be compared using the provided comparison
  }
}

• Comparaciones permitidas: after, before
• Valores permitidos: datetime (cadena ISO 8601)

Consideraciones

Las audiencias conectadas no pueden filtrar a los usuarios por atributos predeterminados, eventos personalizados, segmentos o eventos de interacción con mensajes. Para utilizar estos filtros, recomendamos incorporarlos a un segmento de audiencia y, a continuación, especificar ese segmento en el parámetro segment_id del punto de conexión /messages/send. Si utilizas otros puntos de conexión, primero deberás añadir el segmento a la campaña activada por API o al Canvas en el dashboard de Braze.