전환 API
CAPI
한 줄 정의
광고주의 서버·웹사이트 플랫폼·앱·CRM에서 메타로 전환 데이터를 직접 보내는 연결 도구입니다. Conversions API의 줄임말로, 업계에서는 "캐피" 또는 "CAPI"라고 부릅니다.
어떻게 작동하나
- 보내는 곳: 픽셀이 방문자 브라우저에서 이벤트를 보내는 것과 달리, 전환 API는 광고주 서버 등에서 메타의 전환 API 엔드포인트로 이벤트를 보냅니다.
- 보낼 수 있는 데이터: 메타 개발자 문서 기준으로 웹사이트 이벤트, 앱 이벤트, 비즈니스 메시징 이벤트, 오프라인 전환을 보낼 수 있습니다.
- 처리 방식: 서버로 들어온 이벤트는 데이터셋 ID에 연결되어 픽셀·SDK로 들어온 이벤트와 같은 방식으로 측정·보고·최적화에 쓰입니다.
- 설정 방법: 웹사이트에 이미 메타 픽셀이 있으면 이벤트 관리자에서 코드 없이 클릭 몇 번으로 웹사이트 이벤트용 전환 API를 설정할 수 있다고 안내합니다. 직접 연동하면 서버에서 POST 요청을 구현합니다.
- 중복 제거: 픽셀과 전환 API로 같은 구매를 둘 다 보내면 두 번 셀 수 있습니다. 메타는 다음 두 값이 모두 같으면 중복으로 봅니다.
- 픽셀의
eventID= 전환 API의event_id - 픽셀의
event= 전환 API의event_name - 같은 키를 가진 첫 이벤트를 받은 뒤 48시간 안에 들어온 이벤트만 중복 제거 대상이고, 뒤에 들어온 쪽이 버려집니다.
- 픽셀의
간단한 예(가상 숫자): 하루 실제 구매 100건을 픽셀과 전환 API로 모두 보냈는데 이벤트 ID를 안 넣었다면, 최악의 경우 200건으로 잡혀 CPA가 실제의 절반처럼 보입니다. 광고비 200만 원 기준 실제 CPA는 200만 ÷ 100 = 2만 원인데, 보고서에는 200만 ÷ 200 = 1만 원으로 나오는 셈입니다.
쉽게 풀어 말할 때
"픽셀은 손님 폰(브라우저)이 메타한테 '나 샀어요' 하고 알려 주는 방식이라, 광고 차단이나 브라우저 설정 때문에 중간에 빠질 수 있어요. 전환 API는 우리 회사 주문 서버가 직접 '방금 주문 들어왔어요' 하고 메타에 보고하는 거예요. 두 개를 같이 쓰면 놓치는 건 줄고, 대신 같은 주문을 두 번 세지 않게 주문 번호 같은 이벤트 ID를 맞춰 줘야 해요."
업계 말로 말할 때
- "CAPI 붙이고 나서 이벤트 매칭 품질이 올라갔어요. 이제 픽셀 단독일 때보다 전환 누락이 덜할 겁니다."
- "구매 이벤트가 이중으로 잡히는 것 같은데, 픽셀이랑 CAPI 쪽 event_id가 같은 값으로 들어가는지 확인해 주세요."
- "오프라인 매장 매출도 CAPI로 올려서 메타 광고가 매장 구매에 얼마나 기여했는지 보겠습니다."
실무 팁
- 픽셀과 같이 쓰면 중복 제거부터 설정합니다. 주문 번호처럼 고유한 값을 이벤트 ID로 정해, 브라우저와 서버 양쪽에 같은 값을 넣습니다. 이벤트 이름도 양쪽이 같아야 합니다.
- 서버 이벤트가 늦게 가면 중복 제거가 안 될 수 있습니다. 메타 문서상 중복 제거 창은 첫 이벤트 수신 후 48시간입니다. 배치로 며칠 뒤에 몰아 보내면 이 창을 넘길 수 있습니다.
- 도입 효과는 수치로 확인합니다. 도입 전후로 이벤트 관리자의 이벤트 수와 실제 주문 수(내부 DB)를 비교해 누락이 줄었는지 봅니다. "CAPI를 붙이면 전환이 몇 % 늘어난다" 같은 일반 수치는 확인된 자료 없음입니다.
헷갈리기 쉬운 말
확인 퀴즈
픽셀과 전환 API로 같은 구매를 함께 보낼 때, 메타가 두 이벤트를 하나로 합치려면 무엇이 맞아야 할까요?
정답과 풀이 보기
정답: 2번. 메타 문서는 픽셀의 eventID·event와 전환 API의 event_id·event_name이 각각 일치하면 중복으로 판단한다고 안내합니다. 금액이나 IP는 중복 제거의 기준 키가 아닙니다.