SA / 검색광고

구글 애즈 API v22, 10월 7일 끝난다 — 입찰 신호는 왜 끊기나?

읽는 데 6분 INSIGHTX
구글 애즈 API v22, 10월 7일 끝난다 — 입찰 신호는 왜 끊기나?

구글 애즈 API 버전 22(v22)는 2026년 10월 7일부터 모든 요청이 실패 처리됩니다. 광고 운영 화면을 손으로 쓰는 경우는 영향이 없지만, 전환 업로드·리포팅·입찰 조정을 이 버전에 연동해 둔 자동화 도구라면 그 시점부터 데이터가 끊깁니다. 구글 애즈 개발자 블로그가 9월에 재공지한 마감일이며, 별도의 유예 기간은 없습니다.

v22는 정확히 언제, 어떻게 멈추나?

구글은 2025년 10월 애즈 API v22를 출시했고, 2026년 9월 구글 애즈 개발자 블로그에 올라온 종료 예정 안내에서 2026년 10월 7일을 정식 종료일로 다시 확인했습니다. 이 날짜부터는 v22로 보낸 모든 요청이 즉시 실패로 처리되며, 일부 기능만 단계적으로 막는 방식이 아닙니다.

정확히 뭐가 끊기나?

영향을 받는 쪽은 구글 애즈 화면을 직접 쓰는 운영자가 아니라, v22 엔드포인트를 코드에 고정해 둔 연동 도구입니다. 오프라인 전환 업로드(uploadClickConversions), 전환 조정(uploadConversionAdjustments), 캠페인·키워드 리포팅을 이 버전으로 호출하는 스크립트나 데이터 연동 플랫폼이 10월 7일부터 오류를 돌려받습니다. 실제로 깃허브에 공개된 여러 데이터 연동 오픈소스 저장소에는 v22 만료를 경고하는 이슈가 이미 자동으로 등록돼 있습니다.

입찰에는 왜 영향이 가나?

스마트 입찰은 전환 데이터를 학습 신호로 써서 다음 입찰가를 정합니다. CRM에서 확인한 상담 성사 건을 오프라인 전환으로 올리거나 이메일·전화번호 목록을 Customer Match 오디언스로 올리는 경로가 v22에 묶여 있었다면, 10월 7일부터 이 신호가 끊깁니다. 화면상 전환수가 당장 0으로 보이지 않을 수는 있지만, 입찰 알고리즘이 받는 최신 학습 데이터는 그 시점부터 멈춥니다.

구글은 지난 6월 15일에도 오프라인 전환 가져오기의 신규 업로드를 옛 Google Ads API에서 한 차례 막고 Data Manager API로 옮긴 적이 있습니다. 이번 v22 종료는 그와 별개로, 버전 자체의 수명이 끝나 생기는 마감입니다.

지금 뭘 확인해야 하나?

  1. 전환 업로드·리포팅·입찰 조정에 쓰는 도구나 대행 스크립트가 어떤 API 버전을 호출하는지 벤더나 담당 개발자에게 확인합니다.
  2. v22로 고정돼 있다면 10월 7일 전에 현재 지원되는 버전(예: v25, 2027년 8월까지 지원)으로 올립니다. 정확한 지원 범위는 업그레이드 시점에 구글의 공식 버전 안내 페이지에서 다시 확인합니다.
  3. 업그레이드 후에는 구글 애즈 계정의 전환 메뉴에서 오프라인 전환·Customer Match 업로드 건수가 10월 7일 전후로 끊기지 않았는지 확인합니다.

유예 기간을 기대할 수 있나?

구글 애즈 API 공식 버전 안내 문서에 따르면, 새 버전의 클라이언트 라이브러리가 나온 뒤 이전 버전이 종료되기까지 최소 20주의 중복 기간을 둡니다. v22도 이 기간을 거쳐 마감일이 미리 공지됐던 것이므로, 종료일이 지난 뒤 추가로 봐주는 기간은 없습니다.

정리

구글 애즈 API v22는 2026년 10월 7일부터 모든 요청이 실패합니다. 영향을 받는 쪽은 수동으로 광고를 운영하는 담당자가 아니라, 전환 업로드·리포팅·입찰 조정을 v22에 연동해 둔 자동화 도구입니다. 오프라인 전환이나 Customer Match 업로드가 이 경로를 쓰고 있었다면 스마트 입찰이 받는 학습 신호가 끊길 수 있으므로, 10월 7일 전에 연동 도구의 API 버전을 먼저 확인해야 합니다.

Q & A

자주 묻는 질문

네이버 검색광고에도 이 마감이 적용되나요?
아닙니다. 이번 마감은 구글 애즈 API 버전 22에만 해당합니다. 네이버 검색광고 API는 별도의 공지 일정을 따르므로, 네이버 쪽 연동 도구를 쓰고 있다면 네이버 광고주센터의 공지를 따로 확인해야 합니다.
지금 쓰는 광고 관리 툴이 v22인지 어떻게 확인하나요?
외부 업체의 리포팅·입찰 자동화 툴을 쓰고 있다면 고객센터나 담당자에게 사용 중인 API 버전을 직접 문의하는 것이 가장 정확합니다. 자체 개발한 스크립트라면 코드에서 버전 문자열(v22)이 어디에 고정돼 있는지 검색해 확인할 수 있습니다.
마감을 넘기면 광고 캠페인 자체가 꺼지나요?
아닙니다. 구글 애즈 화면에서 직접 캠페인을 켜고 끄는 운영 자체는 영향을 받지 않습니다. 멈추는 쪽은 v22 API로 연동된 전환 업로드, 리포팅 자동 수집, 규칙 기반 입찰 조정처럼 코드로 호출하는 경로입니다.
v25로 업그레이드하면 당분간 안전한가요?
지금까지 안내된 기준으로는 v25가 2027년 8월까지 지원됩니다. 다만 지원 종료일은 구글이 상황에 따라 앞당기거나 새 버전을 추가할 수 있으므로, 업그레이드 시점에 구글 애즈 API 공식 버전 안내 페이지에서 최신 지원 범위를 다시 확인하는 것이 안전합니다.

← 저널 목록으로