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
유형 리소스에 대한 자세한 정보를 가져올 수 있도록CampaignAssetSet
리소스를ChangeStatus
로 선택할 수 있도록 했습니다.캠페인 검색어 보기에서 선택할 수 있는 새 세그먼트
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
가 추가되었습니다.다음과 같은 고유한 질문 의도 클러스터의 측정항목에 대한 지원이 추가되었습니다.
click_view
세분화에 새 클릭 유형VEHICLE_ASSETS
을 추가하여 차량 애셋에 특화된 광고 형식과 관련된 클릭을 추적하고 보고합니다.
검색의 타겟 ROAS 입찰 전략을 위한 스마트 자동 입찰 탐색
이제
MaximizeConversionValue
및TargetRoas
입찰 전략에서target_roas_tolerance_percent_millis
필드를 10000 (10%)에서 30000 (30%) 사이의 1000으로 나눌 수 있는 값으로 설정하여 검색 캠페인에서 스마트 자동 입찰 탐색을 사용 설정할 수 있습니다.MaximizeConversionValue
입찰 전략에도target_roas
필드가 설정되어 있어야 합니다.TargetRoas.target_roas_tolerance_percent_millis
은 포트폴리오 전략에만 사용할 수 있습니다. 스마트 자동 입찰 탐색에 관한 블로그 게시물과 고객센터 도움말을 참고하세요.이제 순 검색어 의도 클러스터의 다음 측정항목에 집계된 다양성 보고가 지원됩니다. Google Ads UI에서 시간 세그먼트 보기를 사용할 수 있습니다.
동영상
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
에 새로운 RPCProvideLeadFeedback
를 추가했습니다.- 특정 리소스에 대한 의견이 제공되었는지 확인하는 새 필드
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
, 다음 열거형 및 오류를 통해 메시지 확장 소재 지원이 추가되었습니다.- 열거형:
- 방문 페이지 미리보기를 자동으로 생성할 수 있도록
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
- Google Ads 계정에서 데이터 링크를 삭제하는
- 다음 열거형에서
VIDEO_OUTSTREAM
지원이 삭제되었습니다.
보관처리된 출시 노트
보관된 출시 노트는 지원 종료된 버전을 참고하세요.