경합 조건

경합 조건은 결과가 여러 이벤트의 순서나 타이밍에 따라 달라지는 경우에 발생합니다. 예를 들어, 원하는 이벤트 순서가 ‘이벤트 A’, ‘이벤트 B’인 경우 ‘이벤트 A’가 먼저 올 때도 있고 ‘이벤트 B’가 먼저 올 때도 있는데, 이를 경합 조건이라고 합니다. 이러한 이벤트가 공유 리소스나 데이터에 액세스하기 위해 경쟁하기 때문에 예기치 않은 결과나 오류가 발생할 수 있습니다.

Braze에서는 사용자 데이터 또는 이벤트를 기반으로 여러 동작이 동시에 트리거될 때 경합 조건이 발생할 수 있습니다. 예를 들어 사용자가 뉴스레터 가입이나 구매 등 여러 캠페인을 트리거하는 경우 메시지가 올바른 순서로 수신되지 않을 수 있습니다.

경합 조건의 유형

가장 일반적인 유형의 경합 조건은 다음을 수행할 때 발생할 수 있습니다:

• 신규 사용자 타겟팅하기
• 여러 API 엔드포인트 사용
• 동작 기반 트리거와 오디언스 필터를 매칭합니다.

다음 시나리오를 고려하고 이러한 경합 조건을 피하기 위한 모범 사례를 구현하세요.

시나리오 1: 신규 사용자 타겟팅하기

Braze에서 가장 일반적인 경합 조건 중 하나는 새로 생성된 사용자를 타겟팅하는 메시지에서 발생합니다. 예상되는 이벤트 순서는 다음과 같습니다:

1. 사용자가 생성됩니다;
2. 동일한 사용자가 즉시 메시지를 타겟팅하거나, 커스텀 이벤트를 수행하거나, 커스텀 속성을 로그합니다.

그러나 경우에 따라 두 번째 이벤트가 먼저 트리거될 수도 있습니다. 이는 아직 존재하지 않는 사용자에게 메시지를 보내려고 시도하고 있음을 의미합니다. 결과적으로 사용자는 절대 받지 못합니다. 이는 이벤트나 속성이 아직 생성되지 않은 사용자 프로필에 로그인을 시도하는 이벤트나 속성에도 적용됩니다.

모범 사례

지연 소개

새 사용자가 생성된 후 타겟팅된 캠페인이나 캔버스를 보내기 전에 지연 시간을 추가할 수 있습니다. 이 시간 지연을 통해 고객 프로필이 생성되고 메시지 수신 자격을 결정할 수 있는 관련 속성이 업데이트될 수 있습니다.

예를 들어, 사용자가 앱에 등록한 후 24시간 후에 프로모션 오퍼를 보낼 수 있습니다. 또는 사용자를 만들거나 커스텀 속성을 로깅하는 경우 프로세스를 진행하기 전에 1분 지연을 추가하여 이 경합 조건을 피할 수 있습니다.

신규 사용자가 캔버스에 입장하도록 트리거하는 특정 커스텀 이벤트에 대해 Braze SDK에서 이 지연을 추가할 수도 있습니다.

시나리오 2: 여러 API 엔드포인트 사용

다음과 같이 여러 API 엔드포인트로 인해 이 경합 조건이 발생할 수 있는 몇 가지 시나리오가 있습니다:

• 별도의 API 엔드포인트를 사용하여 사용자를 생성하고 캔버스 또는 캠페인 트리거하기
• 커스텀 속성, 이벤트 또는 구매를 업데이트하기 위해 /users/track 엔드포인트를 여러 번 별도로 호출하기

/users/track 엔드포인트를 사용하여 사용자 정보를 Braze로 전송하는 경우 처리하는 데 몇 초가 걸릴 수 있습니다. 즉, /users/track 와 /campaign/trigger/send 과 같은 메시징 엔드포인트에 동시에 요청이 이루어질 경우 메시지가 전송되기 전에 사용자 정보가 업데이트된다는 보장이 없습니다.

모범 사례

여러 엔드포인트를 사용하는 경우, 요청을 한 번에 하나씩 보내세요.

여러 엔드포인트를 사용하는 경우 각 요청이 다음 요청이 시작되기 전에 완료되도록 시차를 두어 요청을 시도해 볼 수 있습니다. 이렇게 하면 경합 조건이 발생할 가능성을 줄일 수 있습니다. 예를 들어 사용자 속성을 업데이트하고 메시지를 보내야 하는 경우 먼저 고객 프로필이 완전히 업데이트될 때까지 기다렸다가 엔드포인트를 사용하여 메시지를 보내세요.

예약된 메시지 API 요청을 보내는 경우 이러한 요청은 분리되어야 하며, 예약된 API 요청을 보내기 전에 사용자를 만들어야 합니다.

트리거에 주요 데이터 포함하기

여러 엔드포인트를 사용하는 대신 campaign/trigger/send 엔드포인트를 사용하여 단일 API 호출에 사용자 속성과 트리거 속성을 포함할 수 있습니다.

이러한 객체가 트리거에 포함되면 메시지가 트리거되기 전에 속성이 먼저 처리되어 잠재적인 경합 조건이 제거됩니다. 트리거 속성은 고객 프로필을 업데이트하지 않으며 메시지의 컨텍스트에서만 사용됩니다.

POST를 사용합니다: 사용자 추적(동기화) 엔드포인트

/users/track/sync/ 엔드포인트를 사용하여 커스텀 이벤트 및 구매를 기록하고 고객 프로필 속성을 동기식으로 업데이트하세요. 이 엔드포인트를 사용하여 한 번의 호출로 고객 프로필을 동시에 업데이트하면 잠재적인 경합 조건을 방지하는 데 도움이 됩니다.

시나리오 3: 동작 기반 트리거와 오디언스 필터 매칭하기

오디언스 필터와 동일한 트리거(예: 변경된 속성 또는 커스텀 이벤트 수행)로 액션 기반 캠페인 또는 캔버스를 구성하는 경우 또 다른 일반적인 경합 조건이 발생할 수 있습니다. 사용자가 트리거 이벤트를 수행할 때 오디언스 내에 있지 않을 수 있으며, 이는 캠페인을 수신하거나 캔버스에 입장하지 못함을 의미합니다.

모범 사례

지연 후 오디언스 확인

트리거 기준이 포함된 오디언스 필터를 사용하지 않으려면 전달 전에 오디언스를 확인하는 것이 좋습니다. 예를 들어 캔버스 메시지 단계의 전달 유효성 검사를 사용하여 메시지 전송 시 오디언스가 전달 기준을 충족하는지 추가로 확인할 수 있습니다. 또한 캔버스에 대한 이탈 기준을 활용하여 사용자 여정 중 어느 시점에서든 기준을 충족하는 사용자를 이탈시킬 수 있습니다.

캠페인의 경우 종료 이벤트를 사용하여 트리거 이벤트가 있는 캠페인이 지연 중에 종료 이벤트를 수행하는 사용자에게 메시지를 중단하도록 허용할 수 있습니다.

트리거 이벤트와 함께 고유 필터 사용

필터를 구성할 때 “만일을 대비하여” 중복 필터를 추가할 수 있습니다. 그러나 이러한 중복성으로 인해 더 많은 문제가 발생할 수 있습니다. 대신 트리거가 포함된 필터는 가급적 사용하지 마세요. 경합 조건을 피하는 가장 안전한 경로입니다.

예를 들어 캠페인 트리거가 “구매를 했음”이고 오디언스 필터가 “구매를 한 적이 있음”인 경우, 이러한 중복으로 인해 경합 조건이 발생할 수 있습니다.

트리거 이벤트가 업데이트되었다고 가정하는 오디언스 필터를 피하십시오.

이 모범 사례는 트리거 이벤트를 사용하여 중복 필터를 피하는 것과 유사합니다. 일반적으로 트리거 이벤트가 고객 프로필에 업데이트된다고 가정하는 필터는 실패합니다.

Use Liquid 중단(속성만 해당)

캠페인 및 캔버스 단계에서 Liquid 중단을 사용하여 진입 일정에 트리거 속성이 포함된 오디언스 필터를 사용하지 않도록 하세요. 예를 들어 ‘좋아하는 색상’이라는 배열 속성이 있고 이 속성 배열을 임의의 값으로 업데이트하고 업데이트가 완료된 후 배열에 ‘파란색’이라는 색상이 있는 모든 사용자를 타겟팅하고 싶다고 가정해 보겠습니다. 이 예제에서 오디언스 필터를 사용하면 경합 조건이 발생하여 배열에 ‘파란색’을 처음 추가하는 사용자를 놓치게 됩니다.

이 경우 캠페인에서 트리거 지연을 구현하거나 캔버스에서 지연 단계를 사용하여 일정 시간 동안 고객 프로필이 업데이트되도록 허용한 다음 다음 Liquid 중단 로직을 사용할 수 있습니다:

1
2
3
4
{%assign colors={{custom_attribute.$(Favorite Color)|split:”,”}}%}
{%unless colors contains ‘Blue’%}
{%abort_message(Blue not present)%}
{%endunless%}

사용자 데이터 관리 방법 확인

캔버스 응모 평가 중에 경합 조건이 있는 경우, 사용자가 응모하지 않아야 할 캔버스에 응모할 수 있습니다. 예를 들어, 사용자의 프로필을 오디언스에 포함되도록 설정한 후 캔버스에서 해당 사용자가 더 이상 오디언스에 포함되지 않도록 대기열에 추가한 후에 업데이트할 수 있습니다.

사용자 데이터가 어떻게 관리되고 업데이트되는지, 특히 특정 속성이 언제 어떻게 업데이트되는지(예: 소프트웨어 개발 키트, API, 배치 API 및 기타 방법)를 확인하는 것이 좋습니다. 이를 통해 사용자가 캠페인이나 캔버스에 들어온 이유와 사용자 프로필이 업데이트된 시기를 식별하고 명확하게 파악할 수 있습니다.