Google Ads API v24.2 발표

2026년 6월 24일 수요일

오늘 Google Ads API의 v24.2 출시를 발표합니다. 이번 부 버전에는 중요한 보안 업데이트, 새로운 AI 투명성 기능, 보고 기능 개선, 강력한 계획 인사이트가 포함되어 있습니다. 이러한 새로운 기능을 사용하려면 클라이언트 라이브러리와 클라이언트 코드를 업그레이드해야 합니다. 업데이트된 모든 클라이언트 라이브러리와 코드 예시가 게시되었습니다.

또한 복수 사용자 승인 체계 및 AI로 생성된 콘텐츠 라벨 지정에 대한 추가 지원을 위해 Google Ads API의 마이너 버전 v23.3, v22.2, v21.2를 출시합니다.

내일(6월 25일 오전 10시(동부 표준시)) Discord에서 열리는 'Google Ads API 출시 하이라이트' 이벤트 또는 Ads Developers YouTube 라이브 스트리밍에서 이번 출시의 실시간 둘러보기에 참여하세요. 실시간 이벤트에 참석할 수 없는 분들을 위해 녹화본이 YouTube에 게시될 예정입니다. 궁금한 점이 있거나 이 게시물에 관해 논의하고 싶다면 Discord의 #ads-api 채널을 통해 문의해 주세요.

새로운 기능

Google Ads API의 복수 사용자 승인 체계(MPA): Google Ads API에 복수 사용자 승인 체계에 대한 지원이 도입됩니다. 이 기능은 다른 관리자가 변경사항을 승인하도록 요구하여 사용자 초대 및 사용자 액세스 수준 업데이트와 같은 민감한 계정 작업을 보호합니다.

AI 투명성: AI로 생성된 콘텐츠 라벨 지정: AI 생성 애셋이 점점 더 보편화됨에 따라 투명성이 중요해지고 있습니다. Google Ads API v24.2는 Asset 및 Ad 리소스 모두에 SyntheticContentInfo 및 SyntheticContentAttestation 구조를 노출하여 AI 생성 광고 소재에 프로그래매틱 방식으로 라벨을 지정할 수 있습니다. 광고주와 Google 시스템 모두 확장 소재와 광고가 AI 생성되었는지 여부와 완전히 자동으로 생성되었는지 또는 광고주 검토를 거쳐 생성되었는지 여부를 증명할 수 있습니다. 2026년 8월 2일에 시행되는 EU AI법을 준비하는 경우 이 기능을 살펴보세요. v25의 통합 작업을 계획하는 데 도움이 되도록 광고주 증명 필드를 변경하는 인터페이스가 v22 이상 버전에 조기 도입됩니다. 이러한 버전에서는 인터페이스가 표시되지만 synthetic_content_info.advertiser_attestation.status 및 synthetic_content_info.advertiser_attestation.source 필드는 변경할 수 없습니다.

이러한 필드 중 하나에 대해 mutate 요청을 시도하면 다음 오류 중 하나가 반환됩니다.

'변경하려는 필드는 변경할 수 없습니다' 또는 '필드를 설정할 수 없습니다' 이러한 필드는 v25부터 완전히 변경 가능해집니다. v25가 출시될 때 시스템에서 전체 쓰기 기능을 사용할 수 있도록 지금 인터페이스를 사용하여 내부 로직을 빌드하고 테스트하는 것이 좋습니다.

실적 최대화 캠페인 게재위치 보고서 및 동영상 연결: 이번 출시에는 다음과 같은 주요 보고서 및 동영상 애셋 개선 기능도 포함되어 있습니다.

  • 실적 최대화 캠페인 게재위치 세분화: 이제 ad_network_type별로 performance_max_placement_view 보고서를 세분화하여 검색, 디스플레이, 파트너 네트워크에서 실적 최대화 캠페인 광고가 게재되는 위치를 세부적으로 파악할 수 있습니다.
  • YouTube 브랜드 채널 연결: Google Ads API를 통해 특정 브랜드 채널과 연결된 안전한 YouTube 데이터 연결을 직접 만들어 더 풍부한 동영상 애셋 통합을 지원합니다.
  • 방문 페이지 텍스트 생성: 새로운 LANDING_PAGE_TEXT_GENERATION AssetAutomationType를 사용하여 방문 페이지에서 직접 파생된 자동 텍스트 애셋 생성을 선택합니다.

새로운 실험 유형: 테스트 유연성을 높이기 위해 새로운 실험 유형이 도입되었습니다.

  • 캠페인 믹스 실험: 이 새로운 워크플로는 Google Ads UI의 맞춤 조합 캠페인 유형에 해당하는 COMPARE_CAMPAIGNS 실험 유형을 지원합니다. 이를 통해 최대 5개의 실험 부문에 기존 캠페인을 할당하여 단일 실험 내에서 여러 변수와 캠페인 유형을 비교할 수 있습니다. 이 워크플로는 맞춤 실적 최대화 캠페인 실험 만들기도 지원합니다.
  • 실적 최대화 캠페인 기능 테스트: 새로운 PMAX_TEXT_CUSTOMIZATION_FINAL_URL_EXPANSION 실험 유형을 사용하면 단일 캠페인 내에서 트래픽을 분할하여 텍스트 맞춤설정(이전 명칭: 자동으로 생성된 확장 소재) 및 최종 URL 확장의 영향을 테스트할 수 있습니다.

문서 업데이트

각 버전에 도입된 변경사항을 쉽게 파악할 수 있도록 출시 노트 형식을 개편했습니다. 이제 브레이킹 체인지가 브레이킹 체인지가 아닌 기능 업데이트와 별도로 나열됩니다. 기능 지원 중단 및 버전이 지정되지 않은 변경사항 가이드를 통해 기능 지원 종료를 추적할 수 있습니다.

이 새로운 형식이 API 업그레이드를 더 쉽게 수행하는 데 도움이 되기를 바랍니다. 사용해 보고 의견 보내기 버튼을 클릭하여 의견을 알려주세요.

시작하기

Google Ads API v24.2는 v24.1의 드롭인 업그레이드입니다. Google 클라이언트 라이브러리를 사용하는 경우 최신 버전의 클라이언트 라이브러리를 다운로드하여 이러한 기능을 사용하세요. 전체 변경사항 목록은 공식 출시 노트를 참고하세요. 기술 지원 문제는 https://support.google.com/google-ads/contact/google_ads_api에 문의하세요.

라벨: google-ads-api, release