Meta Conversions API(CAPI) 서버사이드 완벽 가이드: 월 매출 10만 브라질 헤알(BRL) 이상 운영을 위하여

대규모 운영에서의 Meta Ads 신호 아키텍처

유료 미디어에 상당한 예산을 투입하는 기업은 피드백되는 데이터의 품질에 매우 민감한 경매 구조 속에서 운영됩니다. Meta Ads의 머신러닝 알고리즘은 전환 이벤트를 활용해 광고 노출을 조정하고 사용자의 구매 가능성을 추정합니다.

Apple의 App Tracking Transparency(ATT)가 도입되고 Safari, Firefox 같은 브라우저의 쿠키 차단 정책이 강화되면서, 브라우저를 통한 기존 픽셀 방식은 취약해졌습니다. 트래킹이 고객 기기에서 실행되는 스크립트에만 의존하면, 사이트에서 완료된 거래의 상당 부분이 광고 관리자에 도달하지 못합니다.

Meta Conversions API(CAPI) payload의 구조

Conversions API는 기업의 서버와 Meta 서버 사이에 직접적인 통신 채널을 만듭니다. 결제 확인 시점에 동기 또는 비동기 방식으로 호출이 이루어지며, 암호화된 데이터가 안전한 REST 호출을 통해 전송됩니다.

다음은 /v20.0/{pixel_id}/events 엔드포인트를 위한 JSON payload의 기술 예시입니다.

{
  "data": [
    {
      "event_name": "Purchase",
      "event_time": 1726752000,
      "event_id": "order_89412",
      "event_source_url": "https://empresa.com.br/checkout/sucesso",
      "action_source": "website",
      "user_data": {
        "em": ["4f728c35d90953a79d0362f6b86f1f4ab8826c7d7b3226db202888cf3e2840c8"],
        "ph": ["99c927f87f4c026939943485703ff3cb79ff735c0cf3ff3e0b25e173ffb612c6"],
        "client_ip_address": "177.18.240.12",
        "client_user_agent": "Mozilla/5.0 (iPhone; CPU iPhone OS 17_5 like Mac OS X)...",
        "fbp": "fb.1.1718000000.123456789",
        "fbc": "fb.1.1718000000.PAZnRzaAUY-c9wZG9m..."
      },
      "custom_data": {
        "currency": "BRL",
        "value": 4850.00,
        "content_type": "product",
        "order_id": "ORD-2026-89412"
      }
    }
  ]
}

event_id 공유를 통한 이벤트 중복 제거

하나의 전환이 중복 집계되지 않도록 하려면, 권장되는 엔지니어링 방식은 중복 전송을 구현하되 기본 중복 제거 기능을 함께 사용하는 것입니다. 브라우저가 픽셀로 Purchase 이벤트를 발생시키는 동안, 서버 컨테이너는 동일한 고유 식별자 event_id를 담은 payload를 동시에 전송합니다.

Meta 인프라는 두 이벤트를 모두 처리하고 식별 키를 비교하여 하나의 기록으로 통합합니다. 광고 차단 확장 프로그램이 브라우저 발송을 막더라도, 서버가 경매에 온전한 데이터가 전달되도록 보장합니다.

SHA-256 암호화 규약과 식별자 정규화

Meta는 모든 사용자 개인 정보(PII)를 네트워크로 전송하기 전에 SHA-256 암호화 해시 함수로 처리하도록 요구합니다. 다만 해시의 무결성은 데이터를 사전에 표준화하는 데 달려 있습니다.

• 이메일: 앞뒤 공백을 제거하고 반드시 소문자로 변환합니다(예: [email protected]).
• 전화번호: 국가 코드와 지역 번호를 포함한 국제 형식으로, 공백, 하이픈, 괄호를 넣지 않습니다(예: 5511999998888).
• 이름과 성: 구두점이나 경칭 없이 소문자로 표기합니다.
• fbp 및 fbc 파라미터: 퍼스트파티 쿠키에 저장된 그대로 보존해야 하며 형식을 바꾸면 안 됩니다.

Meta Conversions API(CAPI)에 관한 자주 묻는 질문

엔지니어링 구현 로드맵

1. 전용 컨테이너 호스팅: 브랜드 소유 서브도메인 아래에 Google Cloud Run 컨테이너 또는 AWS 인스턴스를 구성합니다(예: dados.seudominio.com.br).
2. 퍼스트파티 쿠키 파라미터 설정: _fbp와 _fbc 파라미터를 HttpOnly, SameSite=Lax 지시어가 포함된 Set-Cookie 헤더로 변환합니다.
3. 사전 데이터 정규화: SHA-256 해시 함수를 적용하기 전에 데이터를 정리하고 정제합니다.
4. 관리자에서의 상태 모니터링: Meta 이벤트 관리자에서 중복 제거율과 매칭 품질 지수를 주기적으로 확인합니다.