플랫폼으로서의 전환 API 설정하기

태그 관리 서비스의 일환으로 Meta 픽셀 설정을 제공하는 경우 전환 API 기능을 추가하는 것이 좋습니다. 전환 API와 통합하면 고객이 브라우저 픽셀 이벤트를 사용하지 않고도 Facebook으로 직접 웹 이벤트를 전송할 수 있게 됩니다.

서버 이벤트 vs. 브라우저 이벤트

시작하기 전에 서버 이벤트와 Meta 픽셀 사이의 관계를 이해하는 것이 중요합니다. 서버 이벤트는 전환 API를 통해 전송되고 브라우저 픽셀 이벤트와 동일한 방식으로 측정, 보고 및 최적화에 사용됩니다.

브라우저 픽셀 이벤트를 전송하는 것이 항공 우편을 통해 편지를 보내는 것과 같다면, 서버 이벤트를 전송하는 것은 화물 운송을 통해 편지를 보내는 것과 같습니다. 이 두 가지는 모두 소포(이벤트에 대한 데이터)를 목적지 주소(픽셀 ID)로 운송하는 메커니즘입니다. 따라서 다음과 같은 이유로 (별도의 플러그인이나 서비스가 아니라) 현재의 Meta 픽셀 서비스를 확장한 형태로 플랫폼에서 전환 API 통합을 빌드하는 것이 좋습니다.

• 서버 이벤트는 픽셀 ID를 목적지로 사용합니다.
• 서버 이벤트는 Facebook으로 전송되면 브라우저 픽셀 이벤트와 동일한 방식으로 처리됩니다.
• 중복 제거를 더 쉽게 구현할 수 있습니다.
• 클라이언트가 쉽게 사용할 수 있습니다. 예를 들어 서버 이벤트는 기본적으로 브라우저 이벤트와 함께 전송할 수 있습니다.

플랫폼이 전환 API와 통합되고 나면 동일한 웹 이벤트를 브라우저와 서버를 통해 전송하는 것이 좋습니다. 이 중복성은 신호 안정성을 보장하는 데 도움이 됩니다. 다양한 네트워크 이유로 인해 원래는 브라우저 측에서 손실되었을 이벤트가 이제 전환 API를 통해 수집됩니다.

브라우저와 서버를 통해 이벤트를 전송하려면 해당 이벤트에 대해 동일한 event_id를 올바르게 설정해야 합니다. 그러면 Facebook이 적절하게 이벤트의 중복을 제거할 수 있습니다.

필수 조건

1. Facebook에 이벤트를 공유할 수 있는 웹 플랫폼이 필요합니다. 예를 들어 웹사이트 빌더, 태그 관리자 또는 AdTech 플랫폼이 있습니다.
2. Facebook에 이벤트 데이터를 공유할 것을 Facebook 비즈니스 도구 약관의 요구에 따라 사용자에게 적절히 고지하고 동의를 받습니다.
3. Facebook 담당자가 필요합니다.
4. 표준 전환 API 통합 필수 조건은 다음과 같습니다.
   • 비즈니스 관리자
   • Meta 앱
   • Meta 픽셀
   • 액세스 토큰

시작하기

전환 API를 처음 사용하는 경우라면 다음 단계에 따라 비즈니스, Meta 앱, Meta 픽셀 및 시스템 사용자를 만듭니다. 그러면 시스템 사용자의 액세스 토큰을 사용하여 전환 API를 통해 서버 이벤트를 보낼 수 있습니다.

1단계: 비즈니스를 만듭니다.

2단계: 새로 만든 비즈니스에서 Meta 앱을 만듭니다.

3단계: 새로 만든 비즈니스에서 다음과 같이 Meta 픽셀을 만듭니다.

• 이벤트 관리자로 이동합니다.
• 새 데이터 소스 추가를 선택합니다.

4단계: 시스템 사용자 액세스 토큰을 생성합니다.

5단계: Meta 픽셀로 서버 이벤트를 전송합니다.

클라이언트 대신 이벤트 보내기

자체 Meta 픽셀로 서버 이벤트를 전송하고 나면, 클라이언트를 대신하여 이벤트를 전송하는 방법에 대한 옵션을 선택할 수 있습니다.

파트너의 비즈니스 관리자가 소유하거나 관리하는 Meta 픽셀의 경우

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

파트너가 관리하지 않는 Facebook 픽셀의 경우

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

Facebook Business 확장 기능(권장)

이 옵션을 사용하면 Facebook Business 확장 기능(FBE)이 다음과 같은 절차를 통해 클라이언트를 대신하여 이벤트를 전송하는 데 필요한 모든 필수 정보를 반환합니다. FBE는 클라이언트의 비즈니스 관리자에서 생성된 시스템 사용자 액세스 토큰을 가져오기 위한 엔드포인트를 제공합니다. 이 절차는 서버 이벤트를 보내기 위한 권한을 포함하며 안전하게 자동으로 처리됩니다.

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

클라이언트 시스템 사용자 액세스 토큰

이 옵션을 사용하면 클라이언트가 픽셀 설정 내에서 전환 API를 통해 시스템 사용자 액세스 토큰을 수동으로 생성해야 합니다. 그러면 해당 토큰으로 광고주의 픽셀에 이벤트를 보낼 수 있습니다.

시스템 사용자 또는 관리자 시스템 사용자는 액세스 토큰 생성에 사용될 앱을 설치해야 합니다. 이 설정을 통해 앱이 이 시스템 사용자 또는 관리자 시스템 사용자 대신 API를 호출할 수 있게 됩니다.

시작하기 문서에 따라 광고주에게 시스템 사용자 토큰을 요청하세요. 테스트에는 자체 Meta 픽셀과 액세스 토큰을 사용하세요.

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

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

partner_agent 필드를 사용하여 이벤트가 플랫폼으로 인해 발생한 것으로 설정

전환 API 이벤트가 플랫폼에서 발생한 것으로 설정하려면 partner_agent 필드를 사용하세요. 이렇게 하면 클라이언트 대신 이벤트를 보낼 때 자체 플랫폼 식별자를 설정할 수 있습니다. Facebook 담당자와 협력하여 자신의 플랫폼에 대한 식별자에 합의하세요. 그런 다음 각 서버 이벤트와 함께 보냅니다.

이벤트 페이로드 샘플

플랫폼 식별자가 datapartner인 경우, 클라이언트를 대신하여 전송된 구매 이벤트 페이로드 샘플은 다음과 같습니다.

    
{
  "data": [
    {
      "user_data": {
        "em": "8159ea0e33c51a774b83104ee562784f9b1836c852102046e4bd8385706fe7ca"
      },
      "event_name": "PageView",
      "event_time": 1579645238
    },
    {
      "user_data": {
        "em": "8159ea0e33c51a774b83104ee562784f9b1836c852102046e4bd8385706fe7ca"
      },
      "custom_data": {
        "currency": "USD",
        "value": "50"
      },
      "event_name": "Purchase",
      "event_time": 1579645238
    }
  ],
  "partner_agent": "datapartner"
}

자주 묻는 질문