Objet Destinataire

L’objet Destinataire vous permet de demander ou d’écrire des informations dans nos endpoints.

Veuillez inclure l’un des external_user_idéléments suivants user_alias: braze_id, , ouemail dans cet objet. Les demandes ne doivent en spécifier qu’un seul des deux.

L’objet destinataire vous permet de combiner l’objet alias d’utilisateur, l’objet propriétés du déclencheur, l’objet propriétés d’entrée canvas et l’objet attributs utilisateur.

Corps de l’objet

1
2
3
4
5
6
7
8
9
10
11
[{
  "user_alias": (optional, User Alias Object) User alias of user to receive message,
  "external_user_id": (optional, string) see External user ID,
  "braze_id": (optional, string) see Braze ID,
  "email": (optional, string) email address of user to receive message,
  "prioritization": (optional, array) see Prioritization; required when using email,
  "trigger_properties": (optional, object) personalization key-value pairs for this user when sending a campaign or message; see Trigger Properties,
  "context": (optional, object) personalization key-value pairs for this user when triggering a Canvas; see Canvas context object,
  "send_to_existing_only": (optional, boolean) defaults to true; cannot be used with user aliases,
  "attributes": (optional, object) fields in the attributes object create or update an attribute of that name with the given value on the specified user profile before the message is sent and existing values are overwritten
}]

Lorsquesend_to_existing_only,true Braze envoie le message uniquement aux utilisateurs existants. Cependant, il n’est pas possible d’utiliser ce drapeau avec les alias d’utilisateurs. Lorsquesend_to_existing_only est false, il est nécessaire d’inclure un attribut. Braze crée un utilisateur avec les idattributs et avant d’envoyer le message.

• ID Braze
• Alias utilisateurs
• ID utilisateur externe
• Détermination de l’ordre de priorité
• Objet Attributs d’utilisateur

Déduplication d’objet Destinataire

Lorsqu’un appel API est effectué avec l’objet destinataire, s’il existe un destinataire en double au niveau du ciblage de l’adresse (c’est-à-dire e-mail, push), Braze procède à la déduplication de l’utilisateur, ce qui signifie que Braze supprime les utilisateurs identiques, n’en conservant qu’un seul.

Par exemple, si vous utilisez le même identifiantexternal_user_id, l’utilisateur ne recevra qu’un seul message. Envisagez de faire plusieurs appels à l’API si vous avez besoin d’une solution de contournement pour ce comportement.

1
2
3
4
{"campaign_id":"#####","recipients":[
{"external_user_id":"userid1","trigger_properties":{"name":"Beth Test 1"}},
{"external_user_id":"userid1","trigger_properties":{"name":"Beth Test 2"}}
]}