메타 전환 API(CAPI) 설정 방법: 픽셀과 중복 없이 리드 보내기

가이드 · 전환 추적

메타 픽셀과 전환 API를 같은 이벤트 ID로 보내 중복 없이 집계하는 방법, 액세스 토큰 발급, 테스트 이벤트 확인, 개인정보 동의까지 랜딩 기준으로 정리했습니다.

답: 메타 전환 API(Conversions API, CAPI)는 브라우저 픽셀 대신 서버에서 메타로 이벤트를 보내는 방법입니다. 픽셀과 함께 쓰고, 두 쪽에 같은 이벤트 이름과 같은 이벤트 ID를 넣으면 메타가 하나로 합쳐 중복 없이 셉니다. 광고 차단기나 브라우저 추적 제한으로 픽셀이 놓친 리드도 서버 이벤트로 잡힙니다.

왜 픽셀만으로는 부족한가

픽셀은 방문자의 브라우저에서 실행됩니다. 광고 차단 확장 프로그램, iOS의 추적 제한, 신청 직후 창을 닫는 경우에는 이벤트가 빠집니다. 메타는 빠진 만큼 전환을 적게 보고, 광고 최적화도 적은 데이터로 하게 됩니다. 서버에서 한 번 더 보내면 이 손실을 메울 수 있습니다.

준비물

  1. 픽셀(데이터 세트) ID: 메타 이벤트 관리자 → 데이터 소스에서 확인합니다.
  2. 전환 API 액세스 토큰: 이벤트 관리자 → 데이터 세트 → 설정 → '전환 API' 항목의 '액세스 토큰 생성'.
  3. 테스트 이벤트 코드(선택): 이벤트 관리자 → '이벤트 테스트' 탭에 나오는 TEST로 시작하는 코드.

중복 제거의 원리

보내는 곳 이벤트 이름 이벤트 ID
브라우저 픽셀 Lead fbq('track', 'Lead', {}, {eventID: 'abc123'})
서버(CAPI) Lead "event_id": "abc123"

메타는 같은 이름·같은 ID의 이벤트가 픽셀과 서버에서 들어오면 하나만 남깁니다. ID가 다르거나 한쪽에만 있으면 두 번 셉니다. 그래서 신청서를 낼 때 브라우저에서 ID를 하나 만들고, 그 ID를 픽셀과 서버 양쪽에 똑같이 넘겨야 합니다.

서버 이벤트에 넣는 정보

  • event_name(Lead), event_time, event_id, action_source: "website", event_source_url
  • user_data
    • 그대로 보내는 값: client_ip_address, client_user_agent, fbc(광고 클릭 ID 쿠키), fbp(브라우저 ID 쿠키)
    • 해시(SHA-256)해서 보내는 값: 전화번호(ph, 국가번호 포함 숫자만, 예: 821012345678), 이메일(em, 소문자), 이름 등

연락처를 많이 넣을수록 메타가 사람을 더 잘 맞춥니다(이벤트 관리자의 '이벤트 매칭 품질'). 다만 다음 절의 동의 문제를 먼저 해결해야 합니다.

개인정보: 해시값도 개인정보입니다

전화번호를 해시해 보내도 개인정보 보호법상 개인정보 처리로 봅니다. 메타는 해외 사업자이므로 국외 이전에 해당합니다. 안전한 방법은 다음과 같습니다.

  1. 신청서에 '광고 효과 측정을 위한 국외 이전 동의(선택)'를 따로 둡니다. 받는 자(Meta Platforms), 국가, 항목, 목적, 보유 기간을 적습니다.
  2. 동의한 신청자만 해시 연락처를 넣어 보냅니다.
  3. 동의하지 않은 신청자는 연락처 없이 IP·브라우저·클릭 ID만으로 이벤트를 보냅니다.
  4. 건강 정보(증상 등)는 어떤 경우에도 보내지 않습니다.

동의 문구 예시는 랜딩페이지 개인정보 동의 문구와 무료 동의 문구 생성기에서 만들 수 있습니다.

확인하는 법

  1. 테스트 이벤트 코드를 넣고 테스트 신청을 한 번 합니다.
  2. 이벤트 관리자 '이벤트 테스트' 탭에 '브라우저'와 '서버' 이벤트가 각각 보이고, 하나는 '중복 제거됨'으로 표시되면 성공입니다.
  3. 실제 운영 전에는 테스트 코드를 지웁니다.

상담 결과까지 보내기

리드가 실제 상담·계약으로 이어졌는지를 메타에 다시 알려 주면, 광고가 '신청만 하는 사람'이 아니라 '상담까지 가는 사람'을 찾도록 도울 수 있습니다. 문의함에서 상태를 '상담 완료'나 '계약'으로 바꿀 때 같은 사람 정보(해시 연락처·외부 ID)로 맞춤 이벤트를 서버에서 보냅니다.

컷랜딩에서는

설정 → 연결에서 픽셀 ID와 액세스 토큰만 넣으면, 신청이 저장된 뒤 픽셀과 서버 이벤트가 같은 ID로 나갑니다. 광고 측정 동의를 한 신청자만 해시 연락처를 넣고, 건강 정보는 보내지 않습니다. 실패하면 24시간 동안 다시 보냅니다.

자주 묻는 질문

픽셀을 지우고 전환 API만 써도 되나요?

권장하지 않습니다. 메타는 두 가지를 함께 쓰고 중복 제거하는 방식을 권장합니다. 브라우저 쪽 정보(fbp·fbc 쿠키)가 매칭에 도움이 되고, 한쪽이 실패해도 다른 쪽이 남습니다.

이벤트가 두 번 잡혀요.

픽셀과 서버의 이벤트 이름이 다르거나(예: Lead와 SubmitApplication), 이벤트 ID가 다르게 들어간 경우입니다. 같은 신청에서 만든 ID 하나를 양쪽에 똑같이 넣었는지 확인하세요.

전환 API 토큰이 유출되면 어떻게 하나요?

이벤트 관리자에서 토큰을 새로 만들고 기존 토큰을 쓰는 곳을 바꾸세요. 토큰은 신청 페이지 HTML에 넣지 말고 서버에만 보관해야 합니다.

함께 보면 좋은 글