플로우에서 웹후크 이해하기

학습 내용

플로우에서 웹후크가 무엇인지와 Klaviyo에서 타사 도구 및 애플리케이션으로 정보를 전송하는 방식에 대해 알아보세요. 웹후크 설정은 복잡할 수 있다는 점에 유의하세요. 이 설정을 올바르게 완료하려면 개발 지식 또는 개발 리소스가 있는 것이 좋습니다. 이러한 개발 안내를 찾고 있다면 플로우에 웹후크 작업을 추가하는 방법을 알아보세요.

웹후크란 무엇인가요?

간단히 말해, 웹후크는 모든 마케팅 및 데이터 도구가 서로 소통할 수 있는 포괄적인 방법을 제공합니다. 예를 들어, 온라인 뱅킹과 신용카드의 사기 방지 기능이 어떻게 작동하는지 상상해 볼게요. 누군가가 사기성으로 카드를 사용하면 해당 거래는 소매업체에 기록되고 은행으로 전송되며, 은행은 이를 분석한 다음 카드에 문제가 있을 때 전화나 이메일로 알려 줍니다. 이 구매로 인해 여러 시스템이 서로 통신하고, 이 데이터를 이동시키며, 최종적으로 알림을 보내게 되었습니다. 이러한 시스템은 웹후크를 사용해 이 데이터를 전달하고 있을 가능성이 높습니다. 웹후크:

• HTTP 요청을 통해 애플리케이션이 정보를 전달하거나 다른 애플리케이션, 도구, 서버를 “호출”할 수 있도록 하세요.
• 발생한 이벤트에 대한 정보를 전송해요(예: 주문 완료, 신규 고객 구독 등).
• 이벤트가 발생했음을 시스템에 알리거나 해당 이벤트에 대해 알림을 받을 수 있어요.

그러면 이 이벤트 정보는 선택한 방식과 위치로 전달돼요. 즉, 웹후크는 Klaviyo 내의 데이터와 정보를 원하는 방식으로 다른 마케팅 도구 및 툴로 공유할 수 있는 유용한 방법을 제공해요.

웹후크의 주요 구성 요소

웹후크는 몇 가지 구성 요소로 이루어져 있어요:

• 트리거
  웹후크가 실행되도록 하는 이벤트
• 메시지(또는 “페이로드”)
  웹후크가 전송하는 내용으로, 트리거링 이벤트에 대한 주요 세부 정보, 메시지가 전송되는 이벤트 URL 또는 메시지를 수신하는 시스템의 URL 등이 포함돼요.
• 헤더
  추가 정보(예: 인증)를 전달하는 곳

플로우의 웹후크

웹후크는 현재 플로우 내에서만 사용할 수 있으며, 플로우가 특정 단계 또는 단계에 도달하면 전송돼요. 그런 다음 웹후크가 플로우를 트리거한 이벤트 또는 수신자에 관한 데이터가 포함된 POST 요청을 전송해요.

웹후크 전송은 하나의 이벤트만 시작할 수 있다는 점이 중요해요. 구독자가 트리거 기준을 충족하면 웹후크가 실행되어 지정된 URL로 메시지를 전송해요. 또한 플로우 트리거로 사용할 수 있는 이벤트, 즉 플로우 트리거 이벤트에서만 웹후크를 보낼 수 있어요. 예를 들어 프로필은 변경만으로는 플로우를 직접 트리거할 수 없기 때문에, 프로필 속성 변경을 기준으로 웹후크를 보낼 수 없어요.
Klaviyo의 이벤트 예시는 다음과 같아요:

• '완료된 주문'
• 결제 시작
• 목록 구독

웹후크 사용 사례

웹후크를 생성할 수 있는 플로우 트리거와, 다른 애플리케이션에서 이를 구현하는 방법에 대한 몇 가지 실용적인 사용 사례를 이해하는 것이 중요해요.

예를 들면 다음과 같아요:

• 휴면 고객의 재참여를 유도하기 위해 메시지를 보냅니다.
• 고객의 생일에 메시지를 보내고, 로열티 포인트 형태로 선물을 제공하는 것.
• 새 구독자가 리스트에 가입할 때마다 웹후크를 전송해요. 프로필 데이터를 다른 플랫폼으로 전송할 수 있어요.
• 구독자에 대해 더 자세히 알아보기 위해 고객에게 NPS 설문조사를 보내기.
• 구독자가 세그먼트 또는 리스트에 추가되는 것을 기준으로 트리거되는 메시지 또는 POST 요청을 전송하는 경우예요. 단, “Received Email” 이벤트는 플로우 트리거로 지원되지 않는다는 점에 유의하세요.

실제 사례

고객과 온라인 및 우편으로 소통할 수 있도록 Klaviyo를 DM 도구에 연결하기로 결정했어요. 새 고객 Shah가 웹사이트에 방문해 전자상거래 스토어에서 몇 가지 상품을 구매했어요. 나중에 Shah에게 전체 컬렉션이 담긴 인쇄 카탈로그를 보내고 싶어요.

여기에서 웹후크로 이러한 경험을 연결할 수 있어요. 이미 전자상거래 스토어가 Klaviyo에 연동되어 있을 거예요. Klaviyo에서 Placed Order 이벤트를 기준으로 트리거되도록 플로우를 설정해요. 그런 다음 광고용 메일/다이렉트 이메일 도구의 웹후크를 제공하고, 메시지(즉, 페이로드)에 고객의 이름, 주소, 주문한 항목 등의 세부 정보를 포함해요.

이제 누군가(예: Shah)가 주문하면 이벤트가 시작되어 인쇄 카탈로그가 해당 주소로 발송되도록 할 수 있어요. 웹후크 구매 이벤트는 Klaviyo에서 직접 거의 실시간으로 정보(즉, 메시지 또는 페이로드)가 다이렉트 메일링 도구로 전송되도록 해요.

Klaviyo 웹후크로 할 수 없는 작업은 무엇인가요?

웹후크는 데이터를 양방향으로 동기화하기 위한 용도가 아니에요. 즉, 다른 플랫폼을 Klaviyo에 연결해 Klaviyo에서 해당 플랫폼으로 데이터를 보내는 것은 가능하지만, 데이터를 Klaviyo로 다시 전달할 수는 없어요. 정보는 Klaviyo에서 연결한 지정된 시스템 또는 애플리케이션으로는 전송되지만, 반대 방향으로는 전송될 수 없어요. 웹후크는 API와 달리, 이 단방향 방식으로만 작동해요.

또한 정보를 요청하도록 선택한 이벤트, 이 작업이 얼마나 자주 발생하는지, 그리고 해당 데이터가 궁극적으로 시스템의 어디로 이동하는지도 고려하는 것이 중요해요. Klaviyo는 플로우 데이터를 플랫폼에 연결하기 위한 프레임워크를 제공하지만, 궁극적인 가치는 해당 정보가 Klaviyo를 떠난 후 어디로 이동하는지, 그리고 잠재적으로 무엇을 유도하는지에 따라 달라져요. 따라서 Klaviyo는 웹후크가 작동하는지는 모니터링할 수 있지만, 데이터가 어디로 이동하는지 또는 시스템을 떠난 후 무엇을 하는지는 모니터링할 수 없어요.

마지막으로, 웹후크를 통해 Klaviyo에서 전송할 수 있는 데이터와 전송할 수 없는 데이터를 고려하는 것이 중요해요. Klaviyo의 플로우 트리거가 작동하는 방식 때문에, 특정 데이터 포인트는 웹후크를 통해 전송할 수 없어요. 예를 들어, 구독자가 이메일을 열 때마다 이메일 열람 참여 유도 데이터를 보낼 수는 없어요. 열람을 기준으로 플로우를 트리거할 수 없기 때문이에요.

마찬가지로 이벤트로 트리거되는 플로우에서 웹후크 페이로드에 이벤트 기반 동적 변수를 사용할 수 있지만, 사용 가능한 변수는 플로우를 트리거한 원래 이벤트에 연결돼 있어요(즉, 플로우 이메일과 동일해요). 예를 들어 Started Checkout 이벤트로 트리거되는 장바구니 이탈 플로우가 있다면, 웹후크 페이로드에서 해당 이벤트의 동적 변수를 사용할 수 있어요. 하지만 같은 플로우에서 Added to Cart 지표를 사용하는 플로우 필터 또는 분할도 함께 사용 중이라면, 이 추가 데이터는 웹후크 페이로드에 포함할 수 없어요.

따라서 웹후크를 설정할 때는 데이터 포인트에 대해 플로우에서 지원할 수 있는 항목과 웹후크 설정으로 달성하려는 목표가 무엇인지 고려하는 것이 중요해요.

현재 플로우 웹후크에서는 쿠폰 코드, 웹 피드 및 제품 피드가 지원되지 않아요.

누가 웹후크를 설정해야 하나요?

위에서 언급했듯이 Klaviyo에 연결하는 시스템, 정보나 데이터가 패키징되는 방식, 가져올 데이터나 정보를 선택하는 것은 모두 전적으로 재량에 달려 있어요.

이를 염두에 두고, Klaviyo에서 올바른 이벤트가 전송되고 애플리케이션에서 올바르게 게시되도록 웹후크를 설정할 수 있는 개발 리소스를 준비하는 것을 강력히 권장해요. 또한 웹후크가 실패하면 Klaviyo에서 오류도 제공해요. 하지만 웹후크 설정의 더 깊은 문제나 데이터가 최종적으로 애플리케이션에 게시되는 방식은 진단하지 못할 수도 있어요.

요구 사항 및 고려 사항

동반 시스템에서 웹후크를 올바르게 설정하고 테스트할 수 있도록 개발자 리소스를 확보하는 것 외에도, Klaviyo에는 이 기능을 사용하기 위한 몇 가지 주요 요구 사항이 있어요.

• 플로우를 만들 수 있는 액세스 권한이 있는 사용자 역할만 Klaviyo에서 웹후크를 설정할 수 있어요. 여기에는 매니저, 관리자, 소유자 역할이 포함돼요.
• 보안을 강화하려면, 웹후크를 사용하거나 기존 플로우 내에 새 웹후크 작업을 추가하려면 계정에서 2단계 인증 을(를) 활성화해야 합니다.

설정할 준비가 되셨나요?

웹후크는 Klaviyo의 데이터를 다른 외부 시스템이나 애플리케이션으로 전달하는 강력한 메커니즘을 제공해요. 웹후크를 설정할 준비가 되었다면, 플로우에 웹후크 작업을 추가하는 방법에 대한 개발자 문서 가이드를 읽어보세요.

추가 자료