이 페이지는 AI로 자동 번역되었으며 부정확한 내용이 포함될 수 있습니다. 번역 오류를 신고하려면 페이지 오른쪽 목차 아래에 있는 피드백 기능을 사용하세요.

사용자 삭제

post

/users/delete

이 엔드포인트를 사용하면 알려진 사용자 식별자를 지정하여 모든 고객 프로필을 삭제할 수 있습니다.

하나의 요청에 최대 50개의 external_ids, user_aliases, braze_ids, email_addresses 또는 phone_numbers를 포함할 수 있습니다. 단, 하나의 요청에는 external_ids, user_aliases, braze_ids, email_addresses, phone_numbers 중 한 가지 유형만 포함할 수 있습니다.

API를 통한 대량 사용자 삭제로 해결할 수 없는 사용 사례가 있다면 Braze 지원팀에 문의하여 도움을 받으세요.

경고

고객 프로필 삭제는 되돌릴 수 없습니다. 삭제 작업은 사용자를 영구적으로 제거하므로 데이터에 불일치가 발생할 수 있습니다. 자세한 내용은 이 엔드포인트 레퍼런스의 고객 프로필 삭제의 영향 섹션을 참조하세요.

문제 해결

성공 응답이 반환되었지만 사용자가 여전히 표시되는 경우

성공 응답은 요청이 대기줄에 추가되었음을 확인하는 것이며, 삭제가 완료되었음을 의미하지는 않습니다. 삭제는 보통 1초 이내에 끝나지만, 변경 사항이 모든 캐시에 반영되기까지 최대 5분이 걸릴 수 있습니다. 대시보드에서 해당 사용자를 바로 검색하거나 API로 사용자 데이터를 내보내면, 이 반영 기간 동안에는 여전히 결과가 표시될 수 있습니다.

몇 분이 지난 후에도 사용자가 계속 존재한다면, 요청에 사용한 식별자가 실제 사용자 프로필과 일치하는지 확인하세요.

external_ids 배열: 각 값이 사용자의 외부 ID와 정확히 일치하는지 확인하세요.
braze_id: /users/export/ids 엔드포인트로 사용자 데이터를 내보내거나 Segment를 CSV로 내보내면 사용자의 braze_id를 확인할 수 있습니다(CSV에서는 braze_id가 “Appboy ID”로 표시됩니다).
별칭 또는 이메일만 있는 프로필: 프로필에 external_id가 없다면, 알려진 이메일 또는 전화번호와 함께 External User ID is blank 필터를 적용한 Segment를 만든 다음 CSV로 내보내 braze_id를 확인하세요.

사용자가 삭제되었는지 확인하려면, 삭제 요청에 사용한 것과 같은 식별자 유형으로 /users/export/ids 엔드포인트를 호출하세요(예: 값을 external_ids, braze_id 또는 user_aliases에 포함). 사용자가 더 이상 존재하지 않으면 응답에 "users": []가 포함되며, 해당 식별자를 나열한 "invalid_user_ids"가 포함될 수도 있습니다.

OpenAPI 문서를 다운로드하여 스키마 검증에 사용할 수 있습니다. 방법은 요청 검증에 OpenAPI 스키마 사용하기를 참조하세요.

New Stuff!