12CODE

라이브러리 105

메타 전환 API(Conversions API, CAPI) 고도화

105 · 수집일 2026-08-29 · 팩트 7건

핵심 팩트

7건
확실 공식
메타 이벤트 관리자(Events Manager)의 '테스트 이벤트(Test Events)' 도구는 서버사이드(CAPI) 이벤트를 실시간에 가깝게(전송 후 약 30초 이내) 보여준다. 이벤트 관리자에서 데이터 소스(픽셀)를 선택하고 테스트 이벤트 코드(Test Event Code)를 발급받아 서버 페이로드에 포함시키면, 수신 이벤트 목록에서 이벤트명·타임스탬프·소스(Browser/Server)·매칭된 파라미터·중복제거 여부를 확인할 수 있다.
주의테스트 이벤트 코드가 붙은 이벤트는 실제 캠페인 최적화에는 반영되지 않는 테스트 트래픽으로 분류된다. 테스트 데이터는 24시간 동안만 도구에 남아있고 이후 자동 삭제되거나 수동으로 지울 수 있다. (Meta Business Help Center)
확실 공식
브라우저 확장 프로그램(Meta Pixel Helper)은 클라이언트사이드 픽셀 이벤트만 감지하고 서버사이드 CAPI 이벤트는 감지하지 못하므로, CAPI 구현을 검증하려면 반드시 이벤트 관리자의 테스트 이벤트 도구나 실서비스 수신 이벤트(Overview) 탭을 별도로 확인해야 한다.
주의픽셀 헬퍼에서 이벤트가 정상으로 보여도 서버사이드 전송이 별도로 실패하고 있을 수 있으므로 두 경로를 각각 확인해야 한다. (Meta for Developers)
확실 공식
메타의 LDU(Limited Data Use)는 미국 각 주(州) 소비자 프라이버시법(예: 캘리포니아 CCPA 계열) 대응을 위한 메커니즘으로, 픽셀과 CAPI 양쪽에 'data_processing_options' 파라미터(및 관련 state/country 파라미터)를 실어 보내면 메타가 해당 이벤트를 광고 개인화(유사 타겟팅·리타겟팅 확장) 용도로는 쓰지 않고 전환 측정·통계적 모델링 용도로만 제한 처리한다.
주의LDU는 미국 주법 대응에 특화된 메타 자체 기능으로, 한국 개인정보보호법의 마케팅 동의(Opt-in) 요건과 법적 근거·적용 범위가 다르다. 한국 서비스에서는 CAPI로 보내기 전 자체 CRM·회원 DB의 동의 상태 필드를 서버 로직에서 먼저 필터링하는 방식이 실무적으로 더 직접적인 대응이며, 정확한 법적 기준은 개인정보보호위원회 가이드라인이나 사내 법무 검토로 재확인해야 한다. (미확인 — 한국 법제 특화 공식 가이드 미확인, LDU는 미국 사례로만 확인됨)
확실 후기
메타는 Graph API·Marketing API(전환API가 얹혀 있는 기반 API)를 정기적으로 새 버전으로 출시한다(2026-02-18 v25.0 출시 사례). 각 버전은 다음 버전 출시 후 2년이 지나면 만료되며, 만료된 버전으로의 호출은 이후 지원되는 구버전으로 자동 대체(fallback)되거나 실패할 수 있다.
주의정확한 버전별 만료일과 변경 내역은 developers.facebook.com/docs/graph-api/changelog 공식 체인지로그에서 계정이 사용 중인 버전 번호로 직접 확인해야 한다. 버전 고정(pinning) 없이 방치하면 만료 시점에 조용히 폴백되어 파라미터 처리 방식이 달라질 수 있다. (Meta for Developers 공식 체인지로그)
확실 후기
메타는 별도로 존재하던 구(舊) 오프라인 전환 API(Offline Conversions API)를 2025년 5월 14일부로 완전히 종료했고, 오프라인 전환 기능은 전환 API(CAPI)로 통합되어 CAPI의 오프라인 이벤트 전송 방식으로 대체됐다.
주의2025년 5월 이전 구 오프라인 전환 API 문서를 참고해 개발된 레거시 연동이 남아있다면, CAPI 오프라인 이벤트 포맷으로 마이그레이션이 필요하다. (업계 정리 — 공식 발표 기반)
확실 후기
CAPI 구현 방식은 통제 가능성과 초기 리소스가 반비례한다. (1) 메타 원클릭(Meta-enabled) 설정은 비용 없이 클릭 한 번으로 끝나지만 픽셀이 보내는 이벤트·파라미터를 그대로 복제할 뿐 개별 이벤트·파라미터 선택이 불가능하고 웹 이벤트만 지원한다. (2) 쇼핑몰 솔루션(Shopify 등)의 파트너 연동은 판매 채널 설정에서 토글 하나로 활성화되며 추가 비용이 들지 않는다. (3) 직접 코드 구현(커스텀 서버)은 개발자 리소스가 필요하고 통상 2~4주가 소요되지만, 웹·앱·오프라인·CRM·비즈니스 메시징 이벤트까지 전부 지원하며 전송할 이벤트와 파라미터를 세밀하게 통제할 수 있다.
주의2~4주라는 개발 기간은 업계 정리 수치로, 실제 소요 기간은 내부 개발팀 역량과 기존 서버 인프라 성숙도에 따라 달라진다. 서버 유지 비용(호스팅·모니터링 인력)은 이 자료들에 구체적 수치가 없어 자사 인프라 비용으로 별도 산정해야 한다. (Meta Business Help Center, Mako Metrics 등 업계 정리 — 정확한 개발 인건비·유지비는 미확인)
확실 공식
카페24는 '메타 채널' 설정을 완료하면 픽셀(브라우저 이벤트)과 전환 API(서버 이벤트)가 함께 자동 구성되며, 브라우저·서버 이벤트를 모두 활성화하면 카페24 관리자 화면에 데이터 정확도가 '높음(High)'으로 표시된다. 반대로 페이스북 액세스 토큰이 만료되면 전환 API 전송과 카탈로그 업데이트가 모두 중단되므로, 채널 설정에서 토큰 유효 여부를 주기적으로 점검해야 한다.
주의이 자동 연동은 카페24가 제공하는 표준 이벤트 범위에 한정되며, 커스텀 이벤트나 세부 파라미터 조정이 필요하면 별도의 직접 API 연동이 필요할 수 있다. 정확한 지원 이벤트 목록은 카페24 관리자 화면에서 최신 상태로 확인해야 한다. (카페24 Help Center)