Introducing Facebook Graph API v12.0 and Marketing API v12.0

오늘 Facebook 그래프 API v12.0 및 마케팅 API v12.0을 릴리스합니다. 개발자 커뮤니티 일부에 영향을 미칠 주요 변경 사항은 아래와 같습니다. 이러한 변경 사항에는 알림 및 제품 업데이트, 이전 출시의 알림, 플랫폼과 앱 통합에 영향을 미칠 수 있는 대규모 사용 중단에 대한 알림 등이 포함됩니다.

모든 변경 사항과 상세 정보에 대한 전체 리스트는 변경 사항을 참조하세요.

일반 알림 및 업데이트

전환 API: 최소 호출 가능 버전 확장

원클릭 액세스 토큰으로 생성한 앱에 대한 그래프 API 구버전 호환성 v12.0부터 이벤트 관리자의 전환 API 설정 탭에서 새로 생성된 액세스 토큰은 사용 가능한 모든 그래프 API 버전에서 지원됩니다(여기에서 지원되는 버전 참조).

이러한 토큰을 사용하여 사용 중단된 그래프 API 버전에 보낸 호출은 가장 오래된 가용 버전으로 자동 연결됩니다. 이 동작은 그래프 API 엔드포인트에만 적용됩니다. 전환 API를 포함한 마케팅 API 엔드포인트는 자동 업그레이드 동작을 지원하지 않으며 예외를 발생시킵니다.

Instagram 메시지용 사용자 프로필 API: 새로운 필드

Facebook에서는 Instagram 메시지용 사용자 프로필 API를 개선하고 있습니다. 앞서 Instagram용 사용자 프로필 API는 두 개의 필드(1. 이름, 2. 프로필 사진의 URL)를 지원했습니다. 또한 비즈니스가 공개적으로 제공되는 사용자 정보를 기반으로 메시지 개인화와 우선순위 설정을 개선할 수 있도록 API를 업데이트하여 다음 정보를 포함하도록 했습니다.

1. 팔로워 수
2. 인증 배지
3. 비즈니스의 사용자 계정 팔로우 [예/아니요]
4. 사용자 계정의 비즈니스 계정 팔로우 [예/아니요]

자세한 내용은 개발자 문서를 참조하세요.

새로운 기회에 대한 상세 타게팅

광고주가 원래 누리지 못할 추가적인 기회를 모색하는 데 도움을 주기 위해 광고주가 상세 타게팅을 활용하고 전환 목표를 사용하여 전환, 가치 또는 앱 이벤트에 최적화할 경우 타게팅 확장에 자동으로 포함됩니다. 자세한 내용은 상세 타게팅 확장 고객 센터 문서를 참조하세요.

동영상 API: 새로운 필드

[동영상] 노드에 새로운 필드 두 개(views, post_views)를 추가했습니다. 자세한 내용은 동영상 API 개발자 문서를 참조하세요.

사용 중단 및 핵심 변경 사항

오류 투명성

그래프 API와 마케팅 API의 기본 동작은 앱이 관련 노드를 반환하는 노드에서 필드 또는 에지를 요청했지만 관련 노드에서 요구하는 적절한 권한이 없을 때 오류를 발생시키도록 설정되어 있습니다. 그러나 이러한 필드와 에지의 다수가 이 프로토콜을 따르지 않고 그 대신 호출 앱에 적절한 권한이 없으면 API 응답에서 생략하기만 했습니다.

v12.0부터는 해당 필드와 에지가 기본 동작을 따릅니다. 이 변경 사항은 2021년 12월 13일부터 모든 버전에 적용됩니다.

• 영향받는 그래프 API 엔드포인트
• 영향받는 마케팅 API 엔드포인트

시스템 사용자 및 앱 역할

시스템 사용자가 앱에서 역할을 부여받는 기능을 사용 중단합니다. 단, 사용자와 앱 모두 동일한 비즈니스에 속한 경우는 예외입니다. 앱과 비즈니스 운영에 지장이 없도록 앱에서 이러한 시스템 사용자를 삭제하고 대신 대행 비즈니스 API를 사용하는 것을 권장합니다. 이 핵심 변경 사항은 2021년 12월 13일부터 적용됩니다.

예약된 라이브

Live API의 예약 기능에서 planned_start_time 매개변수를 사용 중단하며, 해당 핵심 변경 사항은 2021년 12월 13일부터 적용됩니다. 새로운 매개변수는 향후 발표될 예정입니다.

Messenger 플랫폼: 전환 API

전환 API의 스레드 메타데이터에서 user_id 필드를 사용 중단합니다. 모든 개발자는 user_id(IGID)에 대한 모든 참조를 마이그레이션하고 사용자와 비즈니스 간 스레드의 기본 식별자로 IGSID만 사용해야 합니다.

이 핵심 변경 사항은 2021년 12월 13일부터 이전 그래프 API 버전에 적용됩니다. 자세한 내용은 전환 API 개발자 문서를 참조하세요.

Messenger 플랫폼: Instagram Webhook

이모티콘 공감에 대한 지원을 개선하기 위해 IG용 Messenger API 공감 Webhook를 업데이트하고 있습니다. 기존 버전은 emoji 필드를 문자열로 반환합니다. 이번 업데이트가 적용되면 공감 Webhook가 새로운 유니코드 형식을 반환합니다. 참고로 'reaction' 필드는 기본 이모티콘만 지원합니다. 다른 모든 이모티콘의 경우 reaction 필드는 MSGR과 마찬가지로 'other'를 반환합니다.

이 핵심 변경 사항은 2021년 12월 13일부터 이전 그래프 API 버전에 적용됩니다. 이모티콘 공감을 지속적으로 지원하려는 모든 개발자는 2021년 12월 13일까지 Facebook에서 반환하는 새로운 유니코드로 마이그레이션해야 합니다. 자세한 내용은 Webhook 개발자 문서를 참조하세요.

API 버전 사용 중단:

그래프 API 및 마케팅 API에 대한 Facebook 버전 관리 일정에 따라 예정된 사용 중단은 다음과 같습니다.

그래프 API

• 2021년 11월 2일: 그래프 API v4.0이 사용 중단되고 플랫폼에서 삭제됨
• 2022년 2월 3일: 그래프 API v5.0이 사용 중단되고 플랫폼에서 삭제됨
• 2022년 5월 22일: 그래프 API v6.0이 사용 중단되고 플랫폼에서 삭제됨

비즈니스 운영에 지장이 없도록 오늘 출시된 최신 API 버전으로 모든 호출을 마이그레이션하시기 바랍니다.

마케팅 API

• 마케팅 API v10.0은 2021년 10월 4일에 사용 중단 예정
• 마케팅 API v11.0은 2022년 2월 23일에 사용 중단 예정

비즈니스 운영에 지장이 없도록 오늘 출시된 최신 마케팅 API 버전으로 모든 호출을 마이그레이션하시기 바랍니다. (자세한 내용은 변경 사항을 참조하세요.)

Facebook 플랫폼 SDK

• 2021년 1월 19일에 Facebook 플랫폼 SDK v8.x 이하에 대해 2년 사용 중단 일정을 발표했습니다. 해당 버전은 2023년 1월에 사용 중단됩니다.
• 2021년 6월 8일에 Facebook 플랫폼 SDK v11.0을 릴리스하였고 Facebook 플랫폼 SDK v9.0의 2년 사용 중단이 시작되었습니다. SDK v9.0은 2023년 6월에 사용 중단됩니다.

일반 사용 중단

네이티브 쿠폰 엔드포인트 사용 중단

2021년 6월 8일에 쿠폰 광고 API 사용 중단을 발표했습니다. 이 변경 사항은 그래프 API v12.0이 릴리스되는 즉시 적용됩니다.

Messenger 플랫폼 - 항공사 템플릿

2021년 6월 8일에 항공사 템플릿 사용 중단을 발표했습니다. 이 변경 사항은 2021년 12월 6일부터 적용됩니다.