Objet Audience connectée

Un objet public connecté identifie l’audience de votre message. Par exemple, si vous utilisez des tableaux d’attributs personnalisés pour suivre toutes les catégories et émissions de télévision qu’un utilisateur a ajoutées à ses favoris, vous pouvez utiliser les audiences connectées pour envoyer automatiquement une notification push ou un e-mail à toute personne ayant ajouté une émission à ses favoris dès qu’un nouvel épisode est diffusé, sans avoir à configurer un segment pour chaque émission.

Cet objet est composé soit d’un seul filtre d’audience connectée, soit de plusieurs filtres d’audience connectée dans une expression logique utilisant des opérateurs AND ou OR.

Exemple de filtre multiple :

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

La combinaison de plusieurs filtres d’attributs personnalisés avecANDlesORopérateurs crée un filtre d’audience connecté.

Filtre d’attribut personnalisé

Ce filtre vous permet de segmenter en fonction de l’attribut personnalisé d’un utilisateur. Ces filtres contiennent 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 qui sont valides pour un filtre donné.

Mises en garde dans la comparaison des 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

Dernier filtre d’application utilisé

Ce filtre vous permet de segmenter en fonction de la dernière utilisation de l’application par l’utilisateur. Ces filtres contiennent 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 peuvent pas filtrer les utilisateurs en fonction d’attributs par défaut, d’événements personnalisés, de segments ou d’événements d’engagement aux messages. Pour utiliser ces filtres, nous vous recommandons de les intégrer à un segment d’audience, puis de spécifier ce segment dans lesegment_idparamètre pour /messages/sendl’endpoint. Lorsque vous utilisez d’autres endpoints, il est nécessaire d’ajouter le segment à la campagne déclenchée par l’API ou à Canvas dans le tableau de bord de Braze au préalable.