통합 품질 API

전환 API를 사용하여 서버 이벤트를 공유하는 광고주는 이벤트 관리자에서 이벤트 매칭 품질을 확인할 수 있습니다. 그러나 이는 개별적으로만 작동하며, 기술 제공업체 파트너, 대행사 파트너 또는 광고주가 자신의 비즈니스에서 수많은 Meta 픽셀을 관리하는 경우에는 규모 조정이 어렵습니다. 통합 품질 API는 프로그래밍 방식으로 통합 품질 지표를 대규모로 통합하여 이 문제를 해결하는 데 도움을 줄 수 있습니다.

이벤트 매칭 품질 정보

이벤트 매칭 품질

이벤트 매칭 품질(EMQ)은 서버에서 전송한 고객 정보가 이벤트 인스턴스를 Facebook 계정과 매칭하는 데 얼마나 효과적인지 나타내는 점수(10점 만점)입니다. 품질이 우수한 이벤트 매칭은 광고 기여와 성과를 높일 수 있습니다. 이 지표는 개발 중입니다.

계산 방법

이벤트 매칭 품질은 전환 API 통합을 통해 서버로부터 수신한 고객 정보 매개변수, 수신된 정보의 품질, Meta 계정과 매칭되는 이벤트 인스턴스의 비율을 반영하여 계산됩니다.

사용 방법

이벤트 매칭 품질은 전환 API를 통해 이벤트를 Meta 계정에 매칭하기 위해 적절한 고객 정보를 전송하고 있는지, 고객 정보 매개변수를 올바르게 설정했는지 평가하는 데 사용됩니다. 고객 정보 매개변수는 이벤트를 Meta 계정에 매칭하여 광고가 전환에 기여했는지 확인하고 전환할 가능성이 가장 높은 사람들에게 광고를 게재하는 데 도움을 줍니다.

이벤트 매칭 품질은 실시간으로 계산됩니다. EMQ 모범 사례는 여기에서 자세히 알아보세요.

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

일반적인 사용 사례

파트너 및 대행사는 통합 품질 API를 사용하여 품질 대시보드와 인사이트를 제공하고 광고주가 통합을 개선하고 최적화하는 데 도움을 줄 수 있습니다. 또한 파트너는 이 통합을 사용하여 전환 API 통합의 안정성을 모니터링할 수도 있습니다. 광고주는 이 엔드포인트를 사용하여 통합 품질 데이터를 집계하고 모니터링에 통합할 수 있습니다.

인증

비즈니스 관리자를 통한 광고주 인증

1. 비즈니스 관리자에서 사용자 섹션으로 이동하여 시스템 사용자 탭을 선택합니다. 전환 API에 사용 중인 특정 시스템 사용자를 클릭합니다.
2. 자산 할당 대화 상자로 이동하여 픽셀을 선택합니다. 그런 다음, 이벤트를 대행으로 전송하고자 하는 픽셀을 선택합니다.
3. 각 픽셀에 대해 픽셀 관리 권한을 선택하고 변경 사항 저장을 클릭합니다.
4. 시스템 사용자의 상세 정보 페이지로 돌아갑니다. 선택한 픽셀이 보이는지 확인합니다.
5. 액세스 토큰을 생성하려면 여기에서 지침을 따르세요.

파트너 플랫폼 인증

먼저 클라이언트 대신 이벤트를 보내기 위한 승인을 요청해야 합니다. 사용 가능한 인증 옵션은 다음과 같습니다.

비즈니스용 Facebook 로그인(권장)

비즈니스용 Facebook 로그인은 비즈니스 클라이언트의 자산에 액세스해야 하는 기술 제공업체와 비즈니스 앱 개발자가 선호하는 인증 및 권한 부여 솔루션입니다. 이 솔루션을 사용하면 액세스 토큰 유형, 자산 유형, 앱에 필요한 권한을 지정하고 세트(구성)로 이를 저장할 수 있습니다. 그런 다음, 이 세트를 비즈니스 클라이언트에게 제공하면 해당 비즈니스 클라이언트가 플로를 완료하고 자신의 비즈니스 자산에 대한 액세스 권한을 앱에 부여할 수 있습니다.

Meta 비즈니스 확장 도구(권장)

이 옵션을 사용하면 Meta 비즈니스 확장 도구(MBE)가 클라이언트를 대신하여 이벤트를 전송하는 데 필요한 모든 필수 정보를 반환합니다. MBE는 클라이언트의 비즈니스 관리자에서 생성된 시스템 사용자 액세스 토큰을 가져오기 위한 엔드포인트를 제공합니다. 이 절차는 서버 이벤트를 보내기 위한 권한을 포함하며 안전하게 자동으로 처리됩니다. MBE는 현재 베타로 진행 중이므로 액세스하려면 Meta 담당자에게 문의하세요.

이 엔드포인트는 입력 매개변수로 사용자 액세스 토큰이 필요합니다. 새로운 MBE 사용자의 경우 MBE 설정을 완료한 후 이 엔드포인트를 호출하여 시스템 사용자 액세스 토큰을 가져오면 됩니다. 기존 사용자는 새로운 API 엔드포인트를 호출하기 전에 재인증을 요청해야 합니다.

클라이언트가 Meta 픽셀을 파트너의 비즈니스 관리자에게 공유

이 옵션을 사용하면 클라이언트가 비즈니스 관리자 설정 또는 API를 통해 Meta 픽셀을 파트너에게 공유합니다. 그런 다음 파트너가 파트너 시스템 사용자를 클라이언트 픽셀에 할당하고 서버 이벤트를 전송하기 위한 액세스 토큰을 생성할 수 있습니다.

픽셀 통합 품질 정보 가져오기

다음 API 엔드포인트, 매개변수 및 필드를 사용하여 전송되는 매칭 키와 함께 각 이벤트의 이벤트 매칭 품질 점수를 모니터링할 수 있습니다.

엔드포인트

https://graph.facebook.com/v21.0/<pixel_id>/integration_quality

매개변수

필드

예

그래프 API 탐색기

GET/v21.0/<PIXEL_ID>/integration_quality?fields=event_match_quality,event_name&agent_name=<AGENT_NAME>&access_token=<ACCESS_TOKEN>

cURL

curl -X GET -G \
  -d 'fields="event_match_quality,event_name"' \
  -d 'agent_name="<AGENT_NAME>"' \
  -d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/<LATEST_VERSION>/<PIXEL_ID>/integration_quality

API 응답

{
  "data": [
    {
      "event_match_quality": {
        "composite_score": 5.1,
        "match_key_feedback": [
          {
            "identifier": "email",
            "coverage": {
              "percentage": 100
            }
          },
          {
            "identifier": "user_agent",
            "coverage": {
              "percentage": 100
            }
          },
          {
            "identifier": "external_id",
            "coverage": {
              "percentage": 100
            }
          }
        ]      
      },
      "event_name": "pLTVPurchase"
    },
    {
      "event_match_quality": {
        "composite_score": 7.2,
        "match_key_feedback": [
          {
            "identifier": "email",
            "coverage": {
              "percentage": 100
            }
          },
          {
            "identifier": "user_agent",
            "coverage": {
              "percentage": 100
            }
          },
          {
            "identifier": "phone",
            "coverage": {
              "percentage": 69.1
            }
          },
          {
            "identifier": "fbp",
            "coverage": {
              "percentage": 96.7
            }
          },
          {
            "identifier": "external_id",
            "coverage": {
              "percentage": 100
            }
          },
          {
            "identifier": "fbc",
            "coverage": {
              "percentage": 3.2
            }
          }
        ]
      },
      "event_name": "CompleteRegistration"
    }
  ]
}

FAQ

더 알아보기

1. 전환 API 모범 사례

2. 최적화된 전환 API 설정으로 성과 향상

3. 파트너의 전환 API 온보딩 모범 사례

4. Meta 비즈니스 지원 센터의 전환 API 설정 품질 지침:

• 광고 성과를 향상하기 위한 전환 API 모범 사례. 이러한 전환 API 모범 사례는 비즈니스가 행동당 비용을 낮추어 광고 성과를 개선하는 데 도움을 줄 수 있습니다. 초기 설정 시 이러한 모범 사례를 준수하는 것이 좋지만, 이러한 모범 사례는 기존 설정을 업데이트하는 데도 사용할 수 있습니다.

• Meta 이벤트 관리자에서 서버 이벤트 상세 정보 보기. 비즈니스는 전환 API를 설정한 후, 이 문서를 이용하여 이벤트와 매개변수를 모니터링하여 설정이 효과적으로 작동하고 있는지 확인하고 개선 기회를 파악하는 방법을 배울 수 있습니다. 또한 이 문서를 이용하여 이벤트 관리자에서 서버 이벤트 상세 정보(이벤트 매칭 [이벤트 매칭 품질/EMQ]), 데이터 신선도, 이벤트 개요 및 이벤트 중복 제거)를 사용하여 전환 API 설정을 개선하는 방법을 배울 수도 있습니다.