출시 노트

v23 (2026년 1월 28일)

v23에는 다음과 같은 새로운 기능과 업데이트가 추가되었습니다.

최신 버전으로 업그레이드에서 안내를 확인하세요.

광고

  • AdGroupAdErrorEnum에 AD_SHARING_NOT_ALLOWED이 추가되었습니다. 이 오류는 더 이상 허용되지 않는 여러 광고 그룹 간에 광고를 공유하려고 할 때 반환됩니다.
  • AdFormatType에 새로운 형식 유형이 추가되었습니다(TEXT, VERTICAL_ADS_BOOKING_LINK, VERTICAL_ADS_PROMOTION).
  • v23에서 CallAd 및 CallAdInfo 지원이 삭제되었습니다. 자세한 내용은 https://support.google.com/google-ads/answer/6341403을 참고하세요.

애셋

결제

캠페인

전환수

  • 광고를 시청한 후 동일한 채널의 동영상을 시청하는 사용자를 추적할 수 있도록 ConversionActionCategory에 YOUTUBE_FOLLOW_ON_VIEWS를 추가했습니다.

디맨드젠 캠페인

인센티브

  • 파트너가 고객의 Google Ads 인센티브를 프로그래매틱 방식으로 가져와 적용할 수 있는 직접 선택 (CYO) 인센티브 지원이 추가되었습니다.

    • IncentiveService 추가됨:
      • FetchIncentive 메서드를 사용하면 국가, 언어, 선택적으로 사용자의 이메일을 기반으로 사용자에게 제공되는 인센티브를 가져올 수 있습니다. 이렇게 하면 맞춤설정된 '직접 선택'(CYO) 인센티브 옵션이 반환될 수 있습니다.
      • ApplyIncentive 메서드를 사용하면 사용자가 선택한 인센티브를 특정 Google Ads 고객 계정에 적용할 수 있습니다.
    • GoogleAdsService.Search 및 GoogleAdsService.SearchStream을 통해 쿼리할 수 있는 읽기 전용 리소스 AppliedIncentive이 추가되었습니다. 상환된 인센티브의 상태, 이행 진행률, 보상 금액, 관련 날짜 등의 세부정보를 제공합니다.
    • 인센티브 가져오기 또는 적용과 관련된 문제를 처리하기 위해 IncentiveErrorEnum에 새로운 오류 코드가 추가되었습니다.
    • AuthenticationErrorEnum에 INVALID_EMAIL_ADDRESS이 추가되었습니다.

  • 실패를 더 세부적으로 프로그래매틱 방식으로 처리할 수 있도록 향후 출시에서 IncentivesService에 추가 오류 코드가 추가될 예정입니다. 애플리케이션에서 이러한 새로운 오류 모드를 관리할 수 있도록 예정된 공지사항과 출시 노트를 통해 이러한 새로운 오류 코드를 모니터링하는 것이 좋습니다.

계획

권장사항

  • GenerateRecommendationsRequest에 is_new_customer 필드가 추가되었습니다. CAMPAIGN_BUDGET 유형의 추천에 대해 true로 설정하면 신규 고객용 모델을 사용하여 추천을 생성합니다. 캠페인이 없는 고객에게만 권장됩니다.

보고서

쇼핑

  • 이제 ShoppingPerformanceView에서 전환 날짜별로 분류된 conversions_by_conversion_date, all_conversions_by_conversion_date, conversions_value_by_conversion_date, all_conversions_value_by_conversion_date, value_per_conversions_by_conversion_date, value_per_all_conversions_by_conversion_date 측정항목을 지원합니다.
  • 이제 ShoppingPerformanceView에서 search_budget_lost_impression_share, search_rank_lost_impression_share, search_budget_lost_absolute_top_impression_share, search_rank_lost_absolute_top_impression_share와 같은 경쟁 측정항목을 지원합니다.
  • ShoppingProduct에 product_image_uri이 추가되었습니다.

카테고리 광고

  • 여행 피드를 사용하는 검색 캠페인의 AdGroup에 vertical_ads_format_setting이 추가되어 게재할 수 있는 광고 형식을 관리할 수 있습니다.
  • AdGroupCriterion에 vertical_ads_item_group_rule_list 기준 유형이 추가되었습니다. SharedCriterion에 vertical_ads_item_group_rule가 추가되었습니다. 이 기준을 사용하면 여행 피드를 사용하는 검색 캠페인에서 상품 그룹을 타겟팅할 수 있습니다.
  • 이제 AI Max를 실행하는 검색 캠페인에 업종 광고 데이터 피드를 연결하여 텍스트 광고와 함께 숙박 시설 프로모션 및 예약 링크 여행 광고를 표시할 수 있습니다. 광고 그룹 수준에서 vertical_ads_format_setting을 사용하여 표시할 형식을 관리하고, 세트의 상품 그룹 규칙을 정의하여 세로형 광고 데이터 피드에서 엔티티의 하위 집합을 타겟팅할 수 있습니다. 또한 이제 AdFormatType 및 업종 광고 데이터 피드의 측정기준별로 보고서를 분류할 수 있습니다.

동영상

v22 (2025년 10월 15일)

v22에는 다음과 같은 새로운 기능과 업데이트가 추가되었습니다.

애셋

  • LANDING_PAGE_PREVIEW이 새로운 이미지 확장 소재 필드 유형으로 추가되었습니다.
  • AssetGenerationService (베타)이 도입되었습니다.
    • 이 서비스를 사용하면 생성형 AI를 사용하여 텍스트 및 이미지 확장 소재를 생성할 수 있습니다. 이 서비스는 처음에는 제한된 수의 비공개 베타 참여자에게만 제공됩니다.
    • GenerateText: 최종 URL, 자유 형식 프롬프트, 키워드, 기존 캠페인 컨텍스트와 같은 입력을 기반으로 텍스트를 생성합니다.
    • GenerateImages: 최종 URL, 자유 형식 프롬프트, 기존 캠페인 컨텍스트와 같은 입력을 기반으로 이미지를 생성하거나 기존 제품 이미지를 재맥락화하여 이미지를 생성합니다.
    • 애셋 생성 중 오류는 AssetGenerationErrorEnum의 코드로 반환됩니다.

캠페인

디맨드젠 캠페인

일반

  • AddBatchJobOperations 요청당 작업 수 제한을 10,000개로 추가했습니다.
  • ListBatchJobResultsRequest에서 page_size 필드의 처리 업데이트됨
    • 이제 page_size가 설정되지 않았거나 0인 경우 기본값은 최대 1,000입니다 (이전에는 INVALID_PAGE_SIZE 반환).
    • 이제 page_size이 1,000을 초과하면 API에서 INVALID_PAGE_SIZE 오류를 반환합니다 (이전에는 1,000으로 자동 제한됨).
  • 결제 프로필 활성화 비율 한도가 초과된 경우를 나타내는 새로운 오류 코드 QuotaError.PAYMENTS_PROFILE_ACTIVATION_RATE_LIMIT_EXCEEDED가 추가되었습니다.

실적 최대화 캠페인

  • 실적 최대화 캠페인에 새로운 AssetAutomationType 값이 추가되었습니다.
    • GENERATE_IMAGE_ENHANCEMENT: 자동 자르기와 같은 향상된 이미지를 자동으로 생성할 수 있습니다. 기본적으로 사용 설정됩니다.
    • GENERATE_IMAGE_EXTRACTION: 최종 URL에서 이미지를 자동으로 가져올 수 있습니다. 기본값은 계정 수준 동적 이미지 확장 소재 설정입니다.
  • 실적 최대화 캠페인에서 AssetPerformanceLabel가 삭제되었습니다.
  • 삭제된 Campaign.url_expansion_opt_out의 기능은 이제 AssetAutomationSetting에서 AssetAutomationType FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION을 설정하여 관리됩니다.
  • 실적 최대화 캠페인의 새로운 세그먼트가 추가되었습니다. 이러한 각 세그먼트는 실적 최대화 캠페인에서만 사용할 수 있으며 다른 캠페인 유형을 선택하면 데이터를 반환하지 않습니다.
    • ad_using_product_data: 광고가 Google 판매자 센터 피드의 제품 데이터를 사용하는지 여부를 나타냅니다.
    • ad_using_video: 광고에서 동영상 애셋을 사용하는지 여부를 나타냅니다.

계획

보고서

통합 목표

  • 기존 고객의 재참여를 위해 최적화할 수 있도록 고객 유지 목표 지원이 추가되었습니다.

동영상

v21 (2025년 8월 6일)

최신 버전으로 업그레이드에서 안내를 확인하세요.

AI Max 검색 캠페인

  • 이제 Campaign의 ai_max_setting.enable_ai_max 필드를 사용하여 AI Max 검색 캠페인을 사용 설정할 수 있습니다. AI Max 검색 캠페인은 검색어 일치를 통해 검색 캠페인의 도달범위를 확장하고, 설정된 경우 타겟팅 및 광고 소재 관리 기능이 게재되는지 여부를 관리할 수 있습니다. 이전 버전 요청에서 설정된 텍스트 애셋 자동화 및 브랜드 목록 관리 기능은 검색 캠페인용 AI Max가 명시적으로 전환되어 사용 중지될 때까지 계속 적용됩니다. Campaign.ai_max_setting.bundling_required를 사용하여 텍스트 애셋 자동화 및 브랜드 목록 관리 기능을 적용하거나 수정하려면 검색 캠페인용 AI Max를 사용 설정해야 하는지 확인할 수 있습니다. AdGroup.ai_max_ad_group_setting.disable_search_term_matching는 상위 캠페인에서 검색 캠페인에 AI Max를 사용 설정한 경우 검색어 일치를 사용 중지하는 데 사용할 수 있습니다. AI Max 검색 캠페인으로 한 단계 높은 실적 달성하기 블로그 게시물을 참고하세요.

  • 캠페인에서 AI Max 검색 캠페인을 사용 설정하지 않고 FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION을 선택할 때 검색 캠페인에 대해 발생하는 CampaignError.AI_MAX_MUST_BE_ENABLED이 추가되었습니다.

  • AI Max 검색 캠페인에서 광고 그룹 수준으로 타겟팅 관리 기능을 적용하는 기능이 추가되었습니다. 이제 광고 그룹에 다음 기준을 추가할 수 있습니다.

    • 브랜드 목록
    • 위치
    • 웹페이지 (URL 규칙)

  • 검색어, 광고 제목, 방문 페이지의 조합에 대한 실적을 보고하는 ai_max_search_term_ad_combination_view이 추가되었습니다. 이 보기에는 광고를 트리거한 검색어와 이러한 특정 조합의 실적이 표시됩니다. 향후 출시에는 실적 최대화 캠페인 데이터도 포함하는 추가 보기가 포함될 예정입니다. 실적 최대화 캠페인 데이터를 얻기 위해 구현을 이전하지 않으려면 해당 출시를 기다리는 것이 좋습니다.

  • search_term_match_type 세그먼트에 AI_MAX이 새 값으로 추가되었습니다.

애셋

캠페인

전환수

  • conversion_attribution_event_type 세그먼트의 새 값으로 ENGAGED_VIEW이 추가되었습니다.

  • 고객이 더 이상 ConversionUploadService에서 debug_enabled 모드에 액세스할 수 없습니다. 이 필드는 TRUE로 설정된 경우 리드 확보용 향상된 전환 가져오기에서 CLICK_NOT_FOUND 오류와 SUCCESS를 구분하는 데 사용되었습니다.

디맨드젠 캠페인

EU 정치 광고 변경사항

이러한 EU 정치 광고 변경사항은 v19.2 및 v20.1 출시에도 적용되었습니다.

  • Campaign.contains_eu_political_advertising이 추가되었습니다. 이 필드는 캠페인에 유럽연합을 타겟팅하는 정치 광고 콘텐츠가 포함되어 있는지 여부를 나타냅니다. 이 필드가 CONTAINS_EU_POLITICAL_ADVERTISING로 설정되면 2025년 9월 22일부터 EU에서 캠페인이 더 이상 게재되지 않습니다. 이 필드가 설정되지 않으면 새 캠페인을 만들기 위한 API 호출이 FieldError.REQUIRED 오류와 함께 실패합니다.

    기존 캠페인의 경우 캠페인 또는 광고 그룹 수준에서 근접성, 위치 또는 위치 그룹 타겟팅을 변경하기 전에 contains_eu_political_advertising 필드를 설정해야 합니다. 캠페인에서 자체 선언을 완료하지 않은 경우 기존 캠페인의 이러한 캠페인 또는 광고 그룹 기준을 만들거나 업데이트하는 API 호출이 CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION 오류와 함께 실패합니다.

    v19.x 및 20.x 버전의 경우 이 필드를 설정해야 한다는 요구사항이 아직 적용되지 않지만 향후에는 적용될 예정입니다. 이 변경사항은 사전에 공지됩니다.

  • 실험의 캠페인에서 유럽연합을 타겟팅하는 정치 광고가 포함되어 있는지 자체 선언하지 않은 경우 트라이얼 및 실험에서 ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION이 발생합니다.

실적 최대화 캠페인

  • 이제 새 실적 최대화 캠페인의 Campaign.brand_guidelines_enabled 기본값이 true로 설정됩니다.

  • campaign_search_term_view 보고서가 추가되었습니다. 이 뷰에는 캠페인 수준에서 집계된 검색어 측정항목이 표시됩니다. 또한 이 보기에는 검색어에 대한 실적 최대화 캠페인 지원이 도입되었습니다.

  • search_term_match_type 세그먼트의 새 값으로 PERFORMANCE_MAX이 추가되었습니다.

계획

보고서

동영상

v20.1 (2025년 8월 6일)

이러한 EU 정치 광고 변경사항은 v19.2 및 v21 출시에도 적용되었습니다.

EU 정치 광고 변경사항

  • Campaign.contains_eu_political_advertising이 추가되었습니다. 이 필드는 캠페인에 유럽연합을 타겟팅하는 정치 광고 콘텐츠가 포함되어 있는지 여부를 나타냅니다. 이 필드가 CONTAINS_EU_POLITICAL_ADVERTISING로 설정되면 2025년 9월 22일부터 EU에서 캠페인이 더 이상 게재되지 않습니다.

    기존 캠페인의 경우 캠페인 또는 광고 그룹 수준에서 근접성, 위치 또는 위치 그룹 타겟팅을 변경하기 전에 contains_eu_political_advertising 필드를 설정해야 합니다. 캠페인에서 자체 선언을 완료하지 않은 경우 기존 캠페인의 이러한 캠페인 또는 광고 그룹 기준을 만들거나 업데이트하는 API 호출이 CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION 오류와 함께 실패합니다.

    v19.x 및 20.x 버전의 경우 이 필드를 설정해야 한다는 요구사항이 아직 적용되지 않지만 향후에는 적용될 예정입니다. 이 변경사항은 사전에 공지됩니다.

  • 실험의 캠페인에서 유럽연합을 타겟팅하는 정치 광고가 포함되어 있는지 자체 선언하지 않은 경우 트라이얼 및 실험에서 ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION이 발생합니다.

v20 (2025-06-04)

v20에는 다음과 같은 새로운 기능과 업데이트가 추가되었습니다.

최신 버전으로 업그레이드에서 안내를 확인하세요.

애셋

asset_group 보고서에 몇 가지 새로운 측정항목과 세그먼트 열이 추가되었습니다.

측정항목 열

세그먼트 열

캠페인

전환수

  • 이제 기존 고객의 google_ads_conversion_customer 필드를 업데이트하여 교차 계정 전환 추적을 선택하거나 기존 전환 추적 상위 요소를 다른 관리자 계정으로 변경할 수 있습니다.

  • ClickConversion.user_ip_address 필드가 추가되었습니다. Google Ads는 유럽 경제 지역(EEA), 영국 (UK), 스위스 (CH)의 최종 사용자에 대한 IP 주소 일치 타겟팅을 지원하지 않습니다. 이러한 지역의 사용자의 IP 주소 공유를 조건부로 제외하는 로직을 추가하세요. 사이트, 앱, 기타 속성에서 수집하는 데이터에 대해 명확하고 포괄적인 정보를 사용자에게 제공하고, 법 또는 관련 Google 정책에서 요구하는 경우 동의를 얻어야 합니다. 자세한 내용은 오프라인 전환 가져오기에 대한 정보 페이지를 참고하세요.

디맨드젠 캠페인

권장사항

  • GenerateRecommendationsRequest를 사용할 때 캠페인 구성 중에 ShoppingSetting 지원이 추가되었습니다.
    • 표준 실적 최대화 캠페인이 아닌 소매업에 대한 추천이 생성되어야 하는 시점을 나타내기 위해 GenerateRecommendationsRequest에 merchant_center_account_id 필드가 추가되었습니다.

계획

  • AudienceInsightsService 및 ContentCreatorInsightsService에서 AudienceInsightsDimension.YOUTUBE_DYNAMIC_LINEUP를 대체하기 위해 AudienceInsightsDimension.YOUTUBE_LINEUP를 추가했습니다. 이 새로운 측정기준을 사용하면 YouTube Select (YTS) 라인업의 통계와 메타데이터를 가져올 수 있습니다. Google Ads 전반에서 동적 광고 소재를 광범위하게 삭제하는 데 맞춰 YOUTUBE_DYNAMIC_LINEUP와 연결된 객체(예: DynamicLineupAttributeMetadata, AudienceInsightsDynamicLineup)를 대체했습니다. 이 기능은 허용 목록에 있는 계정에서만 사용할 수 있습니다.
  • AudienceInsightsService, ContentCreatorInsightsService, ReachPlanService에 AdditionalApplicationInfo 및 ApplicationInstance가 추가되었습니다. 이 기능은 허용 목록에 있는 계정에서만 사용할 수 있습니다.
  • 더 자세한 유용한 정보를 제공하도록 AudienceInsightsService 및 ContentCreatorInsightsService을 업데이트했습니다. 이제 두 서비스에서 모두 새로운 AudienceInsightsDimension.DEVICE 및 AudienceInsightsAttribute.device를 사용하여 기기별로 콘텐츠 크리에이터 데이터를 분류할 수 있습니다. 이 기능은 허용 목록에 있는 계정에서만 사용할 수 있습니다.
  • 콘텐츠 크리에이터 분석을 더 포괄적으로 수행할 수 있도록 GenerateCreatorInsightsResponse에 집계된 동영상 측정항목(engagement_rate, average_views_per_video, average_likes_per_video, average_shares_per_video, average_comments_per_video, shorts_views_count, shorts_video_count, is_brand_connect_creator)이 추가되었습니다. 이 기능은 허용 목록에 있는 계정에서만 사용할 수 있습니다.
  • ContentCreatorInsightsService을 위해 GenerateCreatorInsightsRequest에 sub_country_locations이 추가되었습니다. 이를 통해 하위 국가 지리적 위치를 지정하여 크리에이터 통계 검색을 세부적으로 조정할 수 있습니다. sub_country_locations 필드는 criteria 필드에서 search_attributes oneof를 사용하는 경우에만 지원됩니다. sub_country_locations이 다른 기준 유형과 함께 제공되면 요청이 무효화됩니다. 이를 통해 콘텐츠 크리에이터 인사이트에 대한 더 세부적인 지리적 타겟팅 및 분석이 가능합니다. 이 기능은 허용 목록에 있는 계정에서만 사용할 수 있습니다.
  • 고객이 소유한 퍼스트 파티 사용자 목록을 반환하는 ReachPlanService.ListPlannableUserLists가 추가되었으며 GenerateReachForecastRequest의 잠재고객 타겟팅 옵션에 UserListInfo가 추가되었습니다. 이를 통해 특정 고객의 계획 가능한 사용자 목록을 가져온 다음 해당 특정 잠재고객을 타겟팅하는 캠페인의 도달범위 예측을 생성할 수 있습니다. 이러한 개선사항은 퍼스트 파티 잠재고객 데이터를 예측에 직접 통합하여 맞춤 도달범위 계획을 개선합니다. 도달범위 예측은 허용 목록에 추가된 계정에서만 사용할 수 있습니다.

동영상

  • 보고서에 포함되는 TV 화면의 자연 YouTube 동영상에 게재되는 AdFormatType.PAUSE 광고가 추가되었습니다. 이러한 광고는 일시중지 화면의 정적 동영상 프레임 바로 옆에 표시됩니다. 여기에는 일시중지된 자연 동영상의 아래 또는 위에 광고 패널에 표시되는 디맨드젠 동영상 광고가 포함되지 않으며, 이 광고는 AdFormatType.INFEED에 보고됩니다.

보관처리된 출시 노트

보관된 출시 노트는 지원 종료된 버전을 참고하세요.