Facebook 그래프 API v17.0 및 마케팅 API v17.0 소개

오늘 Facebook 그래프 API v17.0과 마케팅 API v17.0을 릴리스합니다. 이번 릴리스에서 개발자 커뮤니티에서 주목할 만한 변경 사항을 아래에 소개합니다. 이러한 변경 사항에는 Meta 플랫폼과 비즈니스 앱 통합에 영향을 미칠 수 있는 공지 사항, 제품 업데이트 및 사용 중단에 대한 알림 등이 포함됩니다.

모든 변경 사항의 전체 리스트와 자세한 내용은 변경 사항을 참조하세요.

사용 중단 및 핵심 변경 사항

사용 중단된 광고 전략

광고 전략 베타 제품은 2022년 10월 28일 이후에 사용 중단되었습니다. 이로 인해 마케팅 API v17.0을 릴리스한 이후로 캠페인 엔드포인트에서 ad_strategy_id 및 ad_strategy_group_id 필드를 사용 중단합니다.

오프라인 전환 API 사용 중단

2023년 2월부터 전환 API가 오프라인 이벤트를 완전히 지원함으로써 현재 오프라인 전환 API 엔드포인트가 제공하는 것과 동일한 기능을 보장합니다. 웹 및 오프라인 이벤트 API를 하나의 API로 통합함으로써, 광고주가 채널 간 마케팅 데이터를 사용하여 광고 최적화, 맞춤 타겟, 측정을 향상하는 방법을 단순화하고 개선하고자 합니다.

2023년 5월 23일에 릴리스된 그래프 API 버전 17 이후부터 오프라인 전환 API는 더 이상 오프라인 이벤트를 지원하지 않습니다. 오프라인 전환 API 통합을 사용하는 광고주는 통합을 전환 API 통합으로 바꾸는 것이 좋으며 이 절차에 성공하기 전까지는 오프라인 전환 API를 업데이트하지 않을 것을 권합니다.

기존 목표 생성 사용 중단

2021년 12월에 공지했듯이, 새로운 캠페인을 만들 때 목표 선택 경험을 새롭게 디자인하여 광고주를 마케팅 목표를 더욱 잘 달성할 수 있도록 돕는 캠페인 설정으로 효과적으로 안내하도록 했습니다. 새로운 경험인 결과 중심적 광고 경험으로 인해 마케팅 API가 변경되었습니다.

마케팅 API v17.0 릴리스부터 기존 경험과 목표를 사용 중단하는 과정이 시작됩니다. 마케팅 API v17.0을 사용하면 결과 중심적 광고 경험 목표로만 캠페인을 생성할 수 있으며 기존 목표의 API는 사용 중단됩니다. 기존 캠페인과 그 사본은 여전히 지원되고 이 버전에서 영향을 받지 않습니다. 자세한 내용은 최신 개발자 블로그 게시물을 참조하세요.

어드밴티지+ 크리에이티브 기본 개선 사항 필드 필수

올해 초에 마케팅 API에서 어드밴티지+ 크리에이티브 기본 개선 사항이 릴리스되었습니다. 2023년 5월 23일부터 마케팅 API 사용자는 'enroll_status' 필드에서 'OPT_IN' 또는 'OPT_OUT'을 입력하여 어드밴티지+ 크리에이티브의 기본 개선 사항에 대한 광고 등록을 명시해야 합니다. 필드가 빈칸으로 남겨진 경우 사용자는 오류를 수신하고 필드를 완료하기 위해 이동하게 됩니다. 마케팅 API의 어드밴티지+ 크리에이티브 기본 개선 사항에 대해 자세히 알아보려면 이 개발자 블로그 게시물을 참조하세요.

영향을 받는 엔드포인트는 다음과 같습니다.

• POST /{ad-account-id}/adcreatives
• POST /{ad-account-id}/ads

스트리밍용 어드밴티지+ 카탈로그 광고 사용 중단

마케팅 API v17 릴리스부터 스트리밍용 어드밴티지+ 카탈로그 광고(스트리밍용 A+CA) 카탈로그 사용이 중단됩니다. 스트리밍용 A+CA 대신 커머스 카탈로그 광고를 사용하는 것이 좋습니다. 커머스 카탈로그를 설정하기 위한 가이드는 다음과 같습니다. 사용 중단되는 엔드포인트는 다음과 같습니다.

• 스트리밍용 A+CA 카탈로그 만들기: vertical media_titles를 포함한 owned_product_catalogs 에지
• 미디어 제목 피드 업로드: 스트리밍용 A+CA 카탈로그를 위한 product_feeds 에지
• 미디어 제목 항목 만들기: 스트리밍용 A+CA 카탈로그를 위한 media_titles 에지
• 스트리밍용 A+CA 카탈로그를 사용하여 캠페인 만들기: L3, L2 또는 L1에서 DAS 카탈로그를 포함하는 campaigns 에지

2023년 8월 21일부터 위의 변경 사항이 모든 마케팅 API 버전에 적용되고 L3, L2 또는 L1 수준에서 스트리밍용 A+CA 카탈로그를 연결하는 모든 캠페인이 일시 중단됩니다.

인스턴트 아티클 API 사용 중단

2023년 4월 20일에 인스턴트 아티클 제품이 사용 중단되었으며 이제 퍼블리셔가 인스턴트 아티클을 관리하도록 하는 API가 사용 중단됩니다.

사용자 계정에 비즈니스 관리 권한 적용

이전에는 추가적인 비즈니스 관리 대상 페이지가 business_management 권한에 액세스하지 않고 반환되었습니다. 2023년 5월 23일부터는 비즈니스 관리 대상 페이지에 대한 액세스 권한을 계속 받으려면 business_management 권한이 필요합니다. 이 권한과 관련된 자세한 내용은 business_management 페이지를 참조하세요.

API 버전 사용 중단:

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

그래프 API

• 2023년 6월 8일: 그래프 API v10.0이 사용 중단되고 플랫폼에서 삭제될 예정
• 2023년 9월 14일: 그래프 API v11.0 이 사용 중단되고 플랫폼에서 삭제될 예정
• 2024년 2월 8일: 그래프 API v12.0이 사용 중단되고 플랫폼에서 삭제될 예정

마케팅 API

• 2023년 8월 15일: 마케팅 API v14.0이 사용 중단되고 플랫폼에서 삭제될 예정
• 2023년 8월 15일: 마케팅 API v15.0이 사용 중단되고 플랫폼에서 삭제될 예정

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

Facebook 플랫폼 SDK

플랫폼 SDK의 2년 사용 중단 일정에 따른 향후 사용 중단 및 버전 중단 소식을 참조하세요.

• 2023년 6월: Facebook 플랫폼 SDK v9.0 이하 사용 중단 예정
• 2023년 10월: Facebook 플랫폼 SDK v11.0 이하 사용 중단 예정
• 2024년 2월: Facebook 플랫폼 SDK v12.0 이하 사용 중단 예정