자세히 알아보기

전환 API(서버) 이벤트는 무엇인가요?

서버 이벤트는 고객의 장바구니 담기, 구매와 같은 이벤트를 카페24 서버에서 페이스북 서버로 바로 전송하는 것이에요.

[관리자] 판매 채널 > 페이스북 > 메타 채널의 채널 설정을 완료하면 쇼핑몰에 픽셀이 설치되고 이 픽셀을 통해 브라우저에서 발생한 구매자의 장바구니 담기, 구매와 같은 이벤트를 전송해요. 

하지만 브라우저 이벤트 특성상 쿠키 차단 등의 사유로 데이터가 유실될 가능성이 있기 때문에 카페24 메타 채널은 더 정확한 데이터 전송을 위해 브라우저 이벤트(Pixel) 뿐 아니라 서버 이벤트도 제공하고 있어요.

픽셀(브라우저) 이벤트와 서버 이벤트를 같이 사용하면 어떤 장점이 있나요? 

브라우저 이벤트(Pixel)과 함께 서버 이벤트를 사용하면 다음과 같은 장점이 있어요.

1. 안정적인 데이터 공유 
   GDPR(쿠키 동의 등), adblocker, iOS 14 ATT(App Tracking Transparency) 워크프레임 업데이트 등 광고 업계가 소비자의 개인 정보를 더 안전하게 보호하는 방향으로 발전하고 있어요.
   이에 따라 브라우저의 픽셀을 통한 고객 행동 이벤트 추적 및 광고 게재 최적화 정확도는 점점 떨어질 수 있어요. 따라서 환경 변화의 영향을 최소화하고 사용자들의 더 안정적인 데이터 공유를 지원하기 위해 카페24 메타 채널은 서버 이벤트 전송 기능을 제공해요.
    

2. 보다 정확한 데이터 제공
    

   외부 결제 서비스(네이버페이 등)를 통해 고객이 쇼핑몰을 이탈하여 결제를 완료한 경우 픽셀로는 측정할 수 없어요. 하지만 서버 이벤트는 주문 고객이 카페24 쇼핑몰을 벗어나더라도 완료된 구매 이벤트에 대한 데이터를 서버 이벤트로도 전송할 수 있어요.
   서버 이벤트 전송을 통해, 발생되는 이벤트 데이터의 정확도를 높일 수 있으며 더 깊은 경로의 추적도 가능해져요. 

어떠한 이벤트들이 제공되나요?

카페24 메타 채널에서는 아래와 같은 브라우저 이벤트, 서버 이벤트가 제공돼요. 

1. 브라우저 이벤트 - 모바일 쇼핑몰에도 동일하게 적용돼요.
   [관리자] 판매 채널 > 페이스북 > 메타 채널의 '채널설정'에서 제공되는 브라우저 이벤트는 다음과 같아요.
    
   • 전체 페이지 : 페이지뷰(Pageview)
   • 상품 상세 페이지 : 콘텐츠 조회(ViewContent)
   • 장바구니 페이지: 장바구니에 담기(AddToCart)
   • 주문서 작성 페이지: 결제 시작(InitiateCheckout)
   • 주문 완료 페이지: 구매(Purchase)
   • 상품 검색 페이지: 검색(Search)
   • 회원가입 완료 페이지: 등록 완료(CompleteRegistration) 
      

2. 서버 이벤트 - 모바일 쇼핑몰에도 동일하게 적용돼요.
   [관리자] 판매 채널 > 페이스북 > 메타 채널의 '채널설정'에서 제공되는 서버 이벤트는 다음과 같아요.
    

   • 상품 조회 페이지 : 상품 조회(Viewcontent)
   • 장바구니 페이지: 장바구니에 담기(AddToCart)
   • 주문서 작성 페이지: 결제 시작(InitiateCheckout)
   • 주문 완료 페이지: 구매(Purchase)
      
    

   Info

   서버 이벤트 종류는 지속적으로 추가될 예정이에요. 

픽셀/전환 API 이벤트 설정 방법이 어떻게 되나요?

1. [관리자] 판매 채널 > 페이스북 > 메타 채널 '홈' 메뉴에서 페이스북 로그인 후 이어지는 팝업 또는 '설정 시작하기' 클릭 후 생성되는 팝업창에서 채널 설정을 완료해 주세요.
2. '홈' 화면의 '픽셀/전환 API 이벤트' 영역에서 '정확성 높이기'를 클릭하거나 '채널설정' 메뉴를 클릭해서 '픽셀/전환 API 이벤트 설정' 항목을 선택해 주세요.
3. '브라우저/서버 이벤트'에서 '브라우저+서버' 옵션을 선택한 후 저장 버튼을 클릭해 주세요.

메타 채널에서 서버 이벤트를 설정하면 어떤 이점이 있나요?

간편하고 빠르게 설정할 수 있어요.
메타 서버로 서버 이벤트를 전송하려면 전환 API를 사용하여야 해요.
메타 채널을 통하면 수동으로 API를 설정할 필요 없이 채널 설정 완료와 함께 바로 사용하실 수 있어요.
▶ 메타 전환 API 정보 도움말 바로 가기 (클릭)

전송된 데이터의 성과는 어떻게 확인할 수 있나요?

• 메타 이벤트 관리자 > 데이터 소스에서 데이터를 확인하실 수 있어요.
• 만약 브라우저 이벤트와 서버 이벤트를 둘 다 사용하는 경우, 메타 이벤트 관리자 > 데이터 소스 > 개요 > 하단 표에서 연결 방법이 브라우저·서버로 표시돼요.
• 단, 브라우저 이벤트와 서버 이벤트가 동시에 전송되었을 때 중복 데이터는 제거되며 메타에서 먼저 수신한 데이터를 우선으로 표시해요.
• 브라우저 이벤트와 서버 이벤트가 비슷한 시간에 전송되었다면 메타는 브라우저 이벤트를 우선적으로 수신해요.
• 상세 데이터는 메타 이벤트 관리자 > 데이터 소스 > 개요 > 하단 표 > 이벤트 명 클릭 > 데이터 내보내기에서 확인하실 수 있어요.

네이버페이 구매 전환 서버 이벤트

• 네이버페이 구매 전환 서버 이벤트(NPayConversion) 커스텀 이벤트는 브라우저/서버 이벤트 오픈 후 페이스북 이벤트 관리자에서 별도로 확인할 수 없어요.
• 이는 iOS 14.3 ATT(App Tracking Transparency) 출시로 인한 페이스북의 '도메인 당 이벤트 최적화 8개 제한' 정책을 대응하고 기존 이벤트 분석 결과에 따라 데이터를 가장 효율적으로 보내기 위한 방안임을 참고해 주세요.
• 이에 따라 네이버페이 관련 이벤트는 아래와 같이 집계돼요.
  • 브라우저 이벤트 : 네이버페이 버튼 클릭 시 주문서 작성(initiateCheckout)
  • 서버 이벤트 : 네이버페이 버튼 클릭 시 주문서 작성(initiateCheckout)
• 네이버페이의 경우, [관리자] 판매 채널 > 네이버 > 네이버 페이 설정 > '서비스 설정 > 신청정보관리'의 '주문연동'이 '사용함' 상태의 경우에만 데이터가 전송되니 반드시 설정을 확인해 주세요.

톡체크아웃 구매 전환 서버 이벤트

톡체크아웃 관련 이벤트는 아래와 같이 집계돼요.

• 브라우저 이벤트 : 톡체크아웃 전송하지 않음
• 서버 이벤트 : 톡체크아웃 버튼 클릭 시 주문서 작성(initiateCheckout) 이벤트 집계

이벤트 관리자 진단 문제

전환 API 설정 후 다음과 같은 진단 문제가 발견될 경우 문제 해결 방법에서 '해결됨으로 표시' 버튼을 클릭해 주세요.

여러 이벤트 인스턴스에 대해 동일한 이벤트 ID가 수신됨

브라우저 픽셀과 전환 API가 충돌하여 '여러 이벤트 인스턴스에 대해 동일한 이벤트 ID가 수신됨' 진단 문제가 나타날 수 있어요. 이는 오류가 아니며 event_id 매개변수로 인해 브라우저 이벤트와 서버 이벤트가 동시에 전송되었을 때 중복 이벤트가 제거되고 있음을 의미해요.

Server Sending Invalid Match Key Parameters for CheckConversionsAPI Event

여기서 CheckConversionsAPIEvent는 전환 API 사용 여부 확인을 위한 맞춤 이벤트로 데이터를 기록하거나 맞춤 타겟 설정을 위한 용도로 활용할 수 없어요.

채널 재설정 알림

전환 API 설정 후 다음과 같은 알림 메시지가 확인될 경우 '업데이트' 버튼을 클릭해 주세요.
페이스북 사용자 정보 변동 등이 발생하면, 채널 재설정을 통해 다시금 페이스북 Cafe24 앱 권한 사용에 동의해야 해요.
채널 설정이 정상적이지 않으면 페이스북 채널 사용이 원활하지 않을 수 있는 점 참고해 주세요.