출시 노트

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, 다음 enum 및 오류를 통해 메시지 확장 소재에 관한 지원이 추가되었습니다.
  • enum:
    • 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을 값으로 지정할 수 있도록 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 지원이 삭제되었습니다.
  • AdType
  • AdvertisingChannelSubType
  • AdGroupType

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.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를 추가했습니다.
• (허용 목록에 있는 계정만 해당) 다음과 같은 새 필드와 값이 포함된 여행 일정을 새 전환 가치 규칙으로 추가했습니다.
  • 사전 예약 기간, 숙박 일정 길이, 여행 시작 요일을 지정할 수 있는 ConversionValueRule.itinerary_condition 및 ValueRuleItineraryCondition
  • ConversionValueRulePrimaryDimensionEnum.ITINERARY
  • ValueRuleSetDimension.ITINERARY
• 호텔 및 검색 캠페인의 특정 목적지 (도시, 국가, 지역)를 기준으로 실적 데이터를 분류할 수 있도록 campaign 및 ad_group 보고서에 다음 세그먼트를 추가했습니다.
  • segments.travel_destination_city
  • segments.travel_destination_country
  • segments.travel_destination_region

지역 서비스

• 지정된 로컬 서비스 리드 대화에 통화 녹음 파일이 없는 경우 PhoneCallDetails.call_recording_url은 잘못된 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 보고서로 쿼리할 수 있습니다.
  • metrics.general_invalid_clicks
  • metrics.general_invalid_click_rate
• QuotaError에 다음 값을 추가했습니다.
  • 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()는 사용 설정 및 일시중지된 애셋 그룹의 공유 가능한 광고 미리보기에 대한 응답에서 URLshareable_preview_url을 생성합니다.
  • expiration_date_time 필드는 응답의 URL 만료일을 나타냅니다.
  • 오류가 발생하면 메서드는 URL 대신 partial_failure_error를 반환합니다.

변경 내역

• 새로운 변경 상태 리소스 유형: ASSET_GROUP.

전환수

• SKAdNetwork 버전의 새 세그먼트 필드: segments.sk_ad_network_version
• offline_conversion_upload_conversion_action_summary: 전환 액션 수준에서 전환 업로드 진단을 노출합니다.
• 아직 처리 중인 업로드된 전환 수를 전달하기 위해 다음 측정항목이 오프라인 진단 보고서에 추가됩니다.
  • offline_conversion_upload_client_summary
    • pending_event_count
    • pending_rate
  • offline_conversion_upload_conversion_action_summary:
    • pending_count

계획

• 입력 기본 속성과 잠재고객 속성 모음을 허용하고 기본 속성과 잠재고객 속성 간의 잠재적 YouTube 도달범위 중복에 대한 추정치를 반환하는 AudienceInsights.GenerateAudienceOverlapInsights()

보고

• segments.date를 기반으로 per_store_view 세분화 지원

동영상

• ad_group, campaign와 같은 보고서를 사용하여 동영상 캠페인의 다음 표준 입찰 전략과 관련된 정보를 검색할 수 있습니다.
  • Campaign.fixed_cpm (고정 CPM (1,000회 노출당비용))
  • Campaign.target_cpv (타겟 CPV (조회당비용))
• Campaign.video_campaign_settings: 다음 보고서 필드를 사용하여 동영상 광고가 게재될 수 있는 인벤토리를 확인할 수 있습니다.
  • campaign.video_campaign_settings.video_ad_inventory_control.allow_in_feed
  • campaign.video_campaign_settings.video_ad_inventory_control.allow_in_stream
  • campaign.video_campaign_settings.video_ad_inventory_control.allow_shorts
• segments.ad_format_type: 동영상 광고 형식 유형을 기준으로 다음 보고서를 분류할 수 있습니다.
  • ad_group
  • ad_group_ad
  • ad_group_ad_asset_view
  • campaign
  • customer

v17 (2024-06-05)

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

광고

• AdService.getAd을 삭제했습니다. 이렇게 하면 AdService가 Google Ads API의 다른 서비스와 일치하게 됩니다. 광고 및 기타 리소스 유형을 가져오는 권장 방법은 객체 검색을 참고하세요.
• 크기 및 형식과 관련하여 ImageAdInfo.image_asset에 대한 유효성 검사를 추가했습니다. 이미지가 유효하지 않으면 다음 오류가 발생할 수 있습니다.
  • ImageError.UNEXPECTED_SIZE
  • ImageError.FORMAT_NOT_ALLOWED

애셋

• 새 enum ClickType.AD_IMAGE을 추가했습니다.
• 실적 최대화 캠페인 및 검색 캠페인의 새로운 측정항목이 포함된 다음과 같은 새로운 보고서가 추가되었습니다.
  • campaign_aggregate_asset_view
  • channel_aggregate_asset_view

잠재고객

• OfflineUserDataJobError.OPERATION_LEVEL_CONSENT_PROVIDED 추가됨

일괄 작업

• 제출된 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이더라도 응답과 함께 반환됩니다. 이렇게 하면 다른 측정항목과 일치합니다.
  • metrics.all_conversions_value_by_conversion_date
  • metrics.all_conversions_by_conversion_date
  • metrics.conversions_value_by_conversion_date
  • metrics.conversions_by_conversion_date

기준

• 광고그룹 기준이 게재 중인지 또는 게재되지 않는 이유를 표시하기 위해 다음 필드가 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() 메서드를 사용하여 도입된 대화를 나타냅니다.
• 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를 변경 가능하도록 만들었습니다.

보관처리된 출시 노트

보관처리된 출시 노트는 지원 중단된 버전을 참고하세요.