Tajo는 거버넌스가 적용된 동기화 규칙을 통해 소스 시스템의 데이터를 Brevo로 이동합니다. 사람이 승인하고, 한 방향으로만 흐르며, 일정에 따라 실행되고, 처음부터 끝까지 기록됩니다. 이 문서에서는 이것이 실제로 무엇을 의미하는지, 그리고 무엇이 포함되지 않는지를 설명합니다.
시작 전 확인 이 문서는 Shopify와 Brevo를 연결하고 동기화 규칙을 하나 이상 게시했다는 전제하에 작성되었습니다. 아직이라면 Tajo를 Shopify에 연결하기부터 시작하세요.
동기화의 구조
Tajo의 모든 동기화는 동기화 규칙입니다. 무엇이 어떻게 이동하는지를 검토·승인한 정의입니다. 규칙은 네 부분으로 구성되며, 커넥터 > 동기화의 규칙 페이지에서 확인할 수 있습니다.
| 구성 요소 | 역할 |
|---|---|
| 필드 매핑 | 각 소스 필드, 기록될 Brevo 필드, 그 사이에 적용되는 변환 |
| 필터 표현식 | 레코드별로 평가되며, 조건에 맞지 않는 레코드는 건너뜁니다 |
| 커서 | 동기화 진행 위치를 추적하여, 각 실행이 이전 실행이 멈춘 지점부터 이어가도록 합니다 |
| 실행 기록 | 모든 실행과 그 읽기·기록·실패 레코드 수, 소요 시간, 상태 |
데이터는 한 방향, 즉 소스에서 Brevo로만 흐릅니다. Tajo는 Shopify에 데이터를 다시 기록하지 않습니다.
데이터가 동기화되는 시점
동기화는 예약된 배치로 실행되며, 규칙 페이지에서 실행을 트리거하면 요청 시에도 실행됩니다. Tajo는 실시간 파이프라인이 아닙니다. Shopify의 변경 사항은 몇 초 안이 아니라 다음 실행 때 Brevo에 도달합니다. 이는 의도된 설계입니다. 배치 실행이기에 모든 기록이 검토 가능하고, 예산이 관리되며, 감사 추적에서 특정 실행에 귀속될 수 있습니다.
각 실행은 커서 이후의 신규·변경 레코드를 읽고, 필터를 적용하고, 필드를 매핑한 뒤 Brevo에 기록합니다. 실행 레코드에는 읽고, 기록하고, 실패한 레코드 수가 정확히 표시됩니다.
거버넌스 보장
동의는 실패 시 차단됩니다
동의 정책 없이는 동기화 규칙을 게시할 수 없으며, 실행 시점에 동의를 입증할 수 없는 레코드는 기록되지 않습니다. 동의를 확인할 수 없을 때 Tajo는 추측하지 않고 기록을 거부합니다. 실패의 방향은 언제나 “지나치게 신중한” 쪽이지, “과잉 발송” 쪽이 아닙니다.
실행은 멱등합니다
모든 기록에는 소스 레코드에서 파생된 출처 키(provenance key, 개인정보가 드러나지 않도록 설계됨)가 부여됩니다. 따라서 실패 후, 일시 중지 후, 또는 수동으로 동기화를 다시 실행해도 중복 기록이 생기지 않습니다. 규칙은 언제 다시 실행해도 안전합니다.
모든 것이 감사됩니다
규칙 게시, 모든 승인 결정(서면 사유 포함), 모든 실행이 감사 추적에 기록됩니다. 게시를 허가한 승인은 검토된 규칙 버전 자체에 결속되며, 규칙을 수정하면 승인이 무효화됩니다. 따라서 감사 추적은 실제로 허가된 내용을 항상 정확히 반영합니다.
실패가 반복되면 규칙이 일시 중지됩니다
실행이 연속으로 여러 번 실패하면 서킷 브레이커가 규칙을 자동으로 일시 중지하고 마지막 오류를 규칙 페이지에 표시합니다. 원인을 해결한 뒤 다시 게시하면 재개됩니다. 부분적으로 실패한 실행은 실패 건수를 보고하므로, 무엇이 기록되지 않았는지 정확히 확인할 수 있습니다.
수신 거부는 어떻게 처리되나요
Tajo는 이메일 동의의 기준 정보(source of truth)를 Brevo로 취급합니다.
- 연락처가 Brevo 이메일 하단의 링크로 수신을 거부하면, 그 옵트아웃이 연락처에 기록되고 Brevo가 이후 캠페인에서 해당 연락처를 제외합니다.
- Brevo에서 블랙리스트에 오른 연락처는 계속 제외됩니다. 이후의 발송이 이들을 되살리지 않습니다.
- Tajo는 수신 거부 상태를 Shopify로 다시 밀어 넣지 않습니다. Shopify에서도 이메일 동의를 수집한다면 그곳에서 별도로 관리하세요. 두 시스템이 서로를 미러링한다고 가정하면 안 됩니다.
어떤 데이터를 사용할 수 있나요
무엇이 동기화되는지는 소스에 제공되는 템플릿에 따라 다릅니다. Shopify의 경우 일반적으로 고객 레코드입니다. 식별 필드와, 총 구매 금액·주문 수 같은 주문 기반 속성이 세그먼트와 캠페인에서 사용할 수 있는 Brevo 연락처 속성으로 매핑됩니다. 워크스페이스의 정확한 매핑은 설명문 속에 숨어 있지 않습니다. 동기화 규칙을 열어 필드 매핑 표를 읽으세요. 그 표가 “무엇이 동기화되는가”에 대한 공식적인 답입니다.
Tajo가 현재 하지 않는 것
긴 기능 목록보다 경계를 정확히 하는 것이 더 중요합니다.
- 양방향 동기화는 없습니다. 수신 거부도, 태그도, 참여 점수도 Shopify로 다시 기록되지 않습니다.
- 실시간 동기화는 없습니다. 실행은 예약되거나 수동으로 트리거되는 배치이며, 1분 미만의 스트리밍이 아닙니다.
- 재고 추적은 없습니다. 상품 재고 수준을 모니터링하지 않으며, 재입고 트리거도 없습니다.
이 경계 중 하나가 사용 사례를 가로막는다면 팀에 알려 주세요. 얼리 액세스의 우선순위는 바로 이런 피드백으로 결정됩니다.
데이터를 확인하는 곳
- Tajo에서: 커넥터 > 동기화에서 동기화 규칙을 열면 실행 기록, 커서 위치, 실행별 건수를 볼 수 있습니다. 감사 추적에는 게시와 승인이 기록됩니다.
- Brevo에서: 연락처를 열고 아무 연락처의 속성을 살펴 매핑된 필드에 값이 채워지는지 확인하세요. 해당 속성으로 타기팅용 세그먼트를 만들 수 있습니다.
문제 해결
- Brevo에 연락처가 나타나지 않을 때: 규칙의 최신 실행에 실패가 있는지, 상태가 어떤지 확인하세요(일시 중지된 규칙은 실행되지 않습니다). Brevo에 연락처가 없을 때를 참고하세요.
- 실행이 반복해서 실패할 때: 서킷 브레이커가 규칙을 일시 중지하고 마지막 오류를 표시합니다. 데이터가 동기화되지 않을 때를 참고하세요.
- 연락처가 중복될 때: 기록은 소스 레코드 단위로 멱등하지만, Brevo에 원래 있던 중복은 그대로 남습니다. 중복 연락처를 참고하세요.
자주 묻는 질문
동기화를 더 빠르게 할 수 있나요? 동기화 규칙 페이지에서 언제든지 요청 시 실행을 트리거할 수 있습니다. 실시간 모드는 없습니다.
실행이 중간에 실패하면 어떻게 되나요? 실행은 실패 건수를 보고하고, 커서는 처리된 범위만큼만 전진합니다. 다음 실행이 남은 구간을 안전하게 다시 처리하며, 멱등 키가 중복을 방지합니다.
동기화 내용을 변경할 수 있나요? 네. 규칙의 필드 매핑이나 필터를 수정하세요. 수정하면 새 버전이 생성되며, 적용되기 전에 다시 게시 승인을 거쳐야 합니다.
규칙이 왜 저절로 일시 중지됐나요? 연속된 실행 실패가 서킷 브레이커를 작동시켰기 때문입니다. 규칙 페이지에 실패 횟수와 마지막 오류가 표시됩니다. 문제를 해결하고 다시 게시하세요.
관련 문서
도움 받기
- 라이브 채팅: Tajo 대시보드에서 이용 가능(우측 하단)
- 이메일 지원: [email protected]
- 문서: docs.tajo.io