출시 노트

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이 추가되었습니다.

애셋

• PromotionAsset에 terms_and_conditions_text, terms_and_conditions_uri, promotion_barcode_info, promotion_qr_code_info 필드를 추가했습니다. 바코드 및 QR 코드 필드는 promotion_trigger oneof 내에 있습니다.

• AssetAutomationTypeEnum에 FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION이 추가되었습니다. 이 설정을 사용하면 검색 캠페인의 최종 URL에서 텍스트 애셋과 방문 페이지가 자동으로 생성되는 것을 제어할 수 있습니다.

• Campaign에서 자동으로 생성된 확장 소재를 삭제하는 새로운 서비스 AutomaticallyCreatedAssetRemovalService.RemoveCampaignAutomaticallyCreatedAsset를 추가했습니다. 이 서비스는 최종 URL 확장 소재의 삭제만 지원합니다.

• ServedAssetFieldType enum에 DESCRIPTION_PREFIX가 추가되었습니다. 이 수정사항은 ad_group_ad_asset_combination_view의 served_asset_field_type가 설명 접두사 역할을 하는 애셋의 경우 UNKNOWN인 문제를 수정합니다.

캠페인

• CampaignPrimaryStatusReason에 새 열거형 값 MISSING_LOCATION_TARGETING을 추가했습니다. 이 새로운 상태 이유는 위치 타겟팅을 지정하지 않은 위치 제한 캠페인에 대해서만 반환됩니다. 위치 제한이 있는 캠페인의 경우 허용된 지역 외부에서 위치 타겟팅을 추가하려고 하면 기준 오류 LOCATION_TARGETING_NOT_ELIGIBLE_FOR_RESTRICTED_CAMPAIGN이 발생합니다.

• VideoCustomer.third_party_integration_partners 및 Campaign.third_party_integration_partners 수준에서 서드 파티 통합 파트너 지원이 추가되었습니다. 고객센터 도움말 서드 파티 앱 애널리틱스를 활용한 앱 전환 추적을 참고하세요.

• 이제 기존 Campaign의 advertising_partner_ids 필드를 설정할 수 있습니다. 이전에는 이 필드를 새 캠페인을 만드는 동안에만 설정할 수 있었습니다.

• 이제 광고주는 관리자 계정 수준에서 정의된 TYPE_PLACEMENT_LIST 유형의 공유 목록을 사용하여 CustomerNegativeCriterion 기준을 통해 개별 광고주 고객 계정에서 게재위치 목록을 제외할 수 있습니다.

• ServedAssetFieldType enum에 DESCRIPTION_PREFIX가 추가되었습니다. 이렇게 하면 ad_group_ad_asset_combination_view의 served_asset_field_type이 설명 접두사로 제공되는 애셋의 경우 UNKNOWN인 문제가 수정됩니다.

• MaximizeConversionValue 및 TargetRoas 입찰 전략에 target_roas_tolerance_percent_millis 필드 지원이 추가되었습니다. TargetRoas.target_roas_tolerance_percent_millis는 포트폴리오 전략에서만 사용할 수 있으며, 포트폴리오 전략은 검색 캠페인에서만 사용할 수 있습니다.

• ProductGroup 오류 코드가 변경되었습니다. 부분 실패가 사용 설정된 요청의 경우 INVALID_LISTING_GROUP_HIERARCHY 대신 LISTING_GROUP_ERROR_IN_ANOTHER_OPERATION가 반환됩니다.

• 광고 그룹 위치 관심분야 기준의 실적을 요약하는 새 리소스 LocationInterestView가 추가되었습니다.

전환수

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

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

디맨드젠 캠페인

• CampaignBudgetError.BUDGET_BELOW_DAILY_MINIMUM 오류 코드가 추가되었습니다. 향후 디맨드젠 캠페인의 예산을 매우 낮은 금액으로 설정하려고 하면 이 오류가 반환됩니다. 필요한 최소 예산에 대한 세부정보는 새 오류 세부정보 필드 budgetDailyMinimumErrorDetails에서 확인할 수 있습니다.

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이 추가되었습니다.

계획

• 광고주가 ReachPlanService.GenerateReachForecast에서 지원하는 사용자 관심분야 (관심도 및 구매 의향)를 파악할 수 있는 새로운 메서드 ReachPlanService.ListPlannableUserInterests가 추가되었습니다. 이 메서드는 특정 사용자 관심분야 유형을 검색하고 이름과 경로를 쿼리하는 것을 지원합니다.

• ReachPlanService.ListPlannableUserLists에 AdditionalApplicationInfo을 선택 입력란으로 추가했습니다.

• 요청을 하는 고객 ID에 사용 가능한 퍼스트 파티 사용자 목록을 가져오기 위해 AudienceInsightsService.ListAudienceInsightsAttributes에 대한 지원이 추가되었습니다.

• 사용자 목록을 타겟팅하는 잠재고객의 통계를 가져오기 위해 AudienceInsightsService.GenerateAudienceCompositionInsights에 퍼스트 파티 사용자 목록 지원이 추가되었습니다. 사용자 목록을 타겟팅하는 요청은 잠재고객 색인만 반환하며 다음 AudienceInsightsDimension에서만 사용할 수 있습니다. AGE_RANGE, GENDER, AFFINITY_USER_INTEREST, IN_MARKET_USER_INTEREST

• AudienceInsightsService.GenerateTargetingSuggestionMetrics의 잠재고객 입력 유형을 InsightsAudience로 업데이트했습니다. 새로운 잠재고객 입력은 사용자 관심분야의 OR 조합을 AND로 결합하여 더 맞춤화된 잠재고객 정의에 대한 잠재 도달범위 측정항목을 지원합니다.

• 추세의 잠재고객 점유율을 가져오기 위해 TrendInsightMetrics에 잠재고객 점유율이 추가되었습니다.

• 사용자가 카테고리별로 지식 그래프 속성을 필터링할 수 있도록 KnowledgeGraphAttributeMetadata에 새로운 관련 카테고리가 추가되었습니다.

보고서

• 이제 AssetGroupAsset, ChannelAggregateAssetView, CampaignAggregateAssetView에 다양한 새 측정항목을 사용할 수 있습니다. 또한 이전에는 실적 최대화 캠페인에서 0으로 설정되었던 ChannelAggregateAssetView 및 CampaignAggregateAssetView의 경우 이제 impressions가 실제 값을 보고합니다.

• 사용자가 한 번의 쿼리로 AssetSet 또는 CampaignAssetSet 유형 리소스에 대해 자세히 알아볼 수 있도록 ChangeStatus을 사용하여 AssetSet 리소스를 선택할 수 있도록 했습니다.

• 사용자가 하나의 쿼리에서 AssetSet 또는 CampaignAssetSet 유형 리소스에 대한 자세한 정보를 가져올 수 있도록 ChangeStatus로 CampaignAssetSet 리소스를 선택할 수 있도록 했습니다.

• 캠페인 검색어 보기에서 선택할 수 있는 새 세그먼트 search_term_targeting_status를 추가했습니다.

• 새 final_url_expansion_asset_view를 추가했습니다.

• AssetGroup 보고서에 측정항목 value_adjustment 및 all_value_adjustment에 대한 지원이 추가되었습니다.

• ad_network_type에 의해 AssetGroupAsset 세그먼트가 세그먼트화되도록 함

• landing_page_view 리소스와 함께 사용할 수 있는 새 세그먼트 landing_page_source가 추가되었습니다.

• 검색어 및 캠페인 검색어 보기에서 선택할 수 있는 새 세그먼트 search_term_match_source가 추가되었습니다.

• 키워드 보기에서 선택할 수 있는 새 세그먼트 match_type가 추가되었습니다.

• 다음과 같은 고유한 질문 의도 클러스터의 측정항목에 대한 지원이 추가되었습니다.

  • clicks_unique_query_clusters
  • conversions_unique_query_clusters
  • impressions_unique_query_clusters

• click_view 세분화에 새 클릭 유형 VEHICLE_ASSETS을 추가하여 차량 애셋에 특화된 광고 형식과 관련된 클릭을 추적하고 보고합니다.

검색의 타겟 ROAS 입찰 전략을 위한 스마트 자동 입찰 탐색

• 이제 MaximizeConversionValue 및 TargetRoas 입찰 전략에서 target_roas_tolerance_percent_millis 필드를 10000(10%)에서 30000(30%) 사이의 값(1000으로 나눌 수 있는 값, 10000과 30000 포함)으로 설정하여 검색 캠페인에서 스마트 자동 입찰 탐색을 사용 설정할 수 있습니다. MaximizeConversionValue 입찰 전략에도 target_roas 필드가 설정되어 있어야 합니다. TargetRoas.target_roas_tolerance_percent_millis은 포트폴리오 전략에만 사용할 수 있습니다. 스마트 자동 입찰 탐색에 관한 블로그 게시물과 고객센터 도움말을 참고하세요.

• 이제 순 검색어 의도 클러스터의 다음 측정항목에 집계된 다양성 보고가 지원됩니다. Google Ads UI에서 시간 세그먼트 보기를 사용할 수 있습니다.

  • clicks_unique_query_clusters
  • conversions_unique_query_clusters
  • impressions_unique_query_clusters

동영상

• YouTubeVideoListAsset이 추가되었습니다. campaign과 YouTubeVideoListAsset 유형 간의 링크를 만드는 데 사용할 수 있는 Asset#youtube_video_list_asset도 추가했습니다. 고객센터 도움말 관련 동영상 사용을 참고하세요.

• YouTubeChannelInsights 및 YouTubeVideoAttributeMetadata에 새 메타데이터 필드가 추가되었습니다.

• 새 클릭 유형이 노출되었습니다(VIDEO_RELATED_VIDEOS_CLICK, VIDEO_CHANNEL_CLICK, PRODUCT_ASSETS).

• 동영상 반응형 광고가 건너뛸 수 없는 인스트림 광고로 게재될 수 있도록 VideoAdInventoryControl에 allow_non_skippable_in_stream 필드가 추가되었습니다. 이 옵션은 건너뛸 수 없는 광고 형식을 다른 형식과 혼합하는 것을 지원하는 캠페인에 사용할 수 있습니다.

• Campaign.VideoCampaignSettings.video_ad_sequence 및 AdGroup.VideoAdGroupSettings.VideoAdSequenceStepSetting 필드 (읽기 전용)가 추가되었습니다. 고객센터 도움말 동영상 광고 순서 지정 정보를 참고하세요.

• YouTubeChannelInsights 및 YouTubeVideoAttributeMetadata에 새 메타데이터 필드가 추가되었습니다.

• CampaignCriterion 및 AdGroupCriterion에 VIDEO_LINEUP 기준 유형과 video_lineup 필드가 추가되었습니다. 이 기능은 허용 목록에 추가된 계정에서만 사용할 수 있습니다. 자세한 내용은 Google 비즈니스 개발 담당자에게 문의하세요.

• 세부정보 및 그룹 수준 모두에 콘텐츠 적합성 보고서가 추가되었습니다. 고객센터 도움말 '콘텐츠 적합성' 보고서에 대한 정보를 참고하세요.

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 보고서에 몇 가지 새로운 측정항목과 세그먼트 열이 추가되었습니다.

측정항목 열

• new_customer_lifetime_value
• all_new_customer_lifetime_value
• 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

세그먼트 열

• ad_network_type
• conversion_action
• conversion_action_name
• conversion_action_category
• external_conversion_source
• conversion_attribution_event_type
• conversion_adjustment
• conversion_lag_bucket
• conversion_or_adjustment_lag_bucket
• new_versus_returning_customers
• device
• slot

캠페인

• 실적 최대화 캠페인에 캠페인 수준 제외 키워드를 추가하고 업데이트하는 기능이 추가되었습니다.

전환수

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

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

디맨드젠 캠페인

• 채널별로 디맨드젠 캠페인을 분류할 수 있는 새 값이 ad_network_type 세그먼트에 추가되었습니다.
  • MAPS
  • GMAIL
  • DISCOVER
• 유사 플랫폼 전환수 측정항목이 추가되었습니다.
  • platform_comparable_conversions_from_interactions_rate
  • platform_comparable_conversions
  • platform_comparable_conversions_value
  • platform_comparable_conversions_value_per_cost
  • platform_comparable_conversions_by_conversion_date
  • platform_comparable_conversions_value_by_conversion_date
  • platform_comparable_conversions_from_interactions_value_per_interaction
  • cost_per_platform_comparable_conversion
  • value_per_platform_comparable_conversion
  • value_per_platform_comparable_conversions_by_conversion_date
  • cost_converted_currency_per_platform_comparable_conversion

권장사항

• 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에는 다음과 같은 기능과 변경사항이 추가되었습니다.

애셋

• 애셋 그룹의 격차에 관한 정보를 반환하는 AssetGroup의 asset_coverage 필드가 추가되었습니다.
  • 광고주가 애셋 그룹의 광고 효력을 개선하기 위해 취할 수 있는 작업 목록을 반환하는 하위 필드 ad_strength_action_items이 포함되어 있습니다.

캠페인

• 이제 지역 서비스 캠페인에서 리드에 대한 평가를 하거나 의견을 제공할 수 있습니다. 이 변경사항에 따라 v19.1
  • LocalServicesLeadService이라는 새 서비스가 추가되었습니다. ProvideLeadFeedback 메서드를 사용하여 리드의 평가 및 의견을 업로드할 수 있습니다.
  • LocalServicesLead에 lead_feedback_submitted이라는 새 필드를 추가하여 리드에 의견이 제출되었는지 확인할 수 있도록 했습니다.
• 앱 캠페인에 대한 새 측정항목 열 biddable_cohort_app_post_install_conversions이 추가되었습니다.

디맨드젠 캠페인

• 디맨드젠을 지원하기 위해 계획 서비스에 추가 메서드가 도입되었습니다.

• 광고 그룹 수준 디맨드젠 캠페인 채널 관리 지원이 추가되었습니다. demand_gen_ad_group_settings 필드를 사용하여 사전 정의된 일반 채널 그룹 또는 채널 하위 집합을 선택할 수 있습니다. 현재 버전에서 지원되는 채널은 다음과 같습니다.

  • YouTube 인스트림 광고
  • YouTube 인피드 광고
  • YouTube Shorts
  • 디스커버
  • Gmail
  • 디스플레이

• TALL_PORTRAIT_MARKETING_IMAGE의 새 애셋 유형을 노출했습니다. 이 애셋 유형은 디맨드젠 다중 애셋 광고 형식의 tall_portrait_marketing_images 필드와 관련이 있습니다.

변경 내역

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

권장사항

• 새로운 ad_strength 필드는 ImprovePerformanceMaxAdStrengthRecommendation에서 사용할 수 있으며, 이 필드는 추천과 연결된 애셋 그룹의 현재 광고 효력 점수를 반환합니다.

  쇼핑

• 이제 실적 최대화 캠페인에서 쇼핑 광고의 브랜드 제외를 재정의할 수 있습니다. 이 기능은 캠페인 수준의 새로운 pmax_campaign_settings 필드를 통해 노출되며 소매용 실적 최대화 캠페인에만 적용됩니다. 호환되지 않는 캠페인 유형에 대해 이 필드를 설정하려고 하면 새로운 CampaignError.BRAND_TARGETING_OVERRIDES_NOT_SUPPORTED 오류가 발생합니다.

동영상

• 오디오 광고에 대한 읽기 전용 지원이 추가되었습니다. 이 기능에 대해 알아보려면 Google Ads 고객센터를 참고하세요. 이 변경사항은 다음을 노출합니다.
  • YOUTUBE_AUDIO라는 새 AdvertisingChannelSubType
  • YOUTUBE_AUDIO라는 새 AdGroupType
  • YOUTUBE_AUDIO_AD이라는 새 광고 형식 열거형과 해당 YouTubeAudioAdInfo 필드
• 인구통계 조정이 적용된 도달범위 측정항목 쿼리에 새로운 측정항목과 세그먼트가 추가되었습니다. 이러한 변경사항의 일환으로
  • 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

광고

• 디맨드젠 캠페인 광고에서 가로세로 비율이 9:16인 세로 모드 이미지 애셋을 지원하기 위해 DemandGenMultiAssetAdInfo.tall_portrait_marketing_images이 추가되었습니다.

애셋

• (허용 목록에 추가된 계정만 해당) Asset.business_message_asset, BusinessMessageAsset, 다음 열거형 및 오류를 통해 메시지 확장 소재 지원이 추가되었습니다.
  • 열거형:
    • AssetFieldType.BUSINESS_MESSAGE
    • AssetType.BUSINESS_MESSAGE
    • BusinessMessageCallToActionType
    • BusinessMessageProvider
  • 오류:
    • AssetError.CUSTOMER_NOT_ON_ALLOWLIST_FOR_WHATSAPP_MESSAGE_ASSETS
    • ResourceLimitType
      • BUSINESS_MESSAGE_ASSET_LINKS_PER_CUSTOMER
      • WHATSAPP_BUSINESS_MESSAGE_ASSET_LINKS_PER_CAMPAIGN
      • WHATSAPP_BUSINESS_MESSAGE_ASSET_LINKS_PER_AD_GROUP
• 방문 페이지 미리보기를 자동으로 생성할 수 있도록 AssetAutomationType.GENERATE_LANDING_PAGE_PREVIEW를 추가했습니다.
• 이제 디맨드젠 동영상 반응형 광고에 대해 AssetAutomationType.GENERATE_SHORTER_YOUTUBE_VIDEOS이 기본적으로 선택됩니다.
• (허용 목록에 추가된 계정만 해당, 현재 허용 목록이 닫혀 있음) Asset.app_deep_link_asset 및 AppDeepLinkAsset이 추가되었습니다.

전환수

• 전환 목표
  • LifecycleGoalValueSettings.high_lifetime_value가 베타에서 출시되었으며 이제 변경 가능합니다.
  • 고객 수명 주기 목표를 소유한 고객의 리소스 이름을 표시하기 위해 CustomerLifecycleGoal.owner_customer이 추가되었습니다.
• ConversionActionType.SALESFORCE가 지원 중단되었습니다.

피드

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

호텔 및 여행

• 값을 0으로 지정할 수 있도록 ValueRuleItineraryAdvanceBookingWindow의 min_days 및 max_days을 optional 필드로 만들었습니다. 이를 통해 오늘 이루어진 여행 검색을 타겟팅할 수 있습니다.

실적 최대화 캠페인

• (허용 목록에 추가된 계정만 해당) 브랜드 가이드라인
  • 실적 최대화 캠페인을 만들 때만 Campaign.brand_guidelines_enabled을 변경할 수 있도록 했습니다.
  • 여행 목표 달성을 위한 실적 최대화 캠페인과 호환되지 않습니다.
  • 기존 실적 최대화 캠페인에 브랜드 가이드라인을 사용 설정하려면 새로 추가된 CampaignService.EnablePMaxBrandGuidelines를 사용하세요. 브랜드 가이드라인을 사용 중지하는 것은 지원되지 않습니다.
  • 브랜드의 색상과 글꼴 모음을 설정할 수 있도록 Campaign.brand_guidelines 및 BrandGuidelines가 추가되었습니다.
  • 새 오류 값:
    • BatchJobError.CAMPAIGN_AND_CAMPAIGN_ASSET_TRANSACTION_FAILURE
    • BrandGuidelinesMigrationError
    • BRAND_GUIDELINES_ALREADY_ENABLED
    • CANNOT_ENABLE_BRAND_GUIDELINES_FOR_REMOVED_CAMPAIGN
    • BRAND_GUIDELINES_LOGO_LIMIT_EXCEEDED
    • CANNOT_AUTO_POPULATE_BRAND_ASSETS_WHEN_BRAND_ASSETS_PROVIDED
    • AUTO_POPULATE_BRAND_ASSETS_REQUIRED_WHEN_BRAND_ASSETS_OMITTED
    • TOO_MANY_ENABLE_OPERATIONS
  • CampaignError
  • BRAND_GUIDELINES_NOT_ENABLED_FOR_CAMPAIGN
  • BRAND_GUIDELINES_MAIN_AND_ACCENT_COLORS_REQUIRED
  • BRAND_GUIDELINES_COLOR_INVALID_FORMAT
  • BRAND_GUIDELINES_UNSUPPORTED_FONT_FAMILY
  • BRAND_GUIDELINES_UNSUPPORTED_CHANNEL
  • CANNOT_ENABLE_BRAND_GUIDELINES_FOR_TRAVEL_GOALS
  • CUSTOMER_NOT_ALLOWLISTED_FOR_BRAND_GUIDELINES
• 실적 최대화 캠페인에서 향상된 동영상 애셋을 자동으로 생성할 수 있도록 AssetAutomationType.GENERATE_ENHANCED_YOUTUBE_VIDEOS이 추가되었습니다.

계획

• (허용 목록에 추가된 계정만 해당) 지정된 잠재고객 정의에 대해 YouTube에서 인기 급상승 콘텐츠 주제를 사용자가 볼 수 있도록 하는 ContentCreatorInsightsService.GenerateTrendingInsights이 추가되었습니다.
• 지정된 기준을 검색할 국가를 지정하는 GenerateCreatorInsightsRequest.country_locations[]를 추가했습니다.
• 크리에이터를 검색할 브랜드를 지정하기 위해 GenerateCreatorInsightsRequest.search_brand를 추가했습니다.
• search_channels 요청에 추가 채널 정보를 제공하기 위해 YouTubeChannelInsights에 새 필드가 추가되었습니다.
  • channel_url
  • channel_description
  • top_videos
• AudienceInsightsAttributeMetadata에 새 메타데이터 필드가 추가되었습니다.
  • youtube_video_metadata
  • user_interest_attribute_metadata
  • knowledge_graph_attribute_metadata

동영상

• DataLinkService.CreateDataLink 출시 후 이전에 생성된 데이터 링크를 변경할 수 있도록 다음 메서드가 추가되었습니다.
  • Google Ads 계정에서 데이터 링크를 삭제하는 RemoveDataLink
  • Google Ads 계정에서 데이터 링크를 수락, 거부, 취소하는 UpdateDataLink
• 다음 열거형에서 VIDEO_OUTSTREAM 지원이 삭제되었습니다.
  • AdType
  • AdvertisingChannelSubType
  • AdGroupType

v18 (2024-10-16)

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

계정 관리

• (허용 목록에 추가된 계정만 해당) Google Ads 계정을 크리에이터의 YouTube 채널에 호스팅된 크리에이터 동영상에 연결할 수 있는 DataLinkService.CreateDataLink이 추가되었습니다. 동영상 연결을 사용하면 Google Ads 계정에서 크리에이터 동영상을 사용하여 파트너십 광고를 게재할 수 있습니다.

광고그룹

• AdGroup.exclude_demographic_expansion이 추가되어 optimized_targeting_enabled이 true인 경우 인구통계가 확장되지 않도록 할 수 있습니다. 이 기능은 이전에는 디맨드젠 캠페인에서만 지원되었습니다.

광고

• 광고에서 자동 애셋 생성을 선택하거나 선택 해제할 수 있는 AdGroupAd.ad_group_ad_asset_automation_settings가 추가되었습니다.
• AssetAutomationType에 다음 값이 추가되었습니다.
  • GENERATE_VERTICAL_YOUTUBE_VIDEOS
  • GENERATE_SHORTER_YOUTUBE_VIDEOS
• YouTube, Gmail, 디스커버 피드와 같은 Google 소유 채널에 게재되는 광고에서 사용되는 AdNetworkType.GOOGLE_OWNED_CHANNELS가 추가되었습니다.

애셋

• AssetType.DISCOVERY_CAROUSEL_CARD의 이름이 AssetType.DEMAND_GEN_CAROUSEL_CARD로 변경되었습니다.

캠페인

• 캠페인의 마지막 클릭 모델에 의해 기여도가 부여된 매장 방문수를 반환하는 metrics.store_visits_last_click_model_attributed_conversions이 추가되었습니다.
• 캠페인에 다음과 같은 동영상 조회수 관련 측정항목이 추가되었습니다.
  • metrics.video_view_rate_in_feed
  • metrics.video_view_rate_in_stream
  • metrics.video_view_rate_shorts
• 캠페인의 통합 목표 결과를 위한 전환 구매를 반환하는 metrics.results_conversions_purchase이 추가되었습니다.
• DemandGenCampaignSettings.upgraded_targeting의 기본값이 false에서 true로 변경되었습니다.

기준

• 디스플레이, 디맨드젠, 동영상 캠페인의 타겟 콘텐츠(예: 키워드, 게재위치, 주제)의 실적 측정항목을 반환하는 content_criterion_view가 추가되었습니다.

호텔 및 여행

• 검색 광고의 여행 피드 지원
  • 검색 광고의 여행 피드의 측정항목을 분류할 수 있도록 ClickType.TRAVEL_ASSETS가 추가되었습니다.
  • 검색 광고의 여행 피드 사용을 선택하거나 선택 해제하는 데 사용할 수 있는 AssetSetType.TRAVEL_FEED가 추가되었습니다.
• (허용 목록에 추가된 계정만 해당) 다음 새 필드와 값을 사용하여 여행 일정을 새 전환 가치 규칙으로 추가했습니다.
  • ValueRuleItineraryCondition을 사용하는 ConversionValueRule.itinerary_condition: 사전 예약 기간, 여행 일정, 여행 시작 요일을 지정할 수 있습니다.
  • ConversionValueRulePrimaryDimensionEnum.ITINERARY
  • ValueRuleSetDimension.ITINERARY
• 호텔 및 검색 캠페인의 특정 목적지 (도시, 국가, 지역)를 기준으로 실적 데이터를 분류할 수 있도록 campaign 및 ad_group 보고서에 다음 세그먼트가 추가되었습니다.
  • segments.travel_destination_city
  • segments.travel_destination_country
  • segments.travel_destination_region

지역 서비스

• PhoneCallDetails.call_recording_url이 비어 있습니다. 지정된 Local Services 리드 대화에 통화 녹음 파일이 없는 경우 잘못된 URL을 제공하는 대신 비어 있습니다.
• Campaign.local_services_campaign_settings을 통해 카테고리의 타겟 CPA를 설정할 수 있는 CategoryBid.target_cpa_bid_micro을 추가했습니다.

실적 최대화 캠페인

• 브랜드 가이드라인 지원
  • 특정 실적 최대화 캠페인에 브랜드 가이드라인이 사용 설정되어 있는지 여부를 나타내는 Campaign.brand_guidelines_enabled이 추가되었습니다. 사용 설정된 경우 field_type이 BUSINESS_NAME, LOGO, LANDSCAPE_LOGO로 설정된 애셋은 AssetGroupAsset 리소스 대신 CampaignAsset 리소스로 연결해야 합니다.
  • 브랜드 가이드라인이 사용 설정된 실적 최대화 캠페인에 캠페인에 연결된 필수 CampaignAsset 리소스가 없음을 나타내는 CampaignError.REQUIRED_BUSINESS_NAME_ASSET_NOT_LINKED 및 CampaignError.REQUIRED_LOGO_ASSET_NOT_LINKED 오류가 추가되었습니다.
  • 브랜드 가이드라인이 사용 설정된 경우 field_type이 BUSINESS_NAME로 설정된 애셋 하나 이상과 LOGO이 캠페인에 CampaignAsset 리소스로 연결되어 있어야 합니다. 제품 피드를 사용하는 온라인 판매용 실적 최대화 캠페인은 캠페인의 애셋 그룹에 연결된 애셋이 있는 경우에만 이 요구사항을 충족해야 합니다.
  • AssetLinkError에 다음 값을 추가했습니다.
  • BRAND_ASSETS_NOT_LINKED_AT_ASSET_GROUP_LEVEL: 브랜드 가이드라인이 사용 설정되지 않은 실적 최대화 캠페인에서 브랜드 애셋을 AssetGroupAsset 리소스 대신 CampaignAsset 리소스로 캠페인에 연결하려고 할 때 발생합니다.
  • 브랜드 가이드라인이 사용 설정된 실적 최대화 캠페인에서 브랜드 애셋을 CampaignAsset 리소스 대신 AssetGroupAsset 리소스로 캠페인에 연결하려고 할 때 발생하는 BRAND_ASSETS_NOT_LINKED_AT_CAMPAIGN_LEVEL 오류입니다.
• 실적 최대화 캠페인 광고가 게재된 게재위치의 노출수를 반환하는 performance_max_placement_view가 추가되었습니다.
• AssetGroupListingGroupFilterError.TREE_WAS_INVALID_BEFORE_MUTATION 추가됨

계획

• (허용 목록에 추가된 계정만 해당) 사용자가 인기 YouTube 크리에이터에 관한 유용한 정보를 살펴볼 수 있는 ContentCreatorInsightsService.GenerateCreatorInsights 메서드를 사용하여 새 서비스를 추가했습니다. 이를 통해 고객은 잠재고객 타겟팅 및 콘텐츠 타겟팅 조합을 기반으로 크리에이터를 검색하거나 YouTube 채널 ID 목록을 기반으로 크리에이터 통계를 검색할 수 있습니다.
• AudienceInsightsService.GenerateSuggestedTargetingInsights 업데이트:
  • audience, baseline_audience, data_month를 audience_definition로 이동했습니다.
  • 생성형 AI를 사용하여 자유 형식 텍스트 설명에서 타겟팅 추천을 생성하는 audience_description이 추가되었습니다.
• 지정된 잠재고객 타겟팅 조합의 잠재 도달범위 측정항목을 반환하는 AudienceInsightsService.GenerateTargetingSuggestionMetrics이 추가되었습니다.

권장사항

• 이제 RecommendationService.GenerateRecommendations을 사용하여 캠페인 구성 중에 최적화된 예산 제안에 관한 추천을 생성할 수 있습니다. GenerateRecommendationsRequest.recommendation_types[]에 CAMPAIGN_BUDGET 추천 유형을 포함하면 됩니다. 이 기능은 실적 최대화 캠페인 및 검색 캠페인에 적용됩니다.

보고

• SearchGoogleAdsRequest의 summary_row_setting 및 return_total_results_count 필드를 search_settings 필드로 대체했습니다. 이 필드의 유형은 SearchSettings이며 다음 필드가 있습니다.
  • omit_results
  • return_summary_row
  • return_total_results_count
• 봇이나 크롤러에 의해 생성된 클릭, 비정상적인 패턴이 있는 클릭 등 일반 무효 클릭에 관한 다음 새 측정항목이 추가되었습니다. campaign 보고서로 쿼리할 수 있습니다.
  • metrics.general_invalid_clicks
  • metrics.general_invalid_click_rate
• QuotaError에 다음 값을 추가했습니다.
  • EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION

보관처리된 출시 노트

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