개발자 소식으로 돌아가기

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

2023년 9월 12일제작:Naveen Santhanavel

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

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

일반 업데이트

위치 타게팅을 위한 타겟 위치 상태 옵션 통합

2023년 5월에 발표했듯이, 위치 타게팅 선택 항목 내에서 도달할 타겟의 유형을 선택할 때 타겟 위치 상태가 현재 기본 옵션인 이 지역에 거주하거나 최근 위치가 이 지역인 사람에 통합되었습니다. 이번 업데이트는 이전에 사용 가능하던 기타 여러 옵션을 통합하고 이 위치를 방문한 사람 옵션을 삭제한 것에 뒤따르는 조치입니다.

이 변경은 비즈니스에 더 많은 가치를 제공하고, 광고 시스템을 간소화하고, 타게팅 옵션을 간단하게 만들어 성과 효율을 높이고 사용률이 낮은 옵션을 삭제하려는 지속적인 노력의 일환입니다.

이번 업데이트는 새로운 캠페인이나 복제된 캠페인에 적용됩니다. 업데이트 공개 이전에 만든 기존 캠페인의 경우 임시 저장본 모드에 있거나 복제되지 않는 한 이 새로운 경험이 적용되지 않습니다.

WA 메시지 템플릿 API에 'add_security_recommendation' 및 'code_expiration_minutes' 추가

올해 초에 WhatsApp의 인증 솔루션을 출시했습니다. 이 솔루션을 사용하면 네이티브 버튼과 기본 설정된 인증 메시지가 포함된 인증 템플릿을 만들고 보낼 수 있습니다. 그래프 API v18의 출시와 함께 인증 템플릿 검색 기능을 개선합니다. 덕분에 BSP 및 비즈니스가 인증 템플릿 프로세스를 처음부터 끝까지 더 쉽게 처리할 수 있게 될 것입니다.

그래프 API v18을 통해 BSP 및 비즈니스는 기본 설정된 인증 메시지 템플릿 콘텐츠를 만든 후 그 내용을 더 잘 확인할 수 있습니다. 구체적으로, 페이로드가 WhatsApp에 사용되는 텍스트에 더해 기본 설정된 콘텐츠 구성 옵션도 반환합니다. 이 개선 사항 덕분에 BSP 및 비즈니스는 API를 바탕으로 인증 템플릿을 위한 '수정' UI를 만들 수 있습니다.

BSP 또는 비즈니스가 GET 요청에서 응답 전체를 받아 POST 요청으로 다시 보내는 방식으로 템플릿을 업데이트하는 경우 그래프 API v18로 업그레이드할 때 오류가 발생할 수 있습니다. 문제를 해결하려면 본문/머리글/바닥글 텍스트 필드를 삭제한 후 API로 다시 전달해야 합니다.

전화 유도 광고 만들기를 위한 개발자 문서 및 변경 사항 다시 출시

  • 전화 유도 광고를 위한 Facebook 릴스 노출 위치
    Facebook 릴스 플랫폼을 통해 전화 유도 광고를 게재할 수 있는 기능을 출시합니다. 사용자는 전화 유도 광고를 보며 고민하는 순간에 비즈니스에 전화를 걸 수 있습니다. 전화 유도 광고는 비즈니스가 관심 있는 사용자와 더 깊이 있는 대화를 나누는 데 도움이 됩니다. 비즈니스가 사람들의 실시간 Facebook 행동을 바탕으로 전화 유도 광고를 사용하여 광고할 수 있는 기회입니다. 비즈니스는 광고 관리자 내 '광고 세트' 수준에서 '노출 위치' 섹션 아래에 'Facebook 릴스'를 추가하도록 선택할 수 있습니다.
  • API를 통해 전화 유도 광고 다시 출시
    2023년 9월 12일, API를 통해 전화 유도 광고를 만드는 방법에 관한 업데이트된 가이드를 제공할 예정입니다. 전화 유도 광고 전용 문서를 도입하면 3P 개발자가 보다 쉽게 전화 유도 광고 캠페인을 만들고, 전화 관련 지표를 비롯하여 지속적인 전화 유도 광고 캠페인에 관한 인사이트를 조회하는 방법을 파악하게 될 것입니다. 앞으로 API 플랫폼을 통해 통화 추가 기능을 지원할 계획도 가지고 있습니다. 개발자가 API 플랫폼을 통해 전화 유도 광고를 만들려면 일반적인 광고를 만드는 데 필요한 일반적인 권한이 있어야 합니다.

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

사용 중단 및 핵심 변경 사항

사용자 세분화된 권한 기능에 대한 그래프 API 변경 사항

WhatsAppBusinessAccount를 위한 두 가지 그래프 API 엔드포인트를 업데이트하고 있습니다. 이러한 엔드포인트는 다음과 같습니다.

  • WhatsAppBusiness 계정에 연결된 메시지 템플릿 검색
  • WhatsAppBusiness 계정에 연결된 전화번호 검색

v18과 함께 '사용자 세분화된 권한'이라는 새로운 기능을 출시합니다. 이미 WhatsAppBusinessAccount에 추가된 모든 기존 사용자가 백필링되어 계속해서 액세스 권한을 가지게 됩니다(영향 없음).

관리자는 유연하게 이러한 권한을 변경할 수 있습니다. 관리자가 권한을 변경하고 한 사용자가 메시지 템플릿이나 전화번호를 조회할 수 있는 권한을 삭제하면 해당 사용자는 v18 이상의 모든 버전에서 메시지 템플릿이나 전화번호를 조회할 권한이 없다는 오류 메시지를 받기 시작합니다.

IG 미디어 및 사용자 인사이트에서 레거시 지표 이름 사용 중단

9월 12일부터 Instagram 그래프 API에서 중복 및 레거시 인사이트 지표가 삭제됩니다. 이는 개발자에게 단일 지표 소스를 공유하기 위한 조치입니다.

새로운 이번 업그레이드로 인해 혼란이 줄어들고 보고 안정성 및 품질이 증가합니다.

출시 후 90일이 지나면, 즉 2023년 12월 11일이 되면 더욱 일관된 Instagram 앱을 제공하기 위해 모든 버전의 Instagram 그래프 API에서 중복 및 레거시 인사이트 지표가 모두 삭제됩니다.

개발자 커뮤니티에서 보내주신 모든 피드백에 감사드리며 앞으로도 계속해서 함께 머리를 맞댈 수 있기를 기대합니다.

자세한 내용은 미디어 인사이트사용자 인사이트 개발자 문서를 참조하세요.

모든 Facebook Wi-Fi v1 및 Facebook Wi-Fi v2 엔드포인트 사용 중단

Facebook Wi-Fi는 비즈니스 매장에서 Wi-Fi 핫스팟에 연결하는 경험을 개선하기 위해 마련되었습니다. 덕분에 판매자의 고객이 간단히 Facebook에서 체크인하여 무료 Wi-Fi를 이용할 수 있었습니다. 또한 판매자가 누가 얼마나 오래 Wi-Fi를 이용할 수 있는지 관리하고, 광고와 통합하여 판매자의 Wi-Fi를 이용한 적이 있는 고객을 타게팅할 수 있었습니다. 이 상품은 2023년 6월 12일에 사용 중단되었습니다. 파트너 고지 기간이 끝났으므로 Facebook Wi-Fi v1 및 Facebook Wi-Fi v2에 사용되는 모든 엔드포인트가 사용 중단되고 삭제되었습니다.

API 버전 사용 중단:

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

그래프 API

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

마케팅 API

  • 2023년 9월 20일: 마케팅 API v14.0이 사용 중단되고 플랫폼에서 삭제될 예정
  • 2023년 9월 20일: 마케팅 API v15.0이 사용 중단되고 플랫폼에서 삭제될 예정
  • 2024년 2월 6일: 마케팅 API v16.0이 사용 중단되고 플랫폼에서 삭제될 예정

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

Facebook 플랫폼 SDK

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

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