Shopify 마케팅 누적값에서 증분으로 이전: 같은 성과를 다시 더하지 않기
모드 이름만 바꾸면 누적값이 증분으로 더해질 수 있으므로 전환 경계의 기준 누적값과 새 증분을 연결해야 한다.
Shopify 마케팅 누적값에서 증분으로 이전: 같은 성과를 다시 더하지 않기
누적 지표를 증분 전송으로 바꾸는 작업은 옵션만 바꾸는 것으로 끝나지 않는다. 같은 숫자를 다른 모드로 보내면 이전에 계산한 성과가 다시 더해질 수 있다. 전환 시점의 마지막 누적 관측과 이후 차이를 분리해야 과거 합계와 새 전송량의 관계를 설명할 수 있다. [1, 2, 3]
공개 원문이 보여 준 범위
Shopify는 marketingEngagementCreate의 isCumulative 인자를 폐기 예정으로 표시하고 기본값을 false로 바꿨다. 기존 누적 활동은 비누적 전송으로 이전할 수 있다고 공지한다. 공지의 API 버전은 2026-07이다. [1]
입력과 출력에서 확인할 관계
시험 활동의 마지막 승인 누적 관측값과 다음 관측값의 차이를 계산한 뒤 증분으로 전송한다. activity_id, last_cumulative, current_cumulative, emitted_delta를 함께 보관하고 재시도 중복은 별도 항목으로 추적한다. 이전 시점을 고정해야 과거 누적 성과가 새 증분 원장에 다시 더해지는 일을 대사할 수 있다. [1, 3]
승인 기준과 실패 사례
설명용 누적 성과가 20에서 25로 증가했다면 새로운 증분은 5다. 5를 보내면 이전 계약을 충족하지만 모드만 바꾸고 25를 보내면 앞선 성과까지 다시 더한다. 기준은 실제 전송값이 아니라 보관한 두 관측값의 차이에서 구한다. 누적 기준이 초기화된 경우에는 같은 차이 식을 무조건 적용하지 말고 reset 사유와 새 기준을 확인한다. [1, 3]
Truthound를 연결하는 검사 경계
Truthound Core 3.3.2의 ExpressionValidator는 current_cumulative와 last_cumulative의 차이가 emitted_delta와 맞는지 검사할 수 있다. 누적 기준이 초기화되는 상황은 같은 식으로 처리하지 말고 reset 사유를 별도로 남긴다. API 호출과 재시도 멱등성은 전송 계층에서 관리한다. [1, 2, 3]
다른 선택이 필요한 조건
공지 자체가 재시도 멱등성이나 활동 간 합산 규칙을 보장하지 않는다. 전환 시점을 고정하고 누적 원장과 증분 원장을 별도 운영하며 대사한다. 전송값이 이미 비누적이고 이전 누적 활동과 섞이지 않으면 차분 변환은 필요하지 않다. [1, 3]
적용 조건
activity_id, last_cumulative, current_cumulative, emitted_delta 표를 원시 입력과 승인 기준에서 각각 준비하고 행 식별자를 유지한다.
대안
전환 시점을 고정하고 누적 원장과 증분 원장을 별도 운영하며 대사한다.
한계
공지 자체가 재시도 멱등성이나 활동 간 합산 규칙을 보장하지 않는다.
근거
- 사건 확인일
- 대상 확인일
- 수정일
