출시 노트

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-08-06)

자세한 내용은 최신 버전으로 업그레이드를 참고하세요.

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년 6월 4일)

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 전반에서 동적 광고 모음이 광범위하게 삭제됨에 따라 DynamicLineupAttributeMetadata, AudienceInsightsDynamicLineup와 같은 YOUTUBE_DYNAMIC_LINEUP와 연결된 객체가 대체되었습니다. 이 기능은 허용 목록에 있는 계정에서만 사용할 수 있습니다.
  • 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에 보고됩니다.

v19.2 (2025년 8월 6일)

이러한 EU 정치 광고 변경사항은 v20.1 및 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이 발생합니다.

v19.1 (2025년 4월 16일)

v19.1에는 다음과 같은 기능과 변경사항이 추가되었습니다.

애셋

캠페인

디맨드젠 캠페인

변경 내역

  • ChangeStatusResourceType에 세 가지 리소스 유형을 추가로 지원합니다.
    • CAMPAIGN_BUDGET
    • ASSET_SET
    • CAMPAIGN_ASSET_SET
  • change_status 보고서에서 이러한 세 가지 세부 유형을 가져올 수 있습니다.

전환수

  • 이제 Google Ads API를 사용하여 새 고객을 만들 때 google_ads_conversion_customer 필드를 설정할 수 있습니다. 이전에는 읽기 전용 필드였습니다.

    참고: 이 기능은 비공개 허용 목록에 있습니다. 사용하려면 계정 관리자에게 문의하세요.

  • 이제 오프라인 전환을 업로드할 때 전환과 연결된 고객 유형을 지정할 수 있습니다.

  • ClickConversion에 새로운 session_attributes 필드가 도입되었습니다.

지역 서비스 광고

  • LocalServicesLead의 품질에 관한 의견을 제공하기 위해 LocalServicesLeadService에 새로운 RPC ProvideLeadFeedback를 추가했습니다.
  • 특정 리소스에 대한 의견이 제공되었는지 확인하는 새 필드 lead_feedback_submitted가 LocalServicesLead 리소스에 추가되었습니다.

계획 서비스

  • ReachPlanService.GenerateReachForecast에 타겟 게재빈도 월별 예측 지원이 추가되었습니다.
  • 광고주가 지원되는 계획 가능한 제품에 대한 추천 전환율을 요청할 수 있는 새로운 메서드 ReachPlanService.GenerateConversionRates이 추가되었습니다.
  • ReachPlanService.GenerateReachForecast의 디맨드젠 캠페인 예측:
    • 이제 개발자가 디맨드젠 캠페인의 도달범위 예측을 요청할 수 있습니다. 개발자는 새로운 DEMAND_GEN_MAX_CONVERSIONS 계획 가능한 제품 코드를 사용하여 디맨드젠 도달범위 예측을 생성할 수 있습니다.
    • 디맨드젠 캠페인 도달범위 예측을 요청하는 개발자가 전환율을 제공할 수 있는 새로운 conversion_rate 필드가 추가되었습니다. 새 ReachPlanService.GenerateConversionRates 메서드를 사용하여 추천 전환율을 가져올 수 있습니다. 이 필드는 디맨드젠 예측 요청에 필요합니다. 계획 가능한 다른 제품에서는 지원되지 않습니다.
    • 반환된 예측에 새 conversions 필드가 추가되었습니다. 이 필드에는 도달범위 곡선의 특정 지점에서 발생한 전환수가 포함됩니다. 전환은 DEMAND_GEN_MAX_CONVERSIONS 계획 가능한 제품에만 지원됩니다.

권장사항

동영상

  • 오디오 광고에 대한 읽기 전용 지원이 추가되었습니다. 이 기능에 대해 알아보려면 Google Ads 고객센터를 참고하세요. 이 변경사항은 다음을 노출합니다.
  • 인구통계 조정이 적용된 도달범위 측정항목 쿼리에 새로운 측정항목과 세그먼트가 추가되었습니다. 이러한 변경사항의 일환으로
    • coviewed_impressions 및 primary_impressions이라는 두 개의 새로운 측정항목 열이 도입되었습니다.
    • adjusted_age_range 및 adjusted_gender이라는 두 개의 새로운 세그먼트가 도입되었습니다.
    • 도달범위 측정항목 필드 (coviewed_impressions, primary_impressions, unique_users 또는 average_impression_frequency_per_user)와 함께 두 개의 새 세그먼트 중 하나를 선택하는 경우 이러한 열의 유효한 통계를 가져오려면 다른 세그먼트도 선택해야 합니다.
    • 이 기능은 현재 허용 목록에 포함된 고객에게만 제공됩니다.

v19 (2025년 2월 26일)

v19에는 다음과 같은 기능과 변경사항이 추가되었습니다.

자세한 내용은 최신 버전으로 업그레이드를 참고하세요.

계정 관리

  • 향후 변경사항을 고려하기 위해 CustomerError에 다음 값을 추가했습니다.
    • CREATION_DENIED_FOR_POLICY_VIOLATION
    • CREATION_DENIED_INELIGIBLE_MCC

광고

애셋

전환수

피드

  • Feed, FeedMapping, FeedService, AdGroupFeed, feed_placeholder_view 등 모든 피드 관련 항목이 삭제되었습니다. 이제 사용자는 assets를 사용하여 동일한 목적을 달성해야 합니다.

호텔 및 여행

실적 최대화 캠페인

계획

동영상

보관처리된 출시 노트

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