Objet Audience connectée

Une audience connectée est un filtre d’audience dynamique que vous définissez directement dans votre requête API, ce qui vous permet de cibler les bons utilisateurs au moment de l’envoi sans avoir à créer ou gérer des segments dans le tableau de bord de Braze.

Au lieu de créer à l’avance un segment pour chaque combinaison d’audience possible, vous transmettez les critères de filtrage directement dans le paramètre audience de votre appel API. Braze évalue chaque utilisateur par rapport à ces critères en temps réel et délivre le message uniquement aux utilisateurs correspondants. Ainsi, une seule campagne, un seul Canvas ou une seule définition de message API peut servir un nombre illimité de variations d’audience, entièrement piloté par votre logique métier.

Fonctionnement

1. Définissez votre message en créant une campagne ou un Canvas déclenchés par API dans le tableau de bord de Braze, ou définissez le contenu du message entièrement en ligne à l’aide des objets de messagerie dans votre requête API. Utilisez les propriétés de déclenchement ou le contexte Canvas pour la personnalisation dynamique.
2. Appelez un endpoint compatible et incluez le paramètre audience avec vos critères de filtrage. Vous pouvez filtrer sur les attributs personnalisés, le statut d’abonnement aux notifications push, le statut d’abonnement aux e-mails et la date de dernière utilisation de l’application.
3. Braze évalue les filtres au moment de l’envoi et délivre le message uniquement aux utilisateurs correspondant à vos critères.

Comme l’audience est définie par requête, vos systèmes back-end peuvent déclencher des messages contextuellement pertinents en réponse à n’importe quel événement métier (un changement de prix, une alerte météo, une mise à jour de score en direct) sans intervention dans le tableau de bord.

Endpoints compatibles

Vous pouvez utiliser l’objet Audience connectée avec le paramètre audience sur les endpoints suivants :

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

Cas d’utilisation

Utilisez les audiences connectées dans les scénarios où vos systèmes back-end détectent un événement et doivent notifier un ensemble d’utilisateurs déterminé dynamiquement :

Dans chaque cas, une seule campagne ou définition de message API gère toutes les variations. Votre back-end détermine les valeurs de filtrage et les transmet dans la requête API, ce qui vous évite de créer un segment ou une campagne distinct(e) pour chaque produit, émission, équipe ou emplacement.

Exemple de requête

L’exemple suivant utilise l’endpoint /campaigns/trigger/send pour cibler les utilisateurs ayant ajouté une émission spécifique à leurs favoris et ayant accepté les notifications 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
}

Corps de l’objet

L’objet Audience connectée est composé soit d’un seul filtre d’audience connectée, soit de plusieurs filtres d’audience connectée combinés à l’aide des opérateurs AND et OR.

Exemple avec plusieurs filtres :

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
    ]
}

Filtres d’audience connectée

Combinez plusieurs filtres avec les opérateurs AND et OR pour créer un filtre d’audience connectée.

Filtre d’attribut personnalisé

Ce filtre vous permet de segmenter en fonction d’un attribut personnalisé de l’utilisateur. Il contient jusqu’à trois champs :

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
    }
}

Comparaisons autorisées par type de données

Le type de données de l’attribut personnalisé détermine les comparaisons valides pour un filtre donné.

Points d’attention sur les comparaisons d’attributs

Exemple d’attribut personnalisé

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
  }
}

Filtre d’abonnement aux notifications push

Ce filtre vous permet de segmenter en fonction du statut d’abonnement aux notifications push d’un utilisateur.

Corps du filtre

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
  }
}

• Comparaisons autorisées : is, is_not
• Valeurs autorisées : opted_in, subscribed, unsubscribed

Filtre d’abonnement aux e-mails

Ce filtre vous permet de segmenter en fonction du statut d’abonnement aux e-mails d’un utilisateur.

Corps du filtre

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
  }
}

• Comparaisons autorisées : is, is_not
• Valeurs autorisées : opted_in, subscribed, unsubscribed

Filtre de dernière utilisation de l’application

Ce filtre vous permet de segmenter en fonction de la dernière utilisation de l’application par l’utilisateur. Il contient deux champs :

Corps du filtre

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
  }
}

• Comparaisons autorisées : after, before
• Valeurs autorisées : datetime (chaîne ISO 8601)

Considérations

Les audiences connectées ne permettent pas de filtrer les utilisateurs en fonction d’attributs par défaut, d’événements personnalisés, de segments ou d’événements d’engagement liés aux messages. Pour utiliser ces filtres, nous vous recommandons de les intégrer dans un segment d’audience, puis de spécifier ce segment dans le paramètre segment_id de l’endpoint /messages/send. Pour les autres endpoints, vous devrez d’abord ajouter le segment à la campagne déclenchée par l’API ou au Canvas dans le tableau de bord de Braze.