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

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

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

일반 공지 사항 및 업데이트

WhatsApp Business 플랫폼 오류 응답

API 오류 응답 동작을 개선하기 위한 지속적인 노력의 일환으로 다음과 같은 변경 사항을 적용했습니다.

• 오류 하위 코드는 사용하는 일이 드물고 사용해서는 안 되며, 더 이상 v16.0+ 오류 응답에 포함되지 않습니다. 대신 code 및 details를 사용하세요.
• 오류 코드 100("code":100)에는 특정 오류의 성격을 나타내는 여러 개의 고유한 제목이 있습니다. 이제 모든 코드 100 오류는 'Invalid Parameter'를 제목으로 사용합니다. 특정 코드 100 오류의 성격을 설명하는 기존 제목은 details 속성으로 옮겨졌습니다. 이 변경 사항은 이제 코드 100 오류 응답을 설명하는 Webhooks 페이로드에도 반영됩니다.
• Webhooks 오류 개체에 새로운 메시지 속성이 추가되었습니다. 이는 API 오류 응답 페이로드의 메시지 속성에 매핑됩니다.

이제 개발자 플랫폼에서 모든 API에 대한 고급 액세스 권한에 대해 비즈니스 인증 요청

2023년 2월 1일에 공지했듯이, 이제 Meta는 비즈니스 또는 조직의 실명 및 합법성을 확인하는 데 도움을 드리고자 개발자 여러분이 비즈니스 인증을 거쳐 Meta 개발자 플랫폼의 모든 권한에 대해 고급 액세스 권한을 얻도록 요청할 예정입니다.

2023년 2월 1일 이후에 만든 앱에 대해 Meta는 새로운 앱이 고급 액세스 권한을 요청하는 경우 점진적으로 이 정책을 적용할 것입니다. 2023년 2월 1일 이전에 고급 액세스 권한으로 만든 앱은 2023년 5월 1일부터 인증된 비즈니스에 연결되어야 합니다. 고급 액세스 권한을 승인받기 위해 비즈니스 인증이 필요한 권한의 리스트는 이 페이지를 참조하세요.

사용 중단 및 핵심 변경 사항

'여행 고려' 사용 중단

2018년, 저희는 여행 업계 광고주가 설정하여 여행 의도를 표했지만 아직 어디로 갈지 결정하지 못한 사람들에게 우선적으로 광고가 게재되도록 하는 전환 옵션으로 '여행 고려' 기능을 출시했습니다. '여행 고려' 기능은 기존 타게팅 옵션과 함께 사용할 수 있어 광고주가 Facebook, Instagram, Audience Network 전반에서 적시에 적절한 사람들에게 광고를 게재하는 데 도움이 되었습니다. 지난 4년 동안 끊임없이 머신 러닝 시스템을 개발하고 광범위하게 테스트를 진행한 결과, 이제 여행 업계 광고주가 이 전환 옵션을 사용하지 않고도 여행 의도가 있는 소비자들에게 도달하고 유사한 성과 목표를 달성하는 데 도움을 줄 수 있게 되었습니다.

2023년 2월 2일부터 '여행 고려' 전환 옵션은 새로운 캠페인에 대해 광고 관리자와 API에서 삭제됩니다. 이 전환 옵션이 더 이상 필요하지 않다는 결론에 이르렀으며, 광고주는 이 옵션을 사용하지 않아도 동일한 성과를 확인할 수 있습니다. 그동안 이 옵션을 설정하거나 해제해도 캠페인 성과에 눈에 띄는 영향을 미칠 가능성은 거의 없습니다.

머신 러닝 모델이 개선됨에 따라 이 전환 옵션을 사용하지 않고도 이제 동일한 목표와 성과를 달성할 수 있으므로 이 옵션을 삭제하면 더욱 간소화된 경험을 제공할 수 있을 것으로 판단됩니다.

잠재 고객 확보를 위한 항공편 광고 사용 중단

2018년 9월, 잠재 고객 확보를 위한 항공편 광고를 성공적으로 출시했습니다. 하지만 2021년 중반이 되자 이 상품에 기술적 문제가 발생하기 시작했고 캠페인의 효율적인 진행을 방해하는 여러 가지 오류도 확인되었습니다. 이에 따라 미리 광고주들에게 다른 잠재 고객 확보 옵션으로 전환할 것을 알리기로 결단을 내렸습니다. 리타게팅 기능이 여전히 있으므로 광고주는 이를 사용할 수 있습니다.

여러분이나 파트너가 현재 잠재 고객 확보를 위한 항공편 광고를 사용하고 있다면 2023년 5월 1일까지 모든 기존 캠페인을 비활성화하는 것이 좋습니다.

인스턴트 아티클 광고 노출 위치 사용 중단

2023년 4월 20일부터 인스턴트 아티클과 인스턴트 아티클 광고 노출 위치가 삭제됩니다. 인스턴트 아티클은 퍼블리셔들이 모바일에서 인터랙티브 미디어 아티클을 만든 후 Facebook 광고로 그러한 아티클을 수익화할 수 있도록 하기 위해 2015년에 처음으로 도입되었습니다. 하지만 Facebook을 이용하는 대부분의 사람들에게 뉴스 발견은 Facebook 경험의 극히 일부에 지나지 않으며, 피드에서 관련 콘텐츠를 덜 보고 싶다는 이용자들의 피드백도 있었습니다. 이에 따라 사용자의 선호도에 맞추기 위해 투자 분야를 조정하고 있습니다.

2023년 4월 20일부터 광고 관리자 및 마케팅 API 내에서 새로운 캠페인을 만들 때 더 이상 인스턴트 아티클 광고 노출 위치를 사용할 수 없게 됩니다. 2023년 4월 20일 이후에는 인스턴트 아티클 노출 위치만 포함하는 이전 광고 세트가 일시 중단되며, 인스턴트 아티클 노출 위치를 포함하는 기타 모든 광고 세트가 자동으로 업데이트되어 해당 노출 위치가 제외됩니다.

사용자 프로필에 게시된 콘텐츠에서 공감, 댓글 및 태그 숨기기

이번 릴리스에 적용되는 변경 사항으로 인해 세션 사용자의 댓글, 공감 및 태그가 숨겨집니다. 또한 사용자 프로필에 관한 게시물에 대해서는 'via' 및 'sharedposts' 필드에 빈 데이터가 반환됩니다. 이 변경 사항은 사용자 프로필에 게시되는 콘텐츠에만 영향을 미칩니다.

1.2 이전 버전의 TLS에 대한 지원 중단

보안 태세를 강화하기 위해 1.2 이전 버전의 TLS에 대한 그래프 API 지원을 중단합니다. TLS 1.2를 사용 중인 경우 정적 RSA 암호화(AES128-GCM-SHA256, AES256-GCM-SHA384, AES128-SHA, AES256-SHA, DES-CBC3-SHA)를 사용한 액세스도 지원이 중단됩니다. 이전 TLS 버전을 통한 API 요청의 경우 90일 후에 오류가 반환됩니다.

또한 이전 TLS 버전(TLS 1.2 이전, TLS 1.2를 사용하는 경우 정적 RSA 암호화[AES128-GCM-SHA256, AES256-GCM-SHA384, AES128-SHA, AES256-SHA, DES-CBC3-SHA] 사용)을 사용하는 브라우저에서는 2023년 5월 1일 이후로 developer.facebook.com에 대한 웹 트래픽이 거부됩니다.

WhatsApp 템플릿 카테고리

작년에 WhatsApp Business 플랫폼에서 전송되는 새로운 이용 사례를 포착하기 위해 WhatsApp 관리자 및 API의 템플릿 카테고리 유형을 업데이트했습니다. 2023년 2월 2일에 이러한 템플릿 카테고리의 이름을 변경하여 이용 사례를 보다 정확히 반영할 계획입니다.

• 마케팅 템플릿의 이름은 마케팅으로 유지됩니다 (변경 사항 없음)
• 거래 템플릿의 이름은 유틸리티로 변경됩니다
• OTP 템플릿의 이름은 인증으로 변경됩니다

비즈니스는 그래프 v16을 사용하여 템플릿을 만들거나 수정할 경우 이 업데이트된 템플릿 카테고리를 사용해야 합니다. 이 변경 사항은 5월 1일에 모든 버전에 적용됩니다. 따라서 어떤 버전이든지 사용하여 템플릿을 만들거나 수정하려고 할 경우 반드시 이 새로운 카테고리를 사용해야 합니다. 템플릿 만들기 또는 수정 과정에 지장이 없도록 비즈니스와 BSP는 2023년 5월 1일 전까지 새로운 카테고리 값과 템플릿을 사용하도록 API 호출을 업데이트하는 작업을 우선적으로 처리해야 합니다.

그 밖의 몇 가지 주요 날짜와 고려 사항은 아래와 같습니다.

• 템플릿 마이그레이션: 4월 1일, WhatsApp에서 기존의 모든 템플릿이 새로운 템플릿 카테고리로 마이그레이션됩니다. 비즈니스는 WhatsApp 관리자에서 템플릿의 새로운 카테고리를 조회할 수 있습니다. 검토는 5월 15일까지 가능합니다. 카테고리에 동의하지 않는 비즈니스는 5월 15일까지 재고 요청을 제출할 수 있습니다. 4월 1일부터 5월 1일 사이에 그래프 API v15 또는 이전 버전을 사용하여 새로 만들거나 수정하는 템플릿의 경우 5월 5일에 마이그레이션됩니다. 따라서 4월 1일부터 템플릿을 만들 때 v16을 호출하기 시작하는 것이 좋습니다. 5월 1일부터는 WhatsApp 관리자나 버전에 상관없이 그래프 API를 통해 만드는 모든 템플릿에 새로운 템플릿 카테고리가 반영됩니다.
• 새로운 템플릿 카테고리의 템플릿 만들기: 4월 1일부터 그래프 API v16 및 WhatsApp 관리자를 통해 만드는 모든 템플릿에 대해 카테고리 검증을 반드시 거쳐야 승인을 받을 수 있습니다. 선택된 카테고리가 잘못되었음이 감지되면 새로 만들거나 수정한 템플릿이 거부될 수도 있습니다. 선택된 카테고리가 템플릿 가이드라인에 따라 템플릿 콘텐츠와 일치하지 않는다는 설명이 거부 이유에 포함됩니다. 그러면 비즈니스는 카테고리 선택 항목을 수정하여 다시 제출하거나 템플릿을 수정하거나 결정에 대한 재고를 요청할 수 있습니다. 5월 1일부터 변수를 포함하여 새로 만드는 템플릿의 경우 인라인 샘플을 추가해야 합니다. 6월 1일부터는 템플릿 카테고리별 새로운 요율표를 바탕으로 비즈니스에 요금이 청구됩니다.

Messenger API 플랫폼

v16부터 메시지 빈도를 지정하는 옵션을 삭제하여 정기 알림을 간소화합니다. 자세한 내용은 Messenger 변경 사항을 참조하세요.

API 버전 사용 중단:

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

그래프 API

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

마케팅 API

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

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

Facebook 플랫폼 SDK

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

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