Objeto de destinatarios

El objeto de destinatarios te permite solicitar o escribir información en nuestros puntos de conexión.

Debes incluir uno de external_user_id, user_alias, braze_id o email en este objeto. Las solicitudes deben especificar solo uno.

El objeto de destinatarios te permite combinar el objeto de alias de usuario, el objeto de propiedades del desencadenador, el objeto de propiedades de entrada de Canvas y el objeto de atributos de usuario.

Cuerpo del objeto

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

Cuando send_to_existing_only es true, Braze solo envía el mensaje a los usuarios existentes. Sin embargo, no puedes utilizar este indicador con alias de usuario. Cuando send_to_existing_only es false, debes incluir un atributo. Braze crea un usuario con el id y los atributos antes de enviar el mensaje.

• ID de Braze
• Alias de usuario
• ID de usuario externo
• Priorización
• Objeto de atributos de usuario

Desduplicación del objeto de destinatario

Al realizar una llamada a la API con el objeto de destinatario, si existe un destinatario duplicado que apunta a la misma dirección (es decir, correo electrónico, push), Braze desduplica al usuario, es decir, elimina los usuarios idénticos y deja solo uno.

Por ejemplo, si utilizas el mismo external_user_id, el usuario solo recibirá un mensaje. Considera realizar varias llamadas a la API si necesitas una solución alternativa para este comportamiento.

Cuando el mismo external_user_id aparece varias veces en el array de destinatarios, Braze envía solo un mensaje y utiliza las propiedades del desencadenador de la última aparición en el array. Este comportamiento es determinista y se basa en el orden del array.

En el siguiente ejemplo, userid1 recibe un mensaje con "name": "Beth Test 2" porque esa entrada aparece en último lugar en el array.

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