Introducing Graph API v22.0 and Marketing API v22.0

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

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

일반 업데이트

주택, 고용, 금융 상품 및 서비스(신용 포함) 캠페인의 고객 리스트 맞춤 타겟 사용과 관련된 마케팅 API v22 변경 사항

'v22.0+'에 적용되며 2025년 3월에 모든 버전으로 출시될 예정

특정 고객 리스트 맞춤 타겟은 주택, 고용, 금융 상품 및 서비스(신용 포함) 캠페인에 사용할 수 없게 됩니다. 업데이트에 대한 자세한 내용은 여기를 참조하고 제한 사항이 회원님에게 적용되는지 확인하세요. 이에 더해, is_sac_cfca_terms_certified 필드가 광고 세트 수준에 추가됩니다. 예시를 살펴보세요. 주택, 고용, 금융 상품 및 서비스(신용 포함) 캠페인에 사용되는 고객 리스트 맞춤 타겟이 Meta CLCA 인증을 준수한다는 사실을 인증하기 위해 이 필드를 사용해야 합니다. 2025년 4월 초부터 요구 사항을 준수하지 않는 고객 리스트 맞춤 타겟을 사용하는 기존 캠페인/광고 세트는 일시 중단될 수 있습니다. 이 경우 광고 관리자 및 마케팅 API에 안내와 함께 오류가 표시됩니다.

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

• POST /{ad-account-id}/adsets
• POST /{ad_set_id}

맞춤 타겟 API v22

2025년 1월 6일부터 새로운 is_eligible_for_sac_campaigns 필드를 사용하여 특별 광고 카테고리 캠페인의 광고 세트에 맞춤 타겟을 사용할 수 있는지 여부를 식별할 수 있습니다. 타겟을 사용할 특별 광고 카테고리 캠페인의 의도된 special_ad_categories 및 special_ad_category_countries와 해당 타겟을 사용하여 광고 세트를 만들거나 수정할 ad_account_id를 제공해야 합니다.

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

• GET /custom_audience_id

선택한 도시와 지역에 관심 있는 사람들에게 도달하기

새로운 위치 타게팅 기능이 도입됩니다. 이 기능은 광고주가 타겟 도시 또는 지역을 넘어 확장하여 성과를 높일 수 있도록 지원하는 한편 Meta 광고 시스템이 특정 위치에 관심을 보인 사람들에게 유연하게 광고를 노출하도록 해줍니다.

이 기능은 기존 위치 타게팅 기능을 확장한 것으로, 광고주가 동일한 국가 내에서 타게팅하는 도시와 지역으로 여행하거나 그곳에서 구매하려는 의도가 있는 사람들 또는 해당 도시와 지역에 관심이 있는 사람들에게 도달할 수 있도록 합니다.

테스트 기간에 새로운 위치 타게팅 기능을 사용한 광고주는 결과당 비용이 6.7% 감소했습니다.

자세한 내용은 여기에서 확인하세요.

사용 중단 및 핵심 변경 사항

Instagram User, Instagram Media, Instagram Carousel, Instagram Comment 엔드포인트가 IG User, IG Media, IG Comment 엔드포인트로 대체됨

개발자들이 손쉽게 비즈니스를 위해 솔루션을 만들 수 있도록 Instagram 그래프 API와 마케팅 API가 변경됩니다. 이러한 변경 사항에 따라 그래프 API v22에서는 Instagram User, Instagram Media, Instagram Carousel, Instagram Comment 개체가 사용 중단되고 기존 IG User, IG Media(carousels 개체 포함), IG Comment 개체로 대체됩니다. 최신 개체에는 대부분의 사용 사례를 지원하도록 동급의 기능이 추가되었습니다.

개발자들은 2026년 1월 21일까지 영향을 받는 마케팅 API 엔드포인트의 사용을 업데이트하고 2025년 4월 21일까지 영향을 받는 그래프 API 엔드포인트의 사용을 업데이트해야 합니다. API 호출에서 그래프 API 버전을 자동으로 업데이트하고 있다면 이 변경 사항은 그래프 API v22를 사용하는 개발자에게 직접 영향을 주므로 변경 사항을 검토할 것을 권장합니다.

개발자 블로그에서 변경되는 엔드포인트, 더 이상 지원되지 않는 사용 사례, 변경 일정을 비롯한 자세한 내용을 확인하세요.

상세 타게팅 제외 기능 삭제

광고주가 성과를 높이도록 지원하기 위한 계속되는 노력의 일환으로, 상세 타게팅 제외 기능이 삭제됩니다. 타겟 관리 기능 내에서 계정 수준에서 직장을 제외하는 기능은 앞으로도 계속해서 지원할 것입니다. 계정 관리 기능에 대한 자세한 내용은 여기를 참조하세요.

이 변경 사항은 캠페인 성과를 향상하는 데 도움이 될 것이라 기대합니다. 광고주 테스트 결과에 따르면 상세 타게팅 제외를 사용하지 않는 경우 상세 타게팅 제외를 사용하는 경우에 비해 전환당 비용 중간값이 22.6% 감소했습니다.

이 변경 사항의 결과로 제외 필드에서 맞춤 타겟이 사용 중단됩니다. excluded_custom_audiences 필드를 사용하면 계속해서 맞춤 타겟 제외 기능을 사용할 수 있습니다.

개발자들은 2025년 1월 21일부터 코드 변경 사항을 구현할 수 있으며, 2025년 4월 21일까지 업데이트를 적용해야 합니다. 이 변경 사항은 v22에서 출시됩니다. 개발자 블로그에서 이 변경 사항과 관련된 영향을 받는 엔드포인트 리스트를 확인하세요.

마케팅 API에서 기본 개선 사항 번들 사용 중단

마케팅 API v22.0이 어드밴티지+ 크리에이티브 개선 사항에 미치는 영향

새로운 마케팅 API 버전에서는 어드밴티지+ 크리에이티브 기본 개선 사항 번들이 사용 중단되고 개별 크리에이티브 개선 사항 옵트 인으로 대체됩니다. 여기에서 어드밴티지+ 크리에이티브에 대해 자세히 알아보세요.

여기에서 개발자 커뮤니티와 관련 있는 자세한 내용을 살펴보고, 개발자 문서에서 추가 상세 정보를 확인하세요.

기본 개선 사항이 더 이상 지원되지 않는 엔드포인트는 다음과 같습니다.

• POST /{ad_account_id}/adcreatives
• POST /{ad_account_id}/ads
• GET /{ad_id}/previews

Instagram 조회 지표 도입 및 노출 및 재생 지표 사용 중단

Instagram API의 기능을 Instagram 앱의 기능과 맞추기 위한 지속적인 노력의 일환으로, 모든 API 버전에서 미디어 및 사용자 인사이트에 대해 'views' 지표가 도입됩니다. 미디어 인사이트의 경우 피드, 스토리 및 릴스 개체가 views를 반환합니다. 사용자 인사이트의 경우 팔로워 유형 및 미디어 제품 유형에 대해 다층적인 분석 데이터로 'views' 지표가 지원됩니다.

이에 더해, v22에서는 다음과 같은 지표가 사용 중단됩니다.

• plays(미디어 인사이트): 노출이 이미 집계된 후에 릴스가 재생되기 시작한 횟수.
• clips_replays_count(미디어 인사이트): 릴스 초기 재생 후에 릴스가 재생되기 시작한 횟수. 이는 동일한 릴스 세션에서 1ms 이상의 다시 재생으로 정의됩니다.
• ig_reels_aggregated_all_plays_count(미디어 인사이트): 노출이 이미 집계된 후에 릴스가 재생 또는 다시 재생되기 시작한 횟수.
• impressions(미디어 및 사용자 인사이트): Instagram Media 개체가 조회된 총 횟수.

미디어 인사이트 'impressions' 지표는 2024년 7월 2일 또는 이후에 생성된 미디어에서만 사용 중단됩니다. 이 날짜 전에 생성된 미디어의 경우 모든 버전의 API가 계속해서 기존과 동일한 값을 반환합니다.

자세한 내용은 Instagram User 인사이트 및 Instagram Media 인사이트에 대한 개발자 문서를 참조하세요. 문제가 발생하지 않도록 개발자들이 2025년 4월 21일까지 업데이트를 적용하도록 지원하세요.

Meta 비즈니스 SDK

Meta 비즈니스 SDK v22 릴리스

그래프 API v22 출시 직후 Meta 비즈니스 SDK v22가 출시될 예정입니다. 이번 릴리스는 버그 수정 사항, 종속성 업그레이드, 새로운 기능을 비롯하여 그래프 API v22에 맞춰 업데이트된 API 인터페이스를 포함합니다.

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

• 2025년 5월: Facebook 플랫폼 SDK v17.0 이하의 지원이 중단될 예정

API 버전 사용 중단:

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

그래프 API

• 2025년 5월 14일: 그래프 API v16이 사용 중단되고 플랫폼에서 삭제될 예정
• 2025년 9월 12일: 그래프 API v17이 사용 중단되고 플랫폼에서 삭제될 예정

마케팅 API

• 2025년 2월 4일: 마케팅 API v19.0이 사용 중단되고 플랫폼에서 삭제될 예정
• 2025년 5월 6일: 마케팅 API v20.0이 사용 중단되고 플랫폼에서 삭제될 예정

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