수신자 개체
수신자 개체를 사용하면 엔드포인트에서 정보를 요청하거나 쓸 수 있습니다.
이 개체에는 external_user_id, user_alias, braze_id 또는 email 중 하나를 포함해야 합니다. 요청은 하나만 지정해야 합니다.
수신자 개체를 사용하면 사용자 별칭 지정 개체, 트리거 속성 개체, 캔버스 항목 속성 개체 및 사용자 속성 개체를 결합할 수 있습니다.
개체 본문
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,
"canvas_entry_properties": (optional, object) personalization key-value pairs for this user when triggering a Canvas; see Canvas Entry Properties,
"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
}]
send_to_existing_only 이 true 인 경우 Braze는 기존 사용자에게만 메시지를 보냅니다. 그러나 이 플래그는 사용자 별칭 지정과 함께 사용할 수 없습니다. send_to_existing_only 이 false 인 경우 속성을 포함해야 합니다. Braze는 메시지를 보내기 전에 id 및 속성을 가진 사용자를 생성합니다.
수신자 개체 중복 제거
수신자 객체로 API 호출을 할 때 동일한 주소(이메일, 푸시)를 타겟팅하는 중복된 수신자가 있는 경우, Braze는 사용자를 중복 제거하여 동일한 사용자를 하나만 남깁니다.
예를 들어 동일한 external_user_id 을 사용하는 경우 사용자는 하나의 메시지만 수신합니다. 이 동작에 대한 해결 방법이 필요한 경우 여러 번 API를 호출하는 것을 고려하세요.
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"}}
]}
New Stuff!
GitHub 에서 이 페이지를 편집합니다.