2026년 4월 22일 수요일
오늘 Google Ads API의 v24 출시를 발표합니다. 새로운 v24 기능을 사용하려면 클라이언트 라이브러리와 클라이언트 코드를 업그레이드해야 합니다. 업데이트된 모든 클라이언트 라이브러리와 코드 예시가 게시되었습니다.
내일(4월 23일 오전 10시(동부 표준시)) Discord에서 열리는 'Google Ads API 출시 하이라이트' 이벤트, Ads Developers YouTube 라이브 스트리밍 또는 LinkedIn 라이브 이벤트에서 이번 출시의 실시간 둘러보기에 참여하세요. 실시간 이벤트에 참석할 수 없는 분들을 위해 녹화본이 YouTube에 게시될 예정입니다. 궁금한 점이 있거나 이 게시물에 관해 논의하고 싶다면 Discord의 #ads-api 채널을 통해 문의해 주세요.
새로운 기능
장바구니 데이터를 사용한 전환 추적 지원: 장바구니 데이터를 사용한 전환 추적은 웹사이트 또는 앱의 전환 추적을 확장한 기능입니다. 장바구니 데이터를 사용한 전환 추적 기능으로 각 거래에서 판매된 제품의 세부정보를 제공할 수 있습니다. 이를 통해 주문 건수, 장바구니 제품 평균 개수, 수익, 총이익 등 Google Ads 계정 및 캠페인에 대한 고급 판매 데이터와 수익 보고서, 통계를 확인할 수 있습니다.
Google Ads API v24에서는 다음과 같이 이 기능을 지원합니다.
- 클릭한 제품뿐만 아니라 판매된 제품별로 전환 측정항목을 분류할 수 있는 새 리소스
CartDataSalesView가 추가되었습니다(예:product_sold_brand). 이를 통해 광고주는 고객이 광고를 클릭한 후 실제로 구매한 제품에 대한 통계를 확인할 수 있습니다(광고가 다른 제품에 대한 것이더라도 가능). - 입찰에 사용되지 않는 '모든' 측정항목이 여러 개 추가되었습니다. 이는 캠페인이 적극적으로 최적화하지 않는 전환도 포함하는 측정항목입니다(예:
all_cost_of_goods_sold_micros). 새 측정항목은 입찰 가능한 해당 측정항목을 지원하는 모든 리소스에 추가됩니다. conversion_attribution_event_type세그먼트가ShoppingPerformanceView리소스에 추가되어 장바구니 데이터 및 기타 전환 측정항목과 함께 선택할 수 있습니다. 이 세그먼트는 전환이 클릭 또는 조회에 기여하는지 여부를 나타내며 조회 후 전환으로 생성된 장바구니 데이터 통계를 인식하는 데 필요합니다.
업데이트된 기능
버전 v24에서는 업그레이드 시 코드 변경이 필요한 기존 기능의 업데이트가 도입되었습니다. 여기에서는 가장 중요한 변경사항을 다룹니다. 전체 변경사항 목록은 출시 노트를 확인하세요.
캠페인의 동영상 콘텐츠 제외 설정: 개별 캠페인에서 동영상 콘텐츠 제외 설정을 지정하는 기능이 간소화되었습니다. 이 설정은 고객 수준에서 사용할 수 있으며 모든 캠페인에 적용됩니다. 이러한 콘텐츠 제외 설정을 사용하면 광고 게재를 추가로 관리할 수 있고, Google 정책은 준수하지만 내 브랜드나 비즈니스에는 적합하지 않을 수 있는 콘텐츠 유형을 제외하는 데 도움이 됩니다. 동영상 콘텐츠 제외 설정에 대해 자세히 알아보려면 https://support.google.com/google-ads/answer/7515513을 참고하세요.
AudienceInsightsService 변경사항: 코드 리팩터링의 일환으로 InsightsAudience.topic_audience_combinations 요청 필드를 common 네임스페이스로 이동했습니다. 일부 프로그래밍 언어에서는 가져오기 지시문을 업데이트해야 할 수 있습니다.
ReachPlanService 변경사항: 코드 리팩터링의 일환으로 youtube_select_lineups 필드가 ReachPlanService.ListPlannableProducts 서비스에서 이동되었습니다. 이제 youtube_select_lineup_targeting 필드에서 라인업을 사용할 수 있습니다. YouTube Select 라인업은 자격을 갖춘 고객이 특정 시장에서 전환 가능성이 높은 잠재고객을 보유한 상위 1% YouTube 인기 채널을 타겟팅할 수 있는 예약 제품입니다. 자세히 알아보기
ContentCreatorInsightsService 변경사항: 코드 리팩터링의 일환으로 is_brand_connect_creator 필드가 ContentCreatorInsightsService.GenerateCreatorInsights 및 ContentCreatorInsightsService.GenerateTrendingInsights 서비스에서 삭제되었습니다.
대신 사용자는 partnership_opportunities에서 CREATOR_PARTNERSHIPS 옵션을 사용할 수 있는 크리에이터를 찾아야 합니다. Google Ads의 YouTube 크리에이터 파트너십은 스폰서 콘텐츠를 매개로 함께 협력할 YouTube 크리에이터를 찾고 크리에이터 파트너십을 효율적으로 관리할 수 있는 공간입니다. 자세히 알아보기
KeywordPlanIdeaService 변경사항: 더 간소화되고 안정적인 환경을 제공하기 위해 예측 인프라를 통합했습니다. Google Ads API v24에는 실적에 가장 직접적인 영향을 미치는 측정항목에 집중하여 계획 프로세스를 간소화하는 업데이트된 GenerateKeywordForecastMetrics 메서드가 도입되었습니다. 이 변경사항에 관한 자세한 내용은 조만간 블로그 게시물을 통해 공유해 드리겠습니다.
campaign_budget 리소스 변경사항: campaign_budget 리소스의 ad_sub_network_type 세그먼트가 이 뷰와 호환되지 않으므로 삭제되었습니다.
확장 소재 보기 변경사항: ad_group_asset, campaign_asset, customer_asset 보기에서 click_type 세그먼트가 삭제되었습니다. 이 변경사항은 데이터의 허위 진술을 방지하기 위해 Google Ads에서 이 세그먼트를 삭제한 최근 제품 변경사항과 일치합니다. ad_group_ad 리소스의 click_type 세분화를 사용하여 광고 실적 및 광고가 게재된 확장 소재에 대한 세부정보를 확인할 수 있습니다.
반응형 동영상 광고 변경사항: VideoResponsiveAdInfo를 이제 변경할 수 있습니다. 이러한 변경에 따라 videos, business_name, logo_images가 DemandGenVideoResponsiveAdInfo 및 VideoResponsiveAdInfo 객체 모두에서 필수 필드로 표시됩니다.
ShareablePreviewService 변경사항: 더 이상 부분 실패를 사용하지 않도록 ShareablePreviewService.GenerateShareablePreviews가 업데이트되었습니다. ID가 실패하면 요청에서 오류가 발생합니다. 자세히 알아보기
다음은 시작하는 데 도움이 되는 리소스입니다.
기술 지원 문제는 https://support.google.com/google-ads/contact/google_ads_api에 문의하세요.
- 아나시 P. , Google Ads API팀
라벨: google-ads-api, release