구현 조건 및 인프라 구축: 클라우드 서버(AWS, Google Cloud 등) 환경 또는 호스팅사(카페24, Shopify)의 게이트웨이 직접 연동 절차

구현 방식 세 갈래부터 구분한다

CAPI를 붙이는 방법은 기술 난이도와 통제력이 반비례하는 세 갈래로 나뉩니다. 첫째는 직접 API 호출로, 개발팀이 광고주 서버에서 메타 Graph API 엔드포인트로 직접 HTTP POST 요청을 구성하는 방식입니다. 둘째는 구글 태그매니저(GTM) 서버 컨테이너를 중간에 두는 방식으로, 클라이언트에서 발생한 이벤트를 서버 컨테이너가 받아 다시 메타로 전달합니다. 셋째는 쇼핑몰 솔루션이나 메타 자체가 제공하는 파트너·원클릭 연동입니다.

어느 쪽을 선택할지는 "얼마나 세밀하게 통제하고 싶은가"와 "지금 쓸 수 있는 개발 리소스가 얼마나 되는가"의 함수입니다. 세 방식은 배타적이지 않고, 초기에는 원클릭으로 시작했다가 데이터 정교화가 필요해지면 직접 구현으로 이관하는 경로도 실무에서 흔히 씁니다.

메타 원클릭 설정과 그 한계

메타는 이벤트 관리자 안에서 클릭 한 번으로 CAPI를 활성화하는 기능을 제공합니다. 이 방식은 메타가 서버 인프라를 직접 관리하므로 별도 비용이나 개발 리소스, 지속적인 유지보수가 필요 없다는 것이 최대 장점입니다. 다만 이 원클릭 설정은 표준 웹 이벤트만 자동화하며, 픽셀이 보내는 이벤트와 파라미터를 그대로 복제할 뿐이라 개별 이벤트·파라미터를 선택적으로 조정할 수 없습니다. 커스텀 이벤트, 오프라인 전환, 여러 플랫폼으로의 라우팅이 필요하면 이 방식만으로는 부족합니다.

쇼핑몰 솔루션(카페24·Shopify) 파트너 연동 절차

자사 서버를 직접 관리하지 않는 대부분의 이커머스 셀러에게는 쇼핑몰 솔루션이 제공하는 파트너 연동이 현실적인 출발점입니다. Shopify는 Facebook & Instagram 판매 채널 설정에서 토글 하나로 CAPI를 켤 수 있고 추가 비용이 없습니다. 카페24는 '메타 채널' 설정을 완료하면 픽셀(브라우저 이벤트)과 전환 API(서버 이벤트)가 함께 자동 구성되며, 두 이벤트를 모두 활성화하면 관리자 화면에 데이터 정확도가 '높음(High)'으로 표시됩니다.

파트너 연동을 썼다고 손을 완전히 뗄 수 있는 것은 아닙니다. 카페24의 경우 페이스북 액세스 토큰이 만료되면 전환 API 전송과 카탈로그 업데이트가 동시에 중단되므로, 채널 설정 화면에서 토큰 유효 여부를 주기적으로 점검하는 운영 루틴이 필요합니다. 이 자동 연동은 솔루션이 제공하는 표준 이벤트 범위에 한정되므로, 커스텀 이벤트나 세부 파라미터 조정이 필요하면 결국 직접 API 연동을 별도로 붙여야 합니다.

직접 코드 구현(클라우드 서버) 절차

자체 개발 리소스가 있고 세밀한 통제가 필요하다면 AWS·Google Cloud 같은 클라우드 서버 위에 직접 CAPI 연동을 구축합니다. 이 방식은 웹·앱·오프라인·CRM·비즈니스 메시징 이벤트까지 전부 지원하며, 어떤 이벤트를 언제 어떤 파라미터로 전송할지 코드 레벨에서 세밀하게 통제할 수 있다는 것이 최대 장점입니다. 대신 개발 리소스가 필요하고 업계 정리 기준으로 통상 2~4주의 구축 기간이 소요됩니다(내부 개발팀 역량과 기존 인프라 성숙도에 따라 달라질 수 있는 참고치입니다).

절차상으로는 서버 측에서 결제 완료·회원가입 같은 이벤트가 발생하는 시점에 훅(hook)을 걸어, 이메일·전화번호(해싱 처리, 3강 참조)와 event_id를 포함한 페이로드를 메타 Graph API 엔드포인트로 POST 요청하는 함수를 구현합니다. GTM 서버 컨테이너를 중간에 둘 경우 이 컨테이너 자체를 클라우드 서버(대개 GCP)에 별도로 호스팅해야 하며, 이 경우 GA4 데이터 레이어 구현이 선행되어야 한다는 점도 고려해야 합니다. 이때 엔드포인트 URL에 어떤 API 버전을 박아 넣을지도 구축 단계에서 함께 정해두어야 합니다. 메타는 전환 API가 얹혀 있는 Graph API·Marketing API를 정기적으로 새 버전으로 출시하고, 각 버전은 다음 버전이 나온 뒤 2년이 지나면 만료됩니다. 만료된 버전으로의 호출은 이후 지원되는 구버전으로 자동 대체되거나 실패할 수 있어, 아무도 코드를 건드리지 않았는데 파라미터 처리 방식만 조용히 달라지는 상황이 생길 수 있습니다. 버전 번호를 코드 곳곳에 흩어 적지 말고 설정값 한 곳으로 모아두면 나중에 버전을 올릴 때 손댈 지점이 하나로 줄어듭니다. 버전 관리 운영은 12강에서 따로 다룹니다.