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

2024년 1월 23일제작:Mohamed Amr Abouelhassan

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

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

일반 업데이트

모든 캠페인 목표 및 최적화에 어드밴티지 상세 타게팅 지원

Meta는 광고주의 성과 확대를 위한 지속적인 노력에서 어드밴티지 상세 타게팅 제품을 모든 캠페인 목표와 최적화에 이용할 수 있도록 이용 대상을 확대할 예정입니다.

어드밴티지 상세 타게팅은 Meta 어드밴티지 제품군의 하나로, 고급 자동화 기능 및 머신 러닝 기술을 이용해 광고주의 캠페인 성과를 개선합니다. 구체적으로 어드밴티지 상세 타게팅을 이용하면 시스템이 성과를 개선할 가능성이 높다고 예측하는 경우 광고주가 최초로 선택한 상세 타게팅 대상에 비해 한층 더 광범위한 사람들에게 도달하여 캠페인 성과를 개선할 수 있습니다.

2024년 1월 23일에 마케팅 API를 사용하는 광고주 및 파트너에 적용되는 변경 사항은 다음과 같습니다.

이제 노출, 동영상 조회, 도달, 참여 또는 광고 상기도 성과 증대에 최적화된 캠페인에 어드밴티지 상세 타게팅 사용 옵션을 설정할 수 있습니다.
잠재 고객에 최적화된 캠페인은 자동으로 어드밴티지 상세 타게팅이 적용되며 사용 옵션을 해제할 수 있습니다.
- 참고: 새로 만들거나 복제된 캠페인/광고 세트에는 어드밴티지 상세 타게팅 사용 옵션이 설정되어 있으며, 원하는 경우 설정을 해제할 수 있습니다.
링크 클릭 또는 랜딩 페이지 조회에 최적화된 캠페인은 자동으로 어드밴티지 상세 타게팅이 적용되며 사용 옵션을 해제할 수 없습니다.

마케팅 API를 사용하는 광고주 및 파트너에게 핵심적인 변경 사항이 적용됩니다. 개발자는 2024년 1월 23일부터 코드 변경 사항을 구현할 수 있으며, 2024년 4월 22일까지 코드를 업데이트해야 합니다. 해당 변경 사항은 새로운 API 릴리스 V19에서 출시됩니다.

<Impacted endpoints>

요청 유형	엔드포인트	변경 사항
GET	/act_{ad-account-id}/delivery_estimate /{adset-id}/delivery_estimate	링크 클릭 또는 랜딩 페이지 조회에 최적화된 캠페인에 ‘targeting_optimization’ 필드가 허용되지 않습니다. 이는 또한 전환, 값, 앱 설치, 앱 이벤트, 대화 등 어드밴티지 상세 타게팅에 포함되며 사용 옵션을 해제할 수 없었던 이전 최적화에도 해당됩니다. 노출, 동영상 조회, 도달, 참여, 광고 상기도 성과 증대에 최적화된 캠페인의 경우 targeting_as_signal 필드는 null 또는 0이 되어야 합니다.
POST	/act_{ad_account_id}/{adsets} /{adset-id}	링크 클릭 또는 랜딩 페이지 조회에 최적화된 캠페인에 ‘targeting_optimization’ 필드가 허용되지 않습니다. 이는 또한 전환, 값, 앱 설치, 앱 이벤트, 대화 등 어드밴티지 상세 타게팅에 포함되며 사용 옵션을 해제할 수 없었던 이전 최적화에도 해당됩니다. 어드밴티지 상세 타게팅을 사용하며 사용 옵션을 해제할 수 없는 모든 최적화는 목표와 최적화의 세트에 따라서 targeting_as_signal 필드가 1 또는 3으로 자동 설정될 예정입니다.

요청 유형

엔드포인트

변경 사항

GET

/act_{ad-account-id}/delivery_estimate

/{adset-id}/delivery_estimate

링크 클릭 또는 랜딩 페이지 조회에 최적화된 캠페인에 ‘targeting_optimization’ 필드가 허용되지 않습니다. 이는 또한 전환, 값, 앱 설치, 앱 이벤트, 대화 등 어드밴티지 상세 타게팅에 포함되며 사용 옵션을 해제할 수 없었던 이전 최적화에도 해당됩니다.
노출, 동영상 조회, 도달, 참여, 광고 상기도 성과 증대에 최적화된 캠페인의 경우 targeting_as_signal 필드는 null 또는 0이 되어야 합니다.

POST

/act_{ad_account_id}/{adsets}

/{adset-id}

링크 클릭 또는 랜딩 페이지 조회에 최적화된 캠페인에 ‘targeting_optimization’ 필드가 허용되지 않습니다. 이는 또한 전환, 값, 앱 설치, 앱 이벤트, 대화 등 어드밴티지 상세 타게팅에 포함되며 사용 옵션을 해제할 수 없었던 이전 최적화에도 해당됩니다.
어드밴티지 상세 타게팅을 사용하며 사용 옵션을 해제할 수 없는 모든 최적화는 목표와 최적화의 세트에 따라서 targeting_as_signal 필드가 1 또는 3으로 자동 설정될 예정입니다.

마케팅 API로 기존 목표를 사용하는 새로운 광고, 광고 세트 및 캠페인 만들기

마케팅 API v19.0부터는 더 이상 광고 문구를 통해 아래 리스트의 기존 목표를 사용하는 새로운 광고, 광고 세트 및 캠페인을 만들 수 없습니다. 간소화된 목표를 반영하여 광고 목표를 업데이트해야 합니다.

마케팅 API 버전 20부터는 기존 목표 캠페인에서 광고 및 광고 세트를 만드는 기능이 더 이상 지원되지 않습니다. 그러나 v20 이전의 API 버전(예: v19, v18)에서는 해당 기능을 계속 사용할 수 있습니다. 기존 목표를 사용하는 기존 광고에 대해서는 당장 조치를 취하지 않아도 됩니다.

영향을 받는 목표

BRAND_AWARENESS
CONVERSIONS
EVENT_RESPONSES
LEAD_GENERATION
LINK_CLICKS
LOCAL_AWARENESS
MESSAGES
OFFER_CLAIMS
PAGE_LIKES
POST_ENGAGEMENT
REACH
STORE_VISITS
VIDEO_VIEWS

영향을 받는 POST 엔드포인트

/{ad_id}/copies
/{campaign_id}/copies
/{adset_id}/copies

여기에서 기존 목표를 사용하여 캠페인을 만드는 경우의 API 변경 사항과 관련된 이전 개발자 블로그 게시물을 참조하세요.

FAQ

Q: 이번 변경 사항으로 인해 코드를 업데이트해야 하나요?

A: 예. V18에는 V19에서 작동하지 않는 API 호출이 다수 존재합니다(예:광고 문구를 통해 기존 목표를 사용하는 새로운 광고, 광고 세트 및 캠페인을 만들 수 없습니다).

Q: 변경 사항을 적용하기 전후에 각각 예상되는 동작은 무엇인가요?

A: 변경 사항 적용 전에는 기존 목표를 사용하는 광고, 광고 세트 또는 캠페인을 복사하는 API 호출이 정상적으로 작동하며, 앞으로는 작동하지 않습니다.

Q: 언제까지 코드 변경 사항을 구현해야 하나요?

A: 잠정적으로 2024년 9월 중에 v 18.0의 사용이 중단될 때까지입니다.

추가 개발자 문서

지원 센터 도움말

PPCA(페이지 전체 공개 콘텐츠 액세스 권한)

PPCA(페이지 전체 공개 콘텐츠 액세스 권한)를 이용해 수집된 데이터의 이용 사례가 변경되었습니다. 이 링크에서 자세히 알아보세요.

어드밴티지+ 타겟 API 소개

지난 10월, 광고주가 가장 도달하고자 하는 사람들에게 광고를 게재하면서 광고가 잠재적으로 도달할 수 있는 타겟을 확장하여 캠페인 성과를 높이는 새롭고 간소화된 타겟 생성 기능, 어드밴티지+ 타겟이 출시되었습니다.

이제 어드밴티지+ 타겟이 마케팅 API에 도입됩니다.

사용하려면 advantage_audience의 targeting_automation 매개변수를 1로 설정합니다.
사용 옵션을 해제하려면 advantage_audience의 targeting_automation 매개변수를 0으로 설정합니다.

사용 중단 및 핵심 변경 사항

Facebook 그룹 API 사용 중단

Facebook 그룹 API가 v19에서 사용이 중단되며 90일 후 모든 버전에서 삭제됩니다. 사용 중단 대상은 Facebook 그룹 API와 연관된 모든 권한(publish_to_groups, groups_access_member_info) 및 검수 대상 기능(그룹 API)을 포함합니다.

그룹 API의 주요 이용 사례에는 그룹 내 비공개 답장이 있습니다. v19에서 다른 변경 사항을 적용하여 개발자가 그룹 API를 사용하지 않고도 해당 기능을 이용할 수 있도록 할 예정입니다. v19에서는 대부분의 비공개 답장 개발자가 변경해야 할 사항이 없습니다. 비공개 답장 webhook을 수신한 후 그룹 API를 통해 그룹 게시물 엔드포인트를 호출했던 개발자는 이제 동일한 요청에 페이지 액세스 토큰을 사용해야 합니다.

엔드포인트가 사용 중단된 권한을 사용하는지 여부를 확신하지 못하는 개발자는 버전 19.0의 엔드포인트를 테스트하여 이를 확인할 수 있습니다.

페이지 인사이트 API 변경 사항 - 지표 사용 중단

Facebook이 클래식 페이지에서 새로운 페이지 환경으로 마이그레이션됨에 따라 몇 가지 페이지 인사이트 API 지표가 사용 중단됩니다. 자세한 정보는 이 링크를 참조하세요.

API 버전 사용 중단:

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

그래프 API

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

마케팅 API

2024년 2월 6일: 마케팅 API v16.0이 사용 중단되고 플랫폼에서 삭제될 예정
2024년 5월 14일: 마케팅 API v17.0이 사용 중단되고 플랫폼에서 삭제될 예정

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

Meta Business SDK

Meta Business SDK v19 출시

그래프 API v19 출시 직후 Meta Business SDK v19가 출시될 예정입니다. 이번 릴리스는 버그 수정 사항, 종속성 업그레이드, 새로운 기능을 비롯해 그래프 API v19에 맞춰 업데이트된 API 인터페이스를 포함합니다. 향후 API 업데이트에 발맞춰 SDK를 더 자주 출시함으로써 개발자가 최신 API 및 기능을 이용할 수 있게 할 계획입니다.

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