Objet Destinataire

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

Cet objet doit contenir soit external_user_id, soit user_alias, soit email. 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 et l’objet propriétés de l’entrée dans le canvas.

Corps de l’objet

1
2
3
4
5
6
7
8
[{
  "user_alias": (optional, User Alias Object) User alias of user to receive message,
  "external_user_id": (optional, string) see External user 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,
  "canvas_entry_properties": (optional, object) personalization key-value pairs for this user when triggering a Canvas; see Canvas Entry Properties
}]

• Alias utilisateurs
• ID utilisateur externe
• Détermination de l’ordre de priorité

Déduplication d’objet Destinataire

Lorsque vous effectuez un appel d’API avec l’objet Destinataire, s’il existe un destinataire dupliqué ciblant la même adresse (par ex. e-mail, notification push), l’utilisateur sera dédupliqué, ce qui signifie que les utilisateurs identiques seront supprimés. Il n’en restera qu’un.

Par exemple, si le même external_user_id est utilisé, un seul message sera reçu. 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"}} 
]}