새 사용자 별칭 만들기
/users/alias/new
이 엔드포인트를 사용하여 이미 식별된 기존 사용자에게 새 사용자 별칭을 추가하거나, 식별되지 않은 새 사용자를 만들 수 있습니다.
요청당 최대 50개의 사용자 별칭을 지정할 수 있습니다.
기존 사용자에게 사용자 별칭을 추가하려면 새 사용자 별칭 오브젝트에 external_id를 포함해야 합니다. 오브젝트에 external_id가 있지만 해당 external_id를 가진 사용자가 없으면 별칭은 어떤 사용자에게도 추가되지 않습니다. external_id가 없으면 사용자는 생성되지만 나중에 식별해야 합니다. 이 작업은 “사용자 식별” 및 users/identify 엔드포인트를 사용하여 수행할 수 있습니다.
별칭 전용 사용자를 새로 만들려면 새 사용자 별칭 오브젝트에서 external_id를 생략해야 합니다. 사용자가 생성된 후에는 /users/track 엔드포인트를 사용하여 별칭 전용 사용자를 속성, 이벤트, 구매와 연결하고, /users/identify 엔드포인트를 사용하여 external_id로 사용자를 식별합니다.
/campaigns/trigger/send 엔드포인트를 사용하면 user_alias를 기준으로 사용자에게 API 트리거 Campaign(캠페인)을 보낼 수 있습니다.
alias_label과 alias_name이 이미 존재하는 경우
alias_label과 alias_name의 조합은 사용자 기반 전체에서 고유해야 합니다. 자세한 내용은 사용자 별칭을 참조하세요.
alias_label과 alias_name 쌍이 이미 어떤 사용자에게든(같은 사용자든 다른 사용자든) 존재하는 상태에서 요청을 보내더라도 엔드포인트는 성공 응답을 반환합니다(예: "aliases_processed": 1, "message": "success"). 이 경우 요청에 포함된 사용자에게 새 별칭이 추가되지 않습니다. alias_label과 alias_name 쌍이 이미 사용 중이므로 요청은 아무것도 변경하지 않으며, 해당 사용자에게 별칭이 전혀 추가되지 않은 것처럼 보일 수 있습니다.
문제 해결
이 엔드포인트로 사용자 별칭을 만든 후 속성이 업데이트되지 않는 이유는 무엇인가요?
이 문제는 보통 /users/alias/new 다음에 별도의 /users/track 요청으로 별칭을 기준으로 속성을 업데이트하려고 할 때 발생합니다. Braze가 새 alias_label 및 alias_name 쌍을 프로필로 일관되게 확인하기 전에 track 요청이 처리될 수 있으므로, 속성이 예상한 사용자에게 반영되지 않습니다.
권장 방법: 별칭 전용 프로필을 만들거나 이미 존재하는 별칭으로 프로필을 업데이트하려는 경우에만 단일 /users/track 호출을 사용하세요. attributes 배열에서 user_alias와 프로필 필드를 같은 사용자 속성 오브젝트에 넣으면 Braze가 한 번에 사용자를 확인하고 업데이트를 적용합니다.
해당 오브젝트로 별칭 전용 프로필을 만들어야 할 수도 있는 경우에는 _update_existing_only를 false로 설정하세요. user_alias를 사용하면서 이 값을 생략하면 Braze는 기본값으로 업데이트 전용 동작을 적용하며 별칭 전용 프로필을 만들지 않습니다. 워크스페이스의 사용자에게 해당 별칭이 이미 존재하면 같은 요청으로 그 프로필이 새 속성으로 업데이트됩니다.
/users/track을 사용하여 external_id로 식별된 기존 사용자에게 새 별칭을 추가할 수는 없습니다. 사용자 속성 오브젝트에서 external_id와 user_alias는 함께 사용할 수 없습니다. 식별된 사용자에게 별칭을 추가하려면 먼저 /users/alias/new를 호출하세요. 별칭이 연결된 후에는 external_id 또는 기존 별칭을 기준으로 /users/track을 사용하여 해당 프로필을 업데이트할 수 있습니다.
예를 들어, 다음 /users/track 본문은 별칭이 아직 없으면 별칭 전용 프로필을 만들고, 해당 별칭을 가진 프로필이 이미 있으면 그 프로필을 업데이트합니다.
{
"attributes": [
{
"user_alias": {
"alias_name": "[email protected]",
"alias_label": "email"
},
"_update_existing_only": false,
"string_attribute": "test_alias_only_update"
}
]
}
OpenAPI 문서를 다운로드하여 스키마 검증에 사용할 수 있습니다. 방법은 요청 검증에 OpenAPI 스키마 사용하기를 참조하세요.