메타가 2026년 11월 4일 Graph API v27.0과 Marketing API v27.0을 공개했다. 새 버전에서는 신규 광고에 두 가지 기능이 기본으로 켜지고, 위치 정보가 담긴 유사 타깃(lookalike) 생성 요청이 거부되며, 카탈로그 일괄 처리 엔드포인트가 작동하지 않는다. 코드로 메타 광고를 운영하는 팀이라면 자사 연동이 여기에 걸리는지부터 확인해야 한다.

이 내용은 광고 업계 매체 PPC Land가 메타 개발자 블로그 게시물을 정리해 보도한 것이다. 게시물은 메타의 아야드 파라(Ayyad Farah)와 만자리 제인(Manjari Jain)이 썼다. 이 기사는 PPC Land 보도를 바탕으로 하며, 메타 원문은 직접 확인하지 못했다. 보도에 따르면 변경 사항은 광고와 페이지 시스템을 코드로 연결하는 모든 곳에 영향을 준다. 대행사 구매 툴, 카탈로그 관리 플랫폼, 소셜 미디어 대시보드, 자체 스크립트가 모두 해당한다.

변경 항목마다 적용 시점이 다르다

변경 항목마다 적용 범위와 시점이 다르다. 먼저 v27.0에서 바로 시작하는 변경이 있다. 제품 쇼케이스 기본 적용, 카탈로그 일괄 처리 엔드포인트 중단, 페이지 게시물 AI 생성 표시 편집 추가가 여기에 속한다. 이 변경은 v27.0 요청에만 적용되고, 이전 버전은 그대로다.

다음으로 약 90일 뒤 모든 버전으로 넓어지는 변경이 있다. 기기 확장 기본값과 유사 타깃 위치 필드 거부다. 90일 뒤는 PPC Land 계산으로 2027년 2월 2일이며, 메타 요약은 이 시점을 2027년 2월로만 밝혔다. 유사 타깃 위치 필드 거부의 다른 버전 적용 날짜는 아직 확정되지 않았다. 이 두 변경은 연동 프로그램을 v27.0으로 올리지 않았더라도 같은 시점에 적용된다.

마지막으로 버전과 상관없이 일괄 적용되는 변경이 있다. 오래된 Graph API 기능 여섯 가지가 신규 앱에 막혔고, 영상 인사이트 지표 하나가 2026년 11월 초부터 데이터를 돌려주지 않는다.

제품 쇼케이스와 기기 확장은 건드리지 않으면 켜진다

제품 쇼케이스는 API에서 product_extensions라고 부르는 기능이다. 광고에 카탈로그 상품을 함께 보여준다. v27.0에서는 크리에이티브에 제품 쇼케이스 설정이 없는 광고를 만들 때 메타가 이 기능을 켤 수 있다. 다만 모든 광고에 켜지는 것은 아니다. 메타는 광고주의 카탈로그에서 특정 제품 세트가 광고와 맞는다고 높은 확신이 있을 때만 적용한다고 밝혔다. 메타는 별도 연동 작업이 필요 없다고 설명한다. 기존 방식을 유지하려면 degrees_of_freedom_spec.creative_features_spec.product_extensions.enroll_status를 OPT_OUT으로 지정해야 한다. 영향을 받는 대표 엔드포인트로는 광고를 만드는 POST /{ad-account-id}/ads와 크리에이티브를 만드는 POST /{ad-account-id}/adcreatives가 꼽혔다.

메타 게시물 상단 요약은 이 기능을 선택 사항이라고 적었다. 옵트아웃이 존재한다는 좁은 의미에서는 맞지만, v27.0에서 설정이 없는 크리에이티브는 기본적으로 메타가 켤 수 있다는 점을 PPC Land는 짚었다. '높은 확신'의 기준, 노출 위치, 성과 수치, 메타가 이 기능을 켰다는 사실을 API로 어떻게 알 수 있는지는 게시물에 없다.

기기 확장도 같은 방식이다. 특정 모바일 기기나 운영체제를 지정한 신규 판매(Sales) 광고 세트에서 targeting.targeting_automation.individual_setting.device 필드를 비워 두면 '다른 모바일 기기로 더 많은 사람에게 도달' 설정이 켜진다. 메타는 성과가 좋아질 가능성이 있을 때 다른 기기와 운영체제로도 광고를 내보낸다. 지정한 기기에만 내보내려면 device를 0으로 지정해야 한다. 기존 광고 세트는 바뀌지 않는다. 모바일 앱 전환 위치와 특별 광고 카테고리(주거, 고용, 금융 상품)는 이 설정에서 제외된다. PPC Land는 필드를 보내지 않던 기존 연동이 이제는 침묵이 곧 확장이 되는 구조라고 분석했다. 메타는 '적용 대상'을 제외 두 가지 외에 따로 정의하지 않았고, 다른 기기로 얼마나 광고가 옮겨 가는지 수치도 없다.

유사 타깃과 카탈로그 연동은 오류로 이어질 수 있다

v27.0에서 POST /act_{ad-account-id}/customaudiences는 country나 location_spec이 들어 있는 lookalike_spec을 거부한다. 대체 필드는 필요 없다. 유사 타깃은 이를 쓰는 광고 세트에서 고른 지역으로 노출되고, 메타는 해당 필드가 효과가 없다고 밝혔다. 새 유사 타깃을 만드는 요청만 영향을 받고, 이미 만든 유사 타깃과 이를 쓰는 광고는 그대로 돌아간다. 다른 버전에서는 약 90일 뒤부터 거부되며 날짜는 아직 확정되지 않았다.

카탈로그 쪽 변경은 경고 없이 오류를 낼 가능성이 가장 크다. /{catalog-id}/batch는 폐기됐고 /{catalog-id}/items_batch를 쓰라는 것이 메타 안내다. 광고주나 에이전시가 카탈로그 API로 상품 정보를 메타와 맞추는 소프트웨어가 대상이다. 메타는 코드를 바꾸지 않으면 애플리케이션이 멈출 수 있다고 직접 경고했다. v27.0에서는 기존 엔드포인트가 오늘부터 작동하지 않는다. v26.0 이하에서는 v26.0 지원이 끝날 때까지 쓸 수 있는데, 그 날짜는 공개되지 않았다. 따라서 장애는 연동 프로그램이 v27.0으로 올라가는 순간 발생한다. 새 기능을 쓰려고 버전만 올린 카탈로그 도구가 같은 순간에 /batch를 잃는다. 메타는 items_batch로 옮기는 이전 가이드를 링크했다.

구버전 기능 여섯 가지와 지표 하나, 버전 종료일도 확인해야 한다

신규 앱은 오래된 Graph API 기능 여섯 가지를 쓸 수 없고, 기존 앱도 새 사용 사례를 추가할 수 없다. 모든 Graph API 버전에 적용된다. 여섯 가지는 여러 객체를 한 번에 가져오는 ids, 응답의 날짜 표기를 바꾸는 date_format, 비배치 요청의 HTTP 방식을 바꾸는 method, 응답 필드 이름을 바꾸는 .as(...), 응답을 자바스크립트 함수로 감싸는 callback, 요청을 백그라운드로 처리하는 asyncbatch다. 이미 쓰는 앱은 지원되는 이전 버전에서 계속 쓸 수 있다. 다만 이 기능들은 v28.0에서 폐기되며, 이미 쓰는 앱도 v28.0 요청에서는 쓸 수 없다. v28.0 공개일은 게시물에 없다. 여섯 가지 중 ids와 date_format은 v26.0에서 이미 폐기가 예고됐다. PPC Land는 v26.0이 나온 7월 29일 두 기능이 모든 버전에서 2026년 10월 27일 종료된다고 보도한 바 있는데, 이번 게시물은 그 날짜를 언급하지 않았다.

영상 인사이트의 total_video_consumption_rate 지표도 2026년 11월 초부터 모든 Graph API 버전에서 데이터를 돌려주지 않는다. 계산에 쓰던 3초 영상 시청자 수와 영상 도달이 v26.0에서 폐기됐기 때문이다. 영향을 받는 엔드포인트는 GET /{video-id}/video_insights이고, 메타는 직접 대체 지표가 없다고 안내했다. 게시물 날짜가 11월 4일인데 종료 시점은 '11월 초'로만 적혀 있어 이미 응답에서 빠졌거나 며칠 안에 빠질 수 있다. 이 지표를 그리는 대시보드는 이어 볼 대체 지표 없이 공백이 생긴다.

버전 종료일은 7월 발표와 같다. Graph API v21.0은 2027년 1월 21일, v22.0은 2027년 5월 20일에 플랫폼에서 제거된다. 게시물은 Graph API 버전의 종료일만 밝혔고, 마케팅 API 버전의 별도 일정은 없다.

한 가지 반대 방향 변경도 있다. v27.0부터 페이지 게시물을 수정할 때 AI 생성 자기 공개 표시를 추가하거나 제거할 수 있다. 선택 항목인 불리언 필드 is_ai_generated를 true로 보내면 표시가 붙고, false면 지워지며, 생략하면 기존 값이 유지된다. 이 필드는 광고가 아니라 페이지 게시물에만 해당한다. 메타 SDK에는 리드 양식의 전화번호 인증 코드(OTP) 항목이 추가된다. 선택형 인증은 자격이 되는 광고 계정에만 열리는데, 자격 기준과 적용 국가는 게시물에 나오지 않는다.

국내 마케터는 어떤 연동이 해당하는지부터 따져야 한다

이번 게시물은 API만 다루며, 광고 관리자 화면에도 같은 기본값이 적용되는지는 밝히지 않았다. 따라서 광고 관리자로만 운영하는 팀은 공식 문서를 먼저 열어 확인해야 한다.

API로 운영하는 팀은 세 가지를 확인하면 된다. 하나는 카탈로그를 /batch로 동기화하는 도구가 있는지이다. 이 도구는 v27.0으로 올리는 순간 멈추므로 items_batch 이전 일정을 먼저 잡는다. 둘째는 크리에이티브 생성과 판매 광고 세트 생성 요청이 제품 쇼케이스와 기기 확장 기본값을 원하는지이다. 원치 않으면 OPT_OUT 또는 device 0을 명시해야 한다. 기기 확장은 v27.0으로 올리지 않아도 약 90일 뒤 적용된다. 셋째는 유사 타깃 생성 요청에 country나 location_spec이 남아 있는지, 영상 인사이트 지표를 보고서에 쓰는지이다. 자체 도구라면 개발팀에, 대행사 구매 툴이라면 대행사에 공식 문서 검토 일정을 요청하면 된다.