Objet Audience connectée

Un objet Audience connectée est un sélecteur qui identifie l’audience à laquelle envoyer le message.

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

L’association de plusieurs filtres d’attributs personnalisés crée un filtre d’audience connectée, qui crée lui-même un filtre d’audience connectée lorsqu’il est combiné avec les opérateurs AND et OR.

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
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
{
  "custom_attribute":
    {
      "custom_attribute_name": "eye_color",
      "comparison": "equals",
      "value": "blue"
    }
}

{
  "custom_attribute":
  {
    "custom_attribute_name": "favorite_foods",
    "comparison": "includes_value",
    "value": "pizza"
  }
}

{
  "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 du moment où l’utilisateur a utilisé l’application pour la dernière fois. 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 incorporer dans un segment d’audience et de spécifier ensuite ce segment dans le champ segment_id.