Google Ads API v20 완벽 가이드: 알아야 할 모든 기능

Google Ads API v20은 자체 AI Max 컨트롤, 네이티브 애셋 라이브러리 쓰기, 새로운 검색어 인사이트 엔드포인트를 최초로 탑재한 버전입니다. 동시에 2년 동안 지원 중단되었던 일부 레거시 서비스를 최종적으로 폐기합니다. 대규모로 운영한다면 v20 마이그레이션은 선택이 아닙니다. 지원 중단된 v17 및 이전 버전 엔드포인트는 공개된 서비스 종료일에 데이터 반환을 중단합니다.

v20의 새로운 기능

주요 추가 사항은 SearchTermInsightService, AssetLibraryService 쓰기 메서드, AiMaxAdGroupService, 그리고 이전에 UI에서만 볼 수 있었던 추천을 프로그래밍 방식으로 노출하도록 확장된 RecommendationService입니다. 또한 더 풍부해진 실험 메타데이터 필드와 새로운 식별자 형식을 지원하는 전용 ConversionActionService.upload_offline_conversions v2 메서드가 새로 추가되었습니다.

처리해야 할 지원 중단 사항

레거시 AdGroupAdAssetView, 일반 이메일 문자열을 사용하는 기존 Customer Match 업로드 메서드, 키워드 입찰 시뮬레이터용 v17 보고 필드가 모두 폐기되었습니다. 이를 참조하는 코드는 v20에서 오류를 반환합니다. 마이그레이션은 기계적이지만 지루한 작업입니다. 중간 규모 통합 기준으로 일주일의 작업 일정을 계획하십시오.

AI Max 컨트롤

AiMaxAdGroupService는 마침내 이전에 UI에서만 가능했던 AI Max 동작에 대한 캠페인 수준 토글을 제공합니다. 애셋 옵트인 수준, 브랜드 제외 목록, 지역 제외 재정의, 전환 기간 재정의를 광고 그룹별로 설정할 수 있습니다. 이를 통해 예산 가드레일이 필요한 엔터프라이즈 스택 내에서 AI Max를 사용할 수 있게 되었습니다.

애셋 라이브러리 쓰기

AssetLibraryService는 이제 프로그래밍 방식 업로드, 태깅 및 여러 캠페인 간 애셋 재사용을 지원합니다. AssetGroupService와 결합하면 자체 DAM(디지털 애셋 관리 시스템)에서 Performance Maxi머신러닝을 사용하여 검색, 디스플레이, YouTube, Gmail, 지도 전반에 예산을 자동 할당하는 Google Ads 캠페인 유형입니다.용어 사전에서 자세히 알아보기 → 캠페인을 종단 간 프로비저닝할 수 있습니다. 업로드된 애셋은 UI 업로드와 동일한 콘텐츠 검토 큐를 따르므로 생성 즉시 게재되지 않습니다.

v19 및 이전 버전에서의 마이그레이션 경로

Google은 주요 버전당 14개월의 서비스 종료 기간을 보장합니다. v17은 2026년, v18은 2026년 4분기, v19는 2027년에 서비스가 종료됩니다. 지원되는 마이그레이션 경로는 v17에서 v20으로 직접 이동하는 것이며, v17 → v18 → v19 → v20 순서가 아닙니다. 버전을 건너뛰는 경우 모든 엔드포인트를 개별적으로 다시 테스트해야 합니다. 4년마다 한 번의 마라톤보다는 12개월마다 주요 버전당 마이그레이션 스프린트를 권장합니다.

SEO에 안전한 콘텐츠 전략이 필요하신가요?

저희 팀은 AI 효율성을 활용하면서 Google이 보상하는 품질, 전문성 및 독창성을 유지하는 콘텐츠 전략을 구축합니다. 순위도 오르고 전환도 되는 콘텐츠를 만들어 드립니다.