사용자 생성 및 업데이트 (동기)
이 엔드포인트를 사용하여 커스텀 이벤트와 구매를 기록하고 고객 프로필 속성을 동기식으로 업데이트할 수 있습니다. 이 엔드포인트는 고객 프로필을 비동기식으로 업데이트하는
/users/track엔드포인트와 유사하게 작동합니다.

이 엔드포인트는 현재 제한된 베타 상태입니다. 지금은 베타에 새로운 고객을 추가하고 있지 않지만, 이 기능이 Braze 통합에 유용할 것 같다면 Braze 계정 매니저에게 알려주세요.
동기 및 비동기 API 호출
비동기 호출에서 API는 상태 코드 201을 반환하여 요청이 성공적으로 수신되고 이해되었으며 수락되었음을 나타냅니다. 그러나 이것이 요청이 완전히 완료되었다는 의미는 아닙니다.
동기 호출에서 API는 상태 코드 201을 반환하여 요청이 성공적으로 수신되고 이해되었으며 수락되고 완료되었음을 나타냅니다. 호출 응답에는 작업 결과로 일부 고객 프로필 필드가 표시됩니다.
이 엔드포인트는 /users/track 엔드포인트보다 사용량 제한이 낮습니다(사용량 제한 참조). 각 /users/track/sync 요청에는 하나의 이벤트 오브젝트, 하나의 속성 오브젝트 또는 하나의 구매 오브젝트만 포함할 수 있습니다. 이 엔드포인트는 동기 호출이 필요한 고객 프로필 업데이트에만 사용해야 합니다. 안정적인 구현을 위해 /users/track/sync와 /users/track을 함께 사용하는 것을 권장합니다.
예를 들어 동일한 사용자에 대해 짧은 시간 동안 연속으로 요청을 보내는 경우, 비동기식 /users/track 엔드포인트에서는 경합 조건이 발생할 수 있지만 /users/track/sync 엔드포인트를 사용하면 각 요청마다 2XX 응답을 받은 후 다음 요청을 순차적으로 보낼 수 있습니다.
자주 묻는 질문
비동기식 엔드포인트와 동기식 엔드포인트 중 무엇을 사용해야 하나요?
대부분의 프로필 업데이트에는 사용량 제한이 더 높고 요청을 일괄 처리할 수 있는 유연성이 있는 /users/track 엔드포인트가 가장 적합합니다. 그러나 동일한 사용자에 대한 빠른 연속 요청으로 인해 경합 조건이 발생하는 경우에는 /users/track/sync 엔드포인트가 유용합니다.
응답 시간이 /users/track 엔드포인트와 다른가요?
동기 호출에서는 Braze가 요청을 완료할 때까지 API가 기다린 후 응답을 반환합니다. 따라서 동기 요청은 /users/track에 대한 비동기 요청보다 평균적으로 더 오래 걸립니다. 대부분의 요청은 몇 초 안에 응답을 받을 수 있습니다.
동시에 여러 요청을 보낼 수 있나요?
네, 요청이 서로 다른 사용자를 대상으로 하거나 각 요청이 한 사용자의 서로 다른 속성, 이벤트, 구매를 업데이트하는 경우라면 가능합니다.
한 사용자의 동일한 속성, 이벤트 또는 구매에 대해 여러 요청을 보내는 경우, Braze는 경합 조건이 발생하지 않도록 각 요청 사이에 성공 응답을 기다릴 것을 권장합니다.
동일한 사용자에 대해 /users/track을 빠르게 연속 호출할 때 여전히 프로필 상태가 일관되지 않다면, 해당 업데이트를 /users/track/sync로 전환하고 한 번에 하나씩 요청을 보내면서 다음 요청 전에 각 2XX 응답을 기다리세요. 이렇게 순서를 지키는 것이 촘촘한 루프나 병렬 워커에서 발생하는 쓰기 후 읽기 경합을 방지하는 공식적으로 지원되는 방법입니다.
응답 값이 원래 요청의 값과 일치하지 않는 이유는 무엇인가요?
요청이 완료되었더라도 커스텀 속성 값이 업데이트되지 않았을 수 있습니다. 이는 커스텀 속성 업데이트가 최대 문자 수를 초과하거나, 배열 제한을 초과하거나, 사용자가 Braze에 존재하지 않는 상태에서 _update_existing_only = true로 설정된 경우에 발생할 수 있습니다.
이러한 경우에는 요청은 완료되었지만 원하는 업데이트가 반영되지 않았다는 의미로 응답을 해석하세요. 응답 값이 원래 요청의 값과 일치하지 않는 이유는 무엇인가요?에 나열된 이유를 참고하여 문제를 해결하세요.
OpenAPI 문서를 다운로드하여 스키마 검증에 사용할 수 있습니다. 방법은 요청 검증에 OpenAPI 스키마 사용을 참조하세요.