전환 API

모범 사례 - 전환 API

이러한 모범 사례를 일반 권장 사항으로 사용하여 전환 API를 성공적으로 통합하세요. 이러한 권장 사항은 전환 API를 가장 효과적으로 사용하는 데 도움이 되도록 고안되었습니다. 구현 및 구현 후 권장 사항을 따르면 Meta와 데이터를 공유할 때 원활한 통합과 최적의 결과를 확보할 수 있습니다.

다음의 모범 사례 외에도 이 동영상을 시청하여 전환 API를 사용하기 위한 자세한 실습 튜토리얼을 참조하세요. 동영상에서는 다음과 같은 사용 방법을 안내합니다.

전환 API를 사용하여 공유된 웹, 앱 및 오프라인 매장 이벤트에는 특정 매개변수가 필요합니다. 필요한 매개변수의 리스트는 여기에서 확인할 수 있습니다.

구현

캠페인을 설정할 때 계정 구조를 단순화하고 다음의 확립된 캠페인 모범 사례를 사용하세요.

중복 이벤트 설정

Meta 픽셀 외에도 전환 API를 사용하고 두 도구를 통해 동일한 이벤트를 공유하는 것이 좋습니다. 이를 중복 이벤트 설정이라고 합니다. 예를 들어 Meta 픽셀을 사용하여 Purchase, Initiate Checkout, Contact 이벤트를 공유하는 경우 전환 API를 통해 서버에서도 동일한 이벤트를 공유해야 합니다.

전환 API를 사용하면 네트워크 연결 문제나 페이지 읽어들이기 오류로 인해 픽셀이 누락할 수 있는 웹사이트 이벤트를 공유할 수 있습니다. 또한 전환 API는 픽셀에서 공유할 수 없고 오프라인이나 나중에 발생하는 다른 유형의 중요 이벤트 및 데이터를 공유하는 데 사용할 수 있습니다.

중복 이벤트의 중복을 제거하도록 보장

Meta 픽셀과 전환 API를 사용하여 중복 이벤트를 보낼 때는 두 이벤트가 모두 동일한 event_name을 사용하고 event_id 또는 external_id와 fbp의 조합을 포함하도록 합니다. Meta가 이벤트의 중복을 적절히 제거하고 동일한 이벤트의 이중 보고를 줄이도록 하려면 이러한 매개변수를 모두 포함하는 것이 좋습니다. 중복 제거, 중복 제거가 필요한 시점, 중복 제거 설정 방법에 대해 자세히 알아보세요.

필수 및 권장 매개변수 보내기

다음의 서버 이벤트와 고객 정보 매개변수는 필수 항목입니다.

매개변수유형필수인 경우

action_source

서버 이벤트

모든 이벤트

event_source_url

서버 이벤트

모든 웹사이트 이벤트

client_user_agent

고객 정보

모든 웹사이트 이벤트

전환 API를 사용하면 회원님이 아는 한도 내에서 action_source 매개변수가 정확하다는 데 동의하게 됩니다. 또한 모든 이벤트에 external_id와 event_id 이벤트 매개변수를 포함하는 것이 좋습니다.

추가적인 고객 정보 매개변수를 보내면 이벤트 매칭 품질을 높이는 데 도움이 될 수 있습니다. 매칭된 이벤트만 광고 기여와 광고 게재 최적화에 사용할 수 있으며 매칭 품질이 높을수록 좋습니다. 매칭되지 않은 이벤트는 기여나 광고 게재 최적화에 사용할 수 없더라도 기본 측정에는 사용할 수 있습니다. 양질의 고객 정보 매개변수의 예는 다음과 같습니다.

  • 이메일 주소(em)
  • IP 주소(client_ip_address)
  • 이름(fn 및 ln)
  • 전화번호(ph)

매칭을 위한 기준 요구 사항

그래프 API 버전 13.0을 릴리스한 후 전환 API 이벤트에서 유효한 것으로 간주되는 고객 정보 매개변수의 조합에 대한 기준 요구 사항을 업데이트할 예정입니다. 이러한 변경 사항은 이벤트에 대해 고객 정보 매개변수의 조합이 너무 광범위하여 매칭에 효과적이지 않을 경우 Facebook에서 더 나은 피드백을 제공할 수 있도록 합니다.

이벤트에 다음 조합 중 하나(또는 그 하위 집합)로 구성된 고객 정보 매개변수만 포함하는 경우 해당 이벤트는 유효하지 않은 것으로 간주됩니다.

  • ct + country + st + zp + ge + client_user_agent
  • db + client_user_agent
  • fn + ge
  • ln + ge

예를 들어 이벤트에 ge, ct, st, country라는 고객 정보 매개변수(예: 미국 캘리포니아주 멘로파크에 거주하는 남성)만 있을 경우 해당 고객 정보 매개변수는 위의 조합 중 하나에 속한 하위 집합이므로 거부됩니다.

fbp와 fbc 매개변수가 새로 고침되도록 함

fbp와 fbc 매개변수는 일반적으로 Meta의 자사 쿠키 솔루션과 관련하여 사이트 방문자의 브라우저에 설정되는 쿠키 값이며, 변경될 수 있습니다. 이들을 사용자 매개변수로 보낼 경우 정기적으로 값을 새로 고침해야 합니다.

이러한 값은 Meta 픽셀을 웹사이트에 구현하면 자사 쿠키로 설정되고 전환 API 요청에 사용하기 위해 가져올 수 있습니다.

실시간에 가까운 이벤트 공유

이벤트가 발생하는 시점에 공유하면 캠페인이 최상의 결과를 달성하는 데 도움이 될 수 있습니다. 전환 API를 사용하여 실시간으로 서버 이벤트를 공유하거나 실시간에 가깝게 일괄 공유할 수 있습니다.

테스트 이벤트 사용

테스트 이벤트 도구를 사용하여 전환 API 연결을 검증하는 것이 좋습니다. 일반적으로 개발자는 테스트 이벤트에 자체 고객 정보 매개변수(예: 이름, 이메일 주소, 전화번호)를 사용해야 합니다. 왜냐하면 이러한 이벤트는 Facebook 또는 Meta 계정과 일치하지 않으면 삭제될 수 있기 때문입니다.

테스트 이벤트 도구를 다음과 같은 용도로 사용할 수 있습니다.

  • 서버 이벤트를 올바르게 설정했으며 Facebook에서 해당 이벤트를 수신했는지 확인합니다.
  • 어느 이벤트가 처리되고 중복이 제거되었는지 확인하여 이벤트의 중복이 올바르게 제거되었는지 확인합니다.
  • 비정상적인 활동을 모두 디버그합니다.

테스트 이벤트 도구를 사용하여 서버 이벤트를 테스트하는 방법을 알아보세요.

페이로드 도우미 사용하기

페이로드 도우미 도구에 필수 및 권장 데이터 매개변수 필드를 입력하면 페이로드를 구성하는 방법을 확인하고 어떤 매개변수를 포함할지 조언을 얻을 수 있습니다.

Facebook Business SDK 사용하기

문서의 코드 샘플에는 Python, Java, Ruby, PHP, Node로 된 Business SDK 예시가 포함됩니다. Business SDK에서 자동 처리되므로 일부 개발 작업(예: 사용자 매개변수 해싱)을 해소할 수 있습니다.

Business SDK를 사용할 계획이 아니라면 해싱을 구현하는 것이 좋습니다.

오프라인 이벤트에 전환 API 사용하기

전환 API는 모든 오프라인 이벤트를 지원하며 이러한 유형의 이벤트에 대한 포괄적 컨테이너로 사용되어야 합니다. 예를 들어 실물 매장 판매, 전화 통화, 기기(예: 스마트 TV, 게임 콘솔)에서 수행한 작업, 오프라인 구독이 있습니다.

오프라인 이벤트를 보낼 때는 action_source 이벤트 매개변수를 포함하고 적절한 값(website 제외)을 선택하도록 합니다. 이벤트가 의도하는 캠페인 목표를 결정하려면 행동 출처가 있어야 합니다.

전환 API를 사용하면 회원님이 아는 한도 내에서 action_source 매개변수가 정확하다는 데 동의하게 됩니다.

파트너를 위한 추가적인 모범 사례

에이전시: partner_agent 문자열 보내기

광고주를 대신해서 이벤트를 공유하는 파트너 또는 에이전시는 문서에 기록된 플랫폼 이름을 포함하여 고유한 partner_agent 문자열을 보내야 합니다. 해당하는 경우 전담 Meta 담당자와 협력하여 적절한 에이전트 문자열을 결정하세요.

웹사이트 플랫폼: 광고주 온보딩

기본적으로 웹사이트 플랫폼 파트너는 전환 API를 선택적으로 제공할지, 광고주를 옵트인할지 고려해볼 수 있습니다. Meta 픽셀과 전환 API는 동일한 비즈니스 약관을 공유하며, 고객을 옵트인하여 고객이 Meta 픽셀을 설정할 때도 전환 API를 통해 데이터를 공유하도록 하는 것이 좋습니다. 두 가지 도구를 모두 사용하면 장기적으로 데이터 공유를 강화 및 보호할 수 있다고 생각하지만, 고객이 선택하는 데 도움이 되도록 전환 API와 Meta 픽셀에 대한 정보를 모두 제공하는 것이 좋습니다.

구현 후

이벤트 매칭 품질 확인

전환 API를 사용하여 서버 이벤트를 공유할 경우 이벤트 관리자에서 각 이벤트에 대한 이벤트 매칭 품질(EMQ)을 확인할 수 있습니다. 이벤트의 EMQ 점수(10점 만점)는 서버 이벤트의 고객 정보가 이벤트를 Facebook 또는 Meta 계정에 매칭하는 데 얼마나 효과적인지 나타냅니다. EMQ 모범 사례는 여기에서 자세히 알아보세요.

현재 이벤트 매칭 품질은 웹 이벤트에만 제공됩니다. 오프라인 및 실물 매장 이벤트, 앱 이벤트, 전환 잠재 고객 또는 알파나 베타 단계의 다른 통합과 같은 경우 Meta 담당자에게 이벤트 매칭 품질을 개선하기 위한 지침을 문의하세요.

테스트 실행

전환 API를 사용할 때는 Meta 광고 전략을 테스트하고 최적화하는 것이 좋습니다. 일부 테스트 옵션은 다음과 같습니다.

  • 전환 성과 증대 연구: 서버 이벤트를 사용할 경우 성과에 미치는 증분적 영향을 파악합니다.

  • 분할 테스트: 어느 캠페인 전략이 성능을 최적화하기에 가장 우수하고 효율적인 결과를 달성하는지 파악합니다.

더 알아보기