구글애즈 API v25.2 공개 — Performance Max 자산그룹에서 추적 템플릿과 URL 파라미터를 직접 설정한다

📖 약 4분 읽기

구글애즈 API(Application Programming Interface, 프로그램끼리 데이터를 주고받도록 정한 규격)의 새 버전이 공개되었습니다. 구글은 2026년 9월 23일(현지시간) 구글애즈 API v25.2 출시를 공식 발표했습니다. 이번 업데이트의 핵심은 성과 최대화(Performance Max) 캠페인의 자산그룹(광고 소재를 묶어 관리하는 단위) 단위에서 추적 템플릿과 URL 파라미터를 API로 직접 설정할 수 있게 된 점입니다.

태깅과 전환 추적을 대행사나 자동화 도구에 맡기고 있는 국내 광고주 입장에서는, 이번 변화가 자산그룹 단위의 URL 설정을 얼마나 세밀하게 자동화할 수 있는지와 직결되는 소식입니다. 성과 최대화 캠페인은 개별 광고 단위를 광고주가 직접 조정하기 어려운 구조로 설계되어 있었고, 그 결과 자산그룹별로 서로 다른 추적 규칙을 적용하려면 수작업이나 별도 스크립트가 필요했습니다. 이번 API 업데이트는 이 지점을 보완하는 변화입니다.

이번 글에서는 구글애즈 API v25.2의 주요 변경 사항을 중심으로 살펴봅니다. 자산그룹 단위 추적 설정이 실무에서 어떤 의미를 갖는지, 그리고 국내 광고주가 지금 확인해야 할 사항이 무엇인지를 함께 정리합니다.

자산그룹 단위 추적 설정이 달라지는 지점

이전까지 성과 최대화 캠페인에서는 추적 템플릿과 맞춤 URL 파라미터를 캠페인 전체 단위로만 설정할 수 있었습니다. 캠페인 하나에 여러 자산그룹을 운영하면서 상품군별로 다른 UTM 파라미터나 리다이렉트 규칙을 적용하려는 광고주에게는 제약으로 작용했습니다. 자산그룹마다 랜딩 페이지가 다르거나 마케팅 채널별로 다른 캠페인 코드를 심어야 하는 경우, 캠페인 단위 설정만으로는 정확한 추적이 어려웠습니다.

구글애즈 API v25.2는 자산그룹(AssetGroup) 객체에 tracking_url_template(추적 템플릿), url_custom_parameters(맞춤 URL 파라미터), final_url_suffix(최종 URL 접미사) 세 속성을 직접 지정하는 기능을 추가했습니다. 이에 따라 하나의 캠페인 안에서도 자산그룹마다 서로 다른 추적 규칙을 적용하는 일이 API 수준에서 가능해졌습니다. 자산그룹별 성과를 분리해 분석하거나, 상품 카테고리마다 서로 다른 트래킹 코드를 운영해야 하는 광고주에게는 설정의 정밀도가 높아진 변화입니다.

API 기술 세부사항 더 보기

이번 버전은 이전 버전(v25) 대비 drop-in upgrade로 안내되어, 클라이언트 라이브러리 업데이트만으로 적용할 수 있다고 발표되었습니다. 자산그룹 수준에서 직접 설정 가능해진 항목은 tracking_url_template, url_custom_parameters, final_url_suffix 세 가지입니다. 또한 SmartCampaignSettingService.GeneratePMaxDraftCampaign이라는 신규 메서드를 통해 스마트 캠페인을 성과 최대화 캠페인 초안으로 프로그래밍 방식으로 전환할 수 있습니다. 이 밖에 GenerateCreatorInsights가 유튜브 채널 ID뿐 아니라 채널 핸들로도 검색 가능하도록 개선되었습니다.

경쟁사 대비 위치를 보여주는 벤치마크 지표

BenchmarksService.GenerateBenchmarksMetrics에 PercentileMetrics와 BenchmarksCustomerPercentileTier가 추가되면서, 같은 업종·같은 목표를 가진 다른 광고주들 사이에서 내 성과가 상위 몇 퍼센트에 해당하는지 백분위로 확인할 수 있게 되었습니다. 이 지표를 불러오려면 supplemental_data에 PERCENTILE_DATA를 지정하고 benchmarks_source를 ALL_ADVERTISERS로 설정해야 합니다. 지금까지는 자신의 캠페인 지표만 보면서 개선 여부를 판단해야 했지만, 이제는 시장 안에서의 상대적 위치를 함께 참고할 수 있는 기준점이 생긴 셈입니다. 다만 비교 대상이 되는 전체 광고주 풀의 구성이 구체적으로 공개되지 않았다는 점은 해석에 참고할 부분입니다.

검색 입찰 조정 추천과 여행 광고 지표

API v25.2는 검색 입찰 조정에 대한 새로운 추천 기능도 함께 도입했습니다. 목표 전환당 비용(CPA, Cost Per Acquisition) 기준으로 입찰가가 낮게 설정된 경우 인상을 추천하고, 목표 광고비 대비 매출(ROAS, Return On Ad Spend) 기준으로 입찰가가 낮은 경우에는 인하를 추천하는 구조입니다. 입찰 조정을 담당자의 감에 의존해 판단하던 상황에서, 목표 지표와의 괴리를 수치로 짚어주는 참고 정보가 추가된 것으로 볼 수 있습니다.

여행·호텔 업종을 위한 세그먼트와 지표도 신설되었습니다. 예약 시점(advance_booking_window), 숙박 기간(length_of_booking), 투숙 시작일 등을 기준으로 데이터를 나눠 볼 수 있고, 업종 광고 가격 차이 비율이나 잠재 노출수 같은 지표도 함께 제공됩니다. 여행 업종은 예약 시점과 투숙 시기에 따라 전환 패턴이 크게 달라지는 특성이 있어, 세분화된 지표가 캠페인 운영에 실질적인 참고 자료가 될 것으로 보입니다.

국내 광고주가 지금 확인해야 할 지점

이번 업데이트는 구글이 성과 최대화 캠페인을 자동화의 중심축으로 계속 강화하면서, 동시에 광고주에게는 경쟁 위치·URL 추적·입찰 관련 데이터에 대한 접근권을 넓혀주는 방향으로 읽힙니다. 다만 이번 API 변경이 구글애즈 웹 화면(광고관리자)에 동일 시점에 반영되는지는 아직 확인되지 않았습니다. 기존 버전의 지원 종료 일정과 국내 대행사·태깅 자동화 툴이 신규 속성을 언제부터 지원할지도 공식적으로 확인된 바 없습니다.

자산그룹 단위 URL 추적을 대행사나 외부 툴에 위임하고 있는 광고주라면, 담당 대행사나 툴 벤더에 지원 여부와 적용 시점을 확인하는 절차가 필요합니다. 태그맨은 이러한 변화에 맞춰 자산그룹 단위 추적 규칙 점검을 지원하고 있습니다.

출처 :

• Google Ads Developer Blog(Google 공식), 「Announcing v25.2 of the Google Ads API」(2026-09-23), https://ads-developers.googleblog.com/2026/09/announcing-v252-of-google-ads-api.html
• Search Engine Land, 「Google Ads API v25.2 adds competitive benchmarks and PMax upgrades」(2026-09-25), https://searchengineland.com/google-ads-api-v25-2-adds-competitive-benchmarks-and-pmax-upgrades-491541

자주 묻는 질문 (FAQ)

구글애즈 API v25.2는 언제 공개되었나요?

구글은 2026년 9월 23일(현지시간) 구글애즈 API v25.2 출시를 공식 발표했습니다. API 자체 릴리스는 이보다 앞선 시점에 이뤄졌습니다.

자산그룹 단위 추적 설정은 기존 방식과 어떤 차이가 있나요?

기존에는 캠페인 전체에 하나의 추적 템플릿만 적용할 수 있었지만, 이제는 자산그룹마다 별도의 추적 템플릿과 URL 파라미터를 지정할 수 있습니다. 상품군별로 다른 추적 규칙을 쓰는 광고주에게 의미가 있는 변화입니다.

이번 업데이트는 구글애즈 웹 화면에도 바로 적용되나요?

이번 API 변경이 구글애즈 웹 화면(광고관리자)에 동일 시점에 반영되는지는 확인되지 않았습니다. 국내 대행사와 자동화 툴의 지원 시점도 아직 공식적으로 확인되지 않았습니다.