Skip to main content
홈블로그가이드구매 후 서비스 제공업체가 추적 데이터를 활용해 하나의 API로 여러 브랜드에 서비스를 제공하는 방법

구매 후 서비스 제공업체가 추적 데이터를 활용해 하나의 API로 여러 브랜드에 서비스를 제공하는 방법

17TRACK

구매 후 서비스 제공업체는 배송 업데이트를 중앙에서 수집하고, 각 배송을 올바른 브랜드와 주문에 연결하며, 각 고객의 자체 채널을 통해 브랜드별 경험을 제공함으로써 하나의 추적 API 통합으로 여러 브랜드를 지원할 수 있습니다. 공유 연결은 추적 데이터 수집을 간소화할 뿐이며, 모든 브랜드에 대해 별도의 고객 데이터, 메시지 규칙, 권한 및 서비스 워크플로가 필요하다는 점을 없애지는 않습니다.

구매 후 서비스 제공업체가 추적 데이터를 활용하는 방법

이 모델은 여러 판매자를 대신해 배송 커뮤니케이션을 관리하는 대행사, 고객 지원 플랫폼, 주문 처리 파트너 및 기타 제공업체에 유용합니다. 실무적인 질문은 단순히 하나의 API가 추적 상태를 반환할 수 있는지가 아닙니다. 제공업체가 해당 상태를 신뢰할 수 있고 적절하게 브랜드화된 조치로 전환하면서 한 고객의 데이터를 다른 고객에게 노출하지 않을 수 있는지가 핵심입니다.

공유 API가 실제로 하는 일

추적 API는 서비스 제공업체가 배송 식별자를 프로그래밍 방식으로 제출하거나 조회하고 추적 정보를 받을 수 있도록 합니다. 모든 판매자마다 별도의 운송업체 연동을 구축하는 대신, 제공업체는 공통된 상위 연결을 통해 자체 애플리케이션에서 추적 데이터를 사용할 수 있게 합니다. 그런 다음 제공업체의 애플리케이션이 배송의 소유 브랜드와 해당 정보를 처리할 방법을 결정합니다.

이러한 구분은 중요합니다. 하나의 추적 API가 하나의 공유 고객 계정, 하나의 추적 페이지 또는 하나의 알림 템플릿을 의미하는 것은 아닙니다. 상위 연동은 데이터 수집을 담당합니다. 서비스 제공업체는 판매자 온보딩, 주문 매칭, 고객 대상 언어, 접근 제어, 지원 도구 및 전달된 내용의 기록을 포함한 하위 제품을 계속 책임져야 합니다.

실용적인 아키텍처는 세 개의 계층으로 구성됩니다. 첫째, 수집 계층은 배송 참조 정보를 받아 추적 업데이트를 가져옵니다. 둘째, 내부 배송 기록은 해당 업데이트를 올바른 판매자, 주문, 운송업체 및 수취인과 연결합니다. 셋째, 표시 계층은 판매자의 규칙을 사용해 주문 페이지를 업데이트할지, 지원 담당자에게 알릴지 또는 고객에게 메시지를 보낼지 결정합니다. 이러한 계층을 분리하면 추적 연결을 다시 작성하지 않고도 다른 브랜드를 추가하기가 쉬워집니다.

등록부터 고객 조치까지 하나의 배송을 추적하기

서로 관련 없는 두 온라인 스토어의 배송 업데이트를 관리하는 제공업체를 생각해 보겠습니다. 두 스토어 모두 배송 정보를 제공업체에 보내지만, 각 기록에는 테넌트 식별자가 포함되어야 합니다. 이는 해당 기록을 소유한 브랜드를 나타내는 제공업체 내부의 명확한 키입니다. 제공업체는 배송을 주문과 연결할 수 있을 만큼 충분한 정보도 필요합니다. 배송 추적 번호만으로는 안전한 전역 키가 아닐 수 있습니다. 배송에 서로 다른 운송업체가 관여하거나, 식별자가 재사용되거나, 원래 주문 데이터가 수정될 수 있기 때문입니다.

  1. 배송을 등록합니다. 브랜드 식별자, 주문 참조 정보, 추적 번호 및 매칭에 필요한 기타 허용된 정보를 받습니다. 추적 데이터를 요청하기 전에 입력값을 검증합니다. 가능한 경우 인증 정보와 고객 연락처 정보를 일반 추적 이벤트 기록과 분리하여 저장합니다.
  2. 원본 업데이트를 수집하고 보관합니다. 문서화된 방법을 사용해 상위 API를 통해 추적 정보를 가져옵니다. 제공되는 경우 원본 상태, 이벤트 설명, 타임스탬프 및 위치를 보존합니다. 원본 이벤트를 단순화된 라벨만으로 대체하지 마세요. 지원팀이 문제를 조사하려면 원래 표현이 필요할 수 있습니다.
  3. 신중하게 표준화합니다. 원본 이벤트를 배송 중, 배송 출발, 배송 완료 또는 예외와 같은 소수의 내부 상태로 매핑합니다. 원본 이벤트는 해당 매핑과 함께 보관합니다. 광범위한 상태는 자동화에 유용하지만 고객이나 지원 담당자에게 중요한 차이를 숨길 수 있습니다.
  4. 브랜드 규칙을 적용합니다. 어떤 판매자는 배송 출발 이메일을 원할 수 있고, 다른 판매자는 주문 페이지 업데이트만 원할 수 있습니다. 브랜드 설정, 고객의 커뮤니케이션 선호도, 이벤트의 최신성 및 이미 발송된 메시지 이력을 사용해 알림 여부를 결정합니다.
  5. 결과를 기록합니다. 어떤 이벤트가 어떤 조치를 촉발했는지, 어떤 브랜드 정책이 적용되었는지, 하위 채널로의 전달이 성공했는지를 저장합니다. 이를 통해 중복 알림과 고객 불만을 해결할 수 있는 추적 기록을 확보할 수 있습니다.

따라서 동일한 상위 상태가 브랜드마다 서로 다른 조치를 일으킬 수 있습니다. 이것이 공유 서비스 모델의 핵심입니다. 수집과 운영 유지 관리는 중앙화하면서 각 판매자의 고객 관계는 유지하는 것입니다.

확장 가능성을 좌우하는 설계 결정

테넌트 소유권을 명확히 하세요

모든 배송, 이벤트, 주문 매핑, 알림 규칙 및 고객 대상 링크는 특정 테넌트로 연결되어야 합니다. 데이터가 시스템에 들어올 때와 애플리케이션 또는 지원 사용자가 데이터를 읽을 때 모두 테넌트 소유권을 확인하세요. 판매자 브랜드 페이지는 어떤 고객 기록을 표시할지 결정하기 위해 추적 번호 하나에만 의존해서는 안 됩니다. 인증된 판매자 또는 적절한 범위로 제한된 고객 링크를 통해 접근을 제한해야 합니다.

상위 제공업체가 제공하는 실제 계정 모델과 각 판매자와의 계약 관계에 따라 인증 정보와 권한을 분리하세요. 하나의 기술적 통합이 모든 판매자 데이터를 자동으로 통합하거나 모든 고객에게 동일한 가시성을 부여하는 것은 아닙니다. 누가 배송을 등록하고, 이벤트를 조회하고, 기록을 내보내며, 알림 설정을 변경할 수 있는지 문서화하세요.

추적 이벤트를 보장된 명령이 아닌 업데이트로 다루세요

추적 정보는 지연되어 도착하거나 순서가 뒤바뀌거나 수정 내용을 포함할 수 있습니다. 이벤트를 읽을 때마다 새 메시지를 보내는 시스템은 중복되거나 오해를 불러일으키는 이메일을 발송할 위험이 있습니다. 원본에서 안정적인 이벤트 키를 제공하면 이를 사용하고, 그렇지 않다면 이용 가능한 배송 및 이벤트 필드를 사용해 문서화된 중복 제거 규칙을 정의하세요. 제공업체가 업데이트를 관찰한 시점과 원본이 보고한 이벤트 시간을 별도로 저장하세요.

모든 배송이 동일한 상태 순서를 따른다고 가정하지 마세요. 예외가 나중에 해결될 수 있고, 더 늦게 도착한 이벤트가 실제로는 더 이른 물리적 스캔을 설명할 수도 있습니다. 상태를 사용해 약속이나 에스컬레이션을 촉발하기 전에 오래된 정보, 충돌하는 정보 또는 누락된 정보를 애플리케이션이 어떻게 처리할지 결정하세요. 배송과 같은 고객 대상 주장의 경우, 내부 라벨이 원본 기록보다 더 많은 것을 증명하는 것처럼 암시하지 말고 근거가 되는 이벤트를 표시하세요.

폴링, 콜백 및 장애에 대비하세요

제공업체의 업데이트 전략은 상위 API의 실제 문서를 따라야 합니다. 관련 계정 및 이벤트 유형에 콜백을 사용할 수 있더라도 애플리케이션은 수신 요청을 인증하고, 재시도를 처리하며, 중복 전달을 안전하게 처리해야 합니다. 폴링을 사용하는 경우 문서화된 제한을 준수하고 불필요한 반복 요청을 피하는 일정을 마련해야 합니다. 어느 방식도 업데이트 누락이나 하위 알림 실패에 대한 복구의 필요성을 없애지는 않습니다.

HTTP 응답도 올바르게 해석해야 합니다. 예를 들어 요청이 수락되었다고 해서 배송에 새로운 추적 이벤트가 이미 수신되었다는 의미는 아닙니다. HTTP Semantics 사양은 응답 코드의 의미를 정의하며, 배송 등록 또는 조회와 관련해 특정 API 응답이 무엇을 의미하는지는 추적 제공업체의 자체 문서에서 정해야 합니다. 기술적 장애뿐 아니라 유효한 응답을 받았지만 주문과 매칭할 수 없는 경우와 같은 비즈니스 장애도 모니터링하세요.

추적 API를 선택하기 전에 확인할 사항

다중 브랜드 제공업체에게 가장 적합한 통합은 단순히 샘플 추적 결과를 반환하는 통합이 아니라 전체 운영 모델에 맞는 통합입니다. 잠재적인 제공업체에 실제로 처리하는 배송 및 워크플로를 문서화된 API가 어떻게 지원하는지 보여 달라고 요청하세요. 짧은 개념 증명에는 여러 판매자, 해당 판매자가 사용하는 운송업체 및 하나 이상의 불완전하거나 문제가 있는 배송 기록이 포함되어야 합니다.

  • 배송 접수: 어떤 식별자와 운송업체 정보가 필요한가? 잘못되거나 중복된 제출은 어떻게 보고되는가? 애플리케이션이 자체 주문 또는 테넌트 참조 정보를 요청과 연결할 수 있는가, 아니면 해당 연결이 전적으로 자체 데이터베이스에 남아야 하는가?
  • 업데이트 전달: 관련 요금제에서 업데이트를 가져오는가, 푸시하는가, 아니면 둘 다 가능한가? 문서화된 요청 한도, 재시도 기대사항, 인증 방식 및 오류 응답은 무엇인가? 높은 수준에서 설명된 기능이 모든 구성에서 제공된다고 가정하지 말고 현재 문서와 대조해 확인하세요.
  • 이벤트 품질: 어떤 원본 필드가 반환되며 타임스탬프, 운송업체 이름, 위치 및 배송 관련 이벤트를 어떻게 해석해야 하는가? 온보딩하는 판매자의 실제 배송 사례로 테스트하세요.
  • 테넌트 운영: 제공업체가 자체 시스템 내에서 고객별 접근 권한, 사용량 집계 및 지원 조사를 분리할 수 있는가? 상위 계정의 분리가 필요하다면 아키텍처를 확정하기 전에 해당 기능이 지원되는지와 지원 방식이 무엇인지 확인하세요.
  • 데이터 처리: 어떤 고객 또는 배송 정보를 상위 시스템으로 보내야 하는가? 해당 데이터의 책임자들과 보존, 삭제, 보안 및 계약상 요구사항을 검토하세요. OWASP API Security Project를 포함한 API 보안 지침은 권한 부여 및 접근 위험을 검토하는 데 유용한 기준을 제공합니다.

17TRACK의 Tracking API 페이지와 개발자 문서는 공유 추적 통합을 평가하는 제공업체가 참고할 수 있는 출발점입니다. 구현 세부사항은 문서를 기준으로 삼고, 다중 고객 서비스를 구축하기 전에 필요한 방법, 지원되는 배송 시나리오, 접근 조건 및 상업적 계약을 사용 목적에 맞게 확인하세요. 공개 API 페이지 자체만으로 원하는 모든 판매자 워크플로가 지원된다고 볼 수는 없습니다.

제공업체가 통제해야 할 영역

추적 데이터는 구매 후 경험에 정보를 제공할 수 있지만 전체 경험을 결정해서는 안 됩니다. 제공업체는 배송과 판매자 간의 매핑, 고객 연락 규칙 및 업데이트가 불확실할 때 사용할 언어를 관리해야 합니다. 이벤트가 소포가 시설에 도착했다는 사실만 알려 준다면 브랜드 메시지가 배송 예정일을 약속해서는 안 됩니다. 추적 업데이트가 중단된 경우 시스템은 새로운 정보가 없다는 사실과 소포가 분실되었다는 증거를 구분해야 합니다.

지원 워크플로에도 동일한 관심을 기울여야 합니다. 권한이 있는 담당자에게 원본 추적 이벤트, 표준화된 상태, 각 기록의 시간 및 알림 이력을 제공하세요. 이러한 화면은 담당자가 고객이 특정 메시지를 본 이유를 설명하고 추가 조사가 필요한지 판단하는 데 도움을 줍니다. 또한 다중 브랜드 운영을 더 쉽게 감사할 수 있게 합니다. 문제의 원인을 막연히 API 탓으로 돌리는 대신 상위 업데이트, 매칭 오류, 판매자 규칙 또는 메시지 전달 실패로 추적할 수 있습니다.

범위를 좁힌 파일럿으로 시작하세요. 한두 개의 판매자를 연결하고 대표 배송을 등록한 뒤 일반적인 배송 이벤트와 함께 예외, 누락된 운송업체 정보, 중복 업데이트 및 수정된 주문을 테스트하세요. 각 브랜드가 자체 배송만 볼 수 있고, 실패한 알림을 두 번째 고객 메시지를 만들지 않고 재시도할 수 있는지 확인하세요. 이러한 동작이 예측 가능해진 후에만 판매자를 추가하세요. 하나의 API가 통합 작업을 줄일 수는 있지만 브랜드 전반에서 신뢰할 수 있는 서비스는 그 주변에 구축된 통제 기능에서 나옵니다.

FAQ

하나의 추적 API를 사용하면 모든 브랜드가 같은 추적 페이지를 사용한다는 뜻인가요?

아니요. API는 제공업체 애플리케이션에 추적 정보를 제공할 수 있지만 각 브랜드는 자체 페이지 디자인, 도메인 구성, 고객 대상 언어 및 알림 규칙을 유지할 수 있습니다. 이러한 브랜드 경험은 별도로 구현하고 유지 관리해야 합니다.

추적 번호만으로 올바른 브랜드를 식별할 수 있나요?

추적 번호가 유일한 테넌트 식별자여서는 안 됩니다. 배송이 시스템에 들어올 때 명시적인 브랜드 또는 테넌트 키를 저장한 다음 추적 번호를 해당 브랜드의 주문 기록과 연결하세요. 배송 정보를 표시하거나 메시지를 보내기 전에 연결을 다시 확인하세요.

제공업체는 새로운 추적 이벤트마다 알림을 보내야 하나요?

대개 그렇지 않습니다. 일부 이벤트는 반복적이거나 지연되거나 고객에게 도움이 되기에는 너무 기술적일 수 있습니다. 알림 대상 이벤트 유형을 정의하고, 중복을 억제하며, 커뮤니케이션 선호도를 확인하고, 지원 검토를 위해 원본 업데이트를 보존하세요.

다른 판매자를 추가하기 전에 무엇을 테스트해야 하나요?

판매자의 실제 배송 입력값, 운송업체 구성, 주문 매칭, 접근 권한, 알림 규칙 및 예외 처리를 테스트하세요. 추적 데이터가 누락되거나 늦게 도착하는 경우를 포함하고, 어떤 배송 또는 고객 정보도 다른 판매자의 계정으로 넘어갈 수 없는지 확인하세요.

출처