새 사용자 별칭 만들기
/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 쌍이 이미 사용 중이므로 요청은 아무것도 변경하지 않으며, 해당 사용자에게 별칭이 전혀 추가되지 않은 것처럼 보일 수 있습니다.
Endpoint reference
This reference is generated from the OpenAPI specification for this endpoint. To run the endpoint, copy the generated cURL example and send it from your terminal or Postman. You can also download the raw OpenAPI spec for this page at /docs/ko/assets/api/openapi/users_alias_new.yaml. Use this spec to validate that your requests include the correct parameters, fields, and structure before you send them. To learn how, see Use OpenAPI schemas for request validation.