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
, 다음 enum 및 오류를 통해 메시지 확장 소재에 대한 지원이 추가되었습니다.- enum:
- 방문 페이지 미리보기 자동 생성을 지원하도록
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
등 모든 피드 관련 항목이 삭제되었습니다. 이제 사용자는 동일한 목적을 달성하기 위해 애셋을 사용해야 합니다. 삭제된 모든 항목의 목록은 이전 노트를 참고하세요.
호텔 및 여행
- 0을 값으로 지정할 수 있도록
optional
필드의ValueRuleItineraryAdvanceBookingWindow
min_days
및max_days
를 만들었습니다. 이를 통해 오늘 발생하는 여행 검색을 타겟팅할 수 있습니다.
실적 최대화 캠페인
- (허용 목록에 있는 계정만 해당) 브랜드 가이드라인
- 실적 최대화 캠페인을 만들 때만
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
출시 후 이전에 생성된 데이터 링크를 변경할 수 있도록 다음 메서드를 추가했습니다.RemoveDataLink
: Google Ads 계정에서 데이터 링크 삭제- Google Ads 계정에서 데이터 연결을 수락, 거부, 취소하는
UpdateDataLink
- 다음 enum에서
VIDEO_OUTSTREAM
지원을 삭제했습니다.
v18 (2024-10-16)
v18에는 다음과 같은 새로운 기능과 업데이트가 추가되었습니다.
계정 관리
- (허용 목록에 있는 계정만 해당) Google Ads 계정을 크리에이터의 YouTube 채널에 호스팅된 크리에이터 동영상에 연결할 수 있는
DataLinkService.CreateDataLink
를 추가했습니다. 동영상을 연결하면 Google Ads 계정에서 크리에이터 동영상을 사용하여 파트너십 광고를 게재할 수 있습니다.
광고그룹
- 이전에는 디맨드젠 캠페인에만 지원되었던 기능으로,
optimized_targeting_enabled
이true
인 경우 인구통계를 제외할 수 있는AdGroup.exclude_demographic_expansion
를 추가했습니다.
광고
- 광고의 자동 확장 소재 생성 여부를 선택할 수 있는
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.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
보고서에 다음 세그먼트를 추가했습니다.
지역 서비스
- 지정된 로컬 서비스 리드 대화에 통화 녹음 파일이 없는 경우 잘못된 URL을 제공하는 대신
PhoneCallDetails.call_recording_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
필드를 유형이SearchSettings
인search_settings
필드로 바꾸고 다음 필드를 추가했습니다.omit_results
return_summary_row
return_total_results_count
- 봇이나 크롤러에서 생성한 무효 클릭, 비정상적인 패턴이 있는 무효 클릭 등 일반 무효 클릭에 관한 다음과 같은 새로운 측정항목이 추가되었습니다.
campaign
보고서로 쿼리할 수 있습니다. QuotaError
에 다음 값을 추가했습니다.EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION
EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION
v17.1.0 (2024년 8월 7일)
v17_1에는 다음과 같은 새로운 기능과 업데이트가 추가되었습니다.
애셋
AdGroupAdService.RemoveAutomaticallyCreatedAssets()
를 사용하면 반응형 검색 광고에 연결된 지정된 자동으로 생성된 확장 소재를 삭제할 수 있습니다.
잠재고객
UserListCustomerTypeCategory
의 새 enum 값:LOYALTY_TIER_1_MEMBERS
LOYALTY_TIER_2_MEMBERS
LOYALTY_TIER_3_MEMBERS
LOYALTY_TIER_4_MEMBERS
LOYALTY_TIER_5_MEMBERS
LOYALTY_TIER_6_MEMBERS
LOYALTY_TIER_7_MEMBERS
캠페인
ShareablePreviewService.GenerateShareablePreviews()
는 사용 설정 및 일시중지된 애셋 그룹의 공유 가능한 광고 미리보기 URL (응답의shareable_preview_url
)을 생성합니다.expiration_date_time
필드는 응답의 URL 만료일을 나타냅니다.- 오류가 발생하면 메서드는 URL 대신
partial_failure_error
를 반환합니다.
변경 내역
- 새로운 변경 상태 리소스 유형:
ASSET_GROUP
.
전환수
- SKAdNetwork 버전의 새 세그먼트 필드:
segments.sk_ad_network_version
offline_conversion_upload_conversion_action_summary
: 전환 액션 수준에서 전환 업로드 진단을 노출합니다.- 아직 처리 중인 업로드된 전환 수를 전달하기 위해 다음 측정항목이 오프라인 진단 보고서에 추가되었습니다.
계획
AudienceInsights.GenerateAudienceOverlapInsights()
: 입력 기본 속성과 잠재고객 속성 모음을 허용하고 기본 속성과 잠재고객 속성 간의 잠재적 YouTube 도달범위 중복에 대한 추정치를 반환합니다.
보고
segments.date
를 기반으로per_store_view
세분화 지원
동영상
ad_group
,campaign
와 같은 보고서를 사용하여 동영상 캠페인의 다음 표준 입찰 전략과 관련된 정보를 검색할 수 있습니다.Campaign.fixed_cpm
(고정 CPM (1,000회 노출당비용))Campaign.target_cpv
(타겟 CPV (조회당비용))
Campaign.video_campaign_settings
: 다음 보고서 필드를 사용하여 동영상 광고가 게재될 수 있는 인벤토리를 확인할 수 있습니다.segments.ad_format_type
: 동영상 광고 형식 유형을 기준으로 다음 보고서를 분류할 수 있습니다.
v17 (2024-06-05)
v17에는 다음과 같은 기능과 변경사항이 추가되었습니다.
광고
AdService.getAd
을 삭제했습니다. 이렇게 하면AdService
가 Google Ads API의 다른 서비스와 일치하게 됩니다. 광고 및 기타 리소스 유형을 가져오는 권장 방법은 객체 검색을 참고하세요.- 크기 및 형식과 관련하여
ImageAdInfo.image_asset
에 대한 유효성 검사를 추가했습니다. 이미지가 유효하지 않으면 다음 오류가 발생할 수 있습니다.
애셋
- 새 enum
ClickType.AD_IMAGE
을 추가했습니다. - 실적 최대화 캠페인 및 검색 캠페인의 새로운 측정항목이 포함된 다음과 같은 새로운 보고서가 추가되었습니다.
잠재고객
일괄 작업
- 제출된
AddBatchJobOperationsRequest
가 10484504바이트보다 클 때 발생하는BatchJobError.REQUEST_TOO_LARGE
를 추가했습니다. BatchJobService
를 사용할 때MutateOperation.asset_group_operation
설정을 지원합니다. 이렇게 하면 일괄 처리를 사용하여 전체 실적 최대화 캠페인을 만들고 관리할 수 있습니다. 새로운 전용 가이드를 참고하세요.
캠페인
- 캠페인, 광고, 확장 소재와 같은 Google Ads API 전반의 모든 리소스의 모든 필드, enum, 오류에서 디스커버리라는 이름을 디맨드젠으로 변경했습니다. 예를 들어
AdvertisingChannelType.DISCOVERY
은 이제AdvertisingChannelType.DEMAND_GEN
입니다. - 캠페인의 모든 키워드에 키워드 검색 유형을 설정할 수 있는
Campaign.keyword_match_type
를 추가했습니다.
전환수
- SKAdNetwork 전환의 경우 다음을 실행합니다.
segments.sk_ad_network_conversion_value
의 이름이segments.sk_ad_network_fine_conversion_value
로 변경되었습니다.segments.sk_ad_network_redistributed_fine_conversion_value
를 추가했습니다.
- 이제 다음 측정항목은 0이더라도 응답과 함께 반환됩니다. 이렇게 하면 다른 측정항목과 일치합니다.
기준
- 광고그룹 기준이 게재 중인지 또는 게재되지 않는 이유를 표시하기 위해
AdGroupCriterion
의 다음 필드에 추가되었습니다.primary_status
primary_status_reasons
gender_view
에metrics.search_impression_share
지원을 추가했습니다.keyword_view
에metrics.phone_calls
지원을 추가했습니다.
지역 서비스
LocalServicesLead
에 새LocalServicesLeadConversation
를 추가하는 데 사용되는LocalServicesLeadService.AppendLeadConversation()
를 추가했습니다. 이LocalServicesLeadService.AppendLeadConversation()
는 리드가 생성된 방식에 따라 SMS와 같은 적절한 채널을 통해 사용자에게 메시지를 전송합니다.AppendLeadConversationRequest.conversations
의 크기는 1,000으로 제한됩니다.lead_type
이LeadType.MESSAGE
로 설정된LocalServicesLead
만Conversation.local_services_lead
에 지정할 수 있습니다.
ConversationType
에 새 열거형 값을 추가했습니다.- WhatsApp을 통해 소개된 대화를 나타내는
WHATSAPP
ADS_API
: 새LocalServicesLeadService.AppendLeadConversation()
메서드를 사용하여 도입된 대화를 나타냅니다.
- WhatsApp을 통해 소개된 대화를 나타내는
local_services_verification_artifact
에 다음과 같은 새 필드를 추가했습니다.local_services_verification_artifact.insurance_verification_artifact.expiration_date_time
local_services_verification_artifact.license_verification_artifact.expiration_date_time
보고
- 이제
product_link
를 쿼리할 때 연결된 제품 하나와 관련된 필드만 선택할 수 있습니다. 연결된 여러 제품의 여러 필드를 선택하면QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE
이 발생합니다. 예를 들어product_link.advertising_partner.customer
와product_link.data_partner.data_partner_id
는 동일한 쿼리에서 선택할 수 없습니다. page_size
를GoogleAdsService.Search
에 전달하면RequestError.PAGE_SIZE_NOT_SUPPORTED
오류가 발생합니다.
쇼핑
- Google Ads UI의 제품 페이지에 해당하는 새 보고서
shopping_product
를 추가했습니다. Google Ads 계정에 연결된 Google 판매자 센터 계정의 제품의 현재 상태와 관련된 데이터를 반환하는 것을 지원합니다.GoogleAdsService.Search
또는GoogleAdsService.SearchStream
를 사용할 때segments.date
를 사용하여shopping_product
보고서에서 측정항목을 필터링할 수 있습니다. 날짜별 세분화는 허용되지 않으며ShoppingProductError.UNSUPPORTED_DATE_SEGMENTATION
오류가 반환됩니다.
통합 목표
- 잠재고객 고객 유형을 구성하는
UserListCustomerTypeService.MutateUserListCustomerTypes()
를 추가했습니다. CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings
을 삭제했습니다. 고객 수명 주기 목표의 잠재고객 설정을 구성하려면UserListCustomerTypeService.MutateUserListCustomerTypes()
을 대신 사용하세요.UserListCustomerType.customer_type_category
을UserListCustomerTypeCategory.PURCHASERS
로 설정하여 사용자 목록을 고객 수명 주기 목표의 기존 고객 정의에 각각 포함하거나 제외하여 사용자 목록을 연결하거나 연결 해제합니다. 자세한 내용은 잠재고객 세분화를 참고하세요.
동영상
ContentLabelType
에 다음 값을 추가했습니다. 고객 수준에서 다음ContentLabelTypes
를 제외할 수 있습니다.BRAND_SUITABILITY_CONTENT_FOR_FAMILIES
BRAND_SUITABILITY_GAMES_FIGHTING
BRAND_SUITABILITY_GAMES_MATURE
BRAND_SUITABILITY_HEALTH_SENSITIVE
BRAND_SUITABILITY_HEALTH_SOURCE_UNDETERMINED
BRAND_SUITABILITY_NEWS_RECENT
BRAND_SUITABILITY_NEWS_SENSITIVE
BRAND_SUITABILITY_NEWS_SOURCE_NOT_FEATURED
BRAND_SUITABILITY_POLITICS
BRAND_SUITABILITY_RELIGION
DemandGenVideoResponsiveAdInfo
를 만들 때 동영상 애셋의 인벤토리 환경설정을 지원하도록AdVideoAsset.ad_video_asset_info
를 추가했습니다.- (허용 목록에 있는 계정만 해당)
Campaign.video_brand_safety_suitability
를 변경 가능하도록 만들었습니다.
보관처리된 출시 노트
보관처리된 출시 노트는 지원 중단된 버전을 참고하세요.