시작하기

이 페이지에서는 전환 API를 구현하는 과정과 구현에 적용되는 필수 조건에 대해 자세히 설명합니다. 광고주에게 전환 API 기능을 제공하는 타사 파트너인 경우 시작 시 다른 요구 사항이 적용됩니다.

비즈니스에 아웃바운드 요청에 대한 방화벽이 있을 경우 크롤러 IP 및 사용자 에이전트를 참조하여 Facebook의 IP 주소를 가져오세요. 주소 리스트가 자주 변경된다는 점에 유의하세요.

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

절차 개요

전환 API 통합을 설정하는 과정은 다음과 같은 간략한 단계로 구성됩니다.

  1. 자신에게 적절한 통합 방법을 선택합니다.
  2. 해당 구현 방법에 필요한 필수 조건을 완료합니다.
  3. 해당 통합 방법을 사용하여 구현합니다.
  4. 설정을 확인하고 광고 성과를 개선하는 데 도움이 되는 모범 사례를 준수합니다.

통합 방법

전환 API와 통합하는 방법에는 여러 가지가 있으며, 노력 수준과 비용, 지원 기능에 따라 달라집니다. 전환 API 설정 옵션의 개요는 이 문서를 참조하세요.

이 개발자 문서는 기본적으로 직접 통합을 빌드하는 데 초점을 맞춥니다.

요구 사항

픽셀 ID

전환 API를 사용하려면 픽셀 ID를 획득해야 합니다. 웹사이트에 픽셀을 이미 설정했다면 브라우저와 서버 이벤트에 동일한 픽셀 ID를 사용하는 것이 좋습니다.

비즈니스 관리자

API를 사용하려면 비즈니스 관리자가 필요합니다. 비즈니스 관리자는 광고주가 자신의 비즈니스에서, 그리고 외부 파트너와의 Facebook 마케팅 활동을 통합하는 데 도움을 줍니다. 아직 비즈니스 관리자가 없을 경우 고객 센터에서 비즈니스 관리자 생성 방법 문서를 참조하세요.

액세스 토큰

전환 API를 사용하려면 액세스 토큰이 필요합니다. 다음과 같은 두 가지 방법으로 액세스 토큰을 가져올 수 있습니다.

  • 이벤트 관리자 사용(권장)
  • 자체 앱 사용

이벤트 관리자 사용(권장)

전환 API를 사용하려면 각 API 호출의 매개변수로 전달되는 액세스 토큰을 생성해야 합니다. 이벤트 관리자에서 다음 단계를 따르세요.

1단계 - 구현하려는 픽셀을 선택합니다.

2단계 - 설정 탭을 선택합니다.


3단계 - 전환 API 섹션을 찾아서 수동으로 설정 아래에 있는 액세스 토큰 생성을 클릭한 다음, 지침 팝업을 따릅니다.

참고: 액세스 토큰 생성 링크는 비즈니스에 대해 개발자 권한이 있는 사용자에게만 표시됩니다. 다른 사용자에게는 이 링크가 표시되지 않습니다.


토큰을 생성한 후 이벤트 관리자의 개요 탭에 있는 통합 관리 버튼을 클릭합니다. 팝업 화면에서 전환 API 옆의 관리 버튼을 클릭합니다. 이렇게 하면 전환 API 앱과 전환 API 시스템 사용자가 자동으로 생성됩니다. 앱 검수를 거치거나 권한을 요청할 필요가 없습니다.



자체 앱 사용

이미 자체 시스템 사용자를 보유하고 있는 경우 비즈니스 관리자에서 토큰을 생성할 수 있습니다. 그 방법은 다음과 같습니다.

1단계 - 비즈니스의 설정으로 이동합니다.

2단계 - 시스템 사용자에 픽셀을 할당합니다(이 단계에 새 시스템 사용자를 생성하는 옵션도 제공됨).

3단계 - 할당된 시스템 사용자를 선택하고 토큰 생성을 클릭합니다.

앱 검수를 거치거나 권한을 요청할 필요가 없습니다.

이벤트 관리자의 전환 API 설정 탭에서 생성한 액세스 토큰을 생성 시점에 최신 가용 그래프 API 버전에서만 사용할 수 있었던 제한을 해제했습니다. v12.0부터 새로 생성된 액세스 토큰은 모든 가용 그래프 API 버전에서 사용할 수 있습니다.

리소스