출시 노트

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

지역 서비스

• 지정된 로컬 서비스 리드 대화에 통화 녹음 파일이 없는 경우 잘못된 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 보고서로 쿼리할 수 있습니다.
  • metrics.general_invalid_clicks
  • metrics.general_invalid_click_rate
• 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: 전환 액션 수준에서 전환 업로드 진단을 노출합니다.
• 아직 처리 중인 업로드된 전환 수를 전달하기 위해 다음 측정항목이 오프라인 진단 보고서에 추가되었습니다.
  • 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를 변경 가능하도록 만들었습니다.

v16.1.0 (2024-04-24)

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

계정 관리

• CustomerNegativeCriterion.ip_block: 고객 수준에서 IP를 제외 기준으로 추가하는 것을 지원합니다.
• 새 enum 값: ProductLinkError.LINK_EXISTS.
• 새 enum 값: ProductLinkInvitationError.CUSTOMER_NOT_PERMITTED_TO_CREATE_INVITATION.

애셋

• 디맨드젠과 관련된 확장 소재를 ad_group_ad_asset_view 및 asset_field_type_view에 지원합니다.
• 새 enum 값: AssetFieldType.DISCOVERY_CAROUSEL_CARD.

잠재고객

• 새 enum 값: ResourceLimitType.LOOKALIKE_USER_LISTS_PER_CUSTOMER: 고객이 보유할 수 있는 유사한 사용자 목록의 수를 1,000개로 제한합니다.

캠페인

• campaign_simulation 보고서를 사용하여 앱 캠페인의 타겟 ROAS 캠페인 입찰가 시뮬레이션을 반환하는 기능이 지원됩니다.
• 새 enum 값: CampaignError.DYNAMIC_TEXT_ASSET_CANNOT_OPT_OUT_WITH_FINAL_URL_EXPANSION_OPT_IN.
• 새 enum 값: AdGroupPrimaryStatusReason.AD_GROUP_PAUSED_DUE_TO_LOW_ACTIVITY.
• 새 enum 값: CampaignCriterionError.CANNOT_REMOVE_ALL_LOCATIONS_DUE_TO_TOO_MANY_COUNTRY_EXCLUSIONS.

전환수

• SKAdNetwork 4.0 기능을 지원하는 SkAdNetworkConversionValueSchema.postback_mappings
• CustomerSkAdNetworkConversionValueSchemaService에 대한 경고 지원을 MutateCustomerSkAdNetworkConversionValueSchemaRequest.enable_warnings로 추가했습니다. true로 설정하면 작업 실패와 관련된 비차단 오류가 MutateCustomerSkAdNetworkConversionValueSchemaResponse.warning로 반환됩니다.
• CustomerSkAdNetworkConversionValueSchemaError의 새로운 enum 값:
  • INVALID_EVENT_COUNTER
  • INVALID_EVENT_NAME

기준

• BrandInfo의 새 필드:
  • display_name
  • primary_url
  • rejection_reason
  • status
• 새 enum: BrandRequestRejectionReason
• 새 enum 값: CriterionType.LIFE_EVENT.

실험

• 새 enum 값: ExperimentError.INVALID_DURATION_FOR_AN_EXPERIMENT.

지역 서비스

• local_services_lead.credit_details.credit_state 및 local_services_lead.credit_details.credit_state_last_update_date_time: 각각 크레딧 상태와 크레딧 상태가 업데이트된 타임스탬프를 반환합니다.
• local_services_lead_conversation.message_details.attachment_urls: 첨부파일의 콘텐츠를 다운로드하는 데 사용할 수 있는 URL을 반환합니다.

동영상

• customer.video_brand_safety_suitability 및 BrandSafetySuitability: 고객 수준에서 동영상 브랜드 안전성 적합성 검색을 지원합니다.
• 새 enum 값: VideoCampaignError.MUTATE_REQUIRES_RESERVATION.

v16 (2024-02-21)

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

계정 관리

• advertising_partner를 AccountLink에서 ProductLink 및 ProductLinkInvitation로 이전했습니다.
• AccountLink에서 data_partner 및 google_ads를 삭제했습니다.
• 광고주 인증을 관리하는 IdentityVerificationService를 추가했습니다.
  • StartIdentityVerification()는 제공된 verification_program를 사용하여 인증 세션을 시작하는 데 사용됩니다. 새 인증 세션을 만들고 성공적으로 생성된 인증에 대해 빈 응답을 반환합니다.
    • IdentityVerificationProgram.ADVERTISER_IDENTITY_VERIFICATION를 추가했습니다.
  • GetIdentityVerification()는 인증 정보를 검색하는 데 사용할 수 있으며, 이 정보는 IdentityVerification의 여러 객체를 반환합니다. 각 IdentityVerification에는 다음이 포함됩니다.
    • verification_program: 신원 확인 프로그램 유형입니다.
    • 광고주가 인증을 완료해야 하는 기한과 관련된 세부정보가 포함된 identity_verification_requirement
    • 다음을 포함하여 인증 세션과 관련된 세부정보가 포함된 verification_progress:
      • program_status는 이 인증 세션의 현재 상태를 나타냅니다.
      • action_url는 고객을 인증을 완료할 수 있는 URL로 안내합니다.
      • invitation_link_expiration_time는 action_url의 만료일을 나타냅니다.
  • enum:
    • IdentityVerificationProgram
    • IdentityVerificationProgramStatus
  • 오류:
    • IdentityVerificationError
• AuthorizationError.ACTION_NOT_PERMITTED_FOR_SUSPENDED_ACCOUNT를 추가했습니다.

애셋

• asset_group 변경사항:
  • segments.year 및 segments.month와 같은 시간 관련 세그먼트 지원을 추가했습니다.
  • campaign를 리소스 분류 대신 기여 분석 리소스로 만들었습니다.

캠페인

• 디맨드젠 캠페인 변경사항:
  • 기존 디맨드젠 캠페인에 Campaign.shopping_setting를 설정하는 기능이 추가되었습니다.
  • 디맨드젠 캠페인의 선택적 제품 피드를 사용 중지하는 ShoppingSetting.disable_product_feed를 추가했습니다.
  • Ad.demand_gen_product_ad 및 이에 상응하는 DemandGenProductAdInfo를 추가했습니다. 이 기능은 Campaign.shopping_setting가 null이 아닌 디맨드젠 캠페인에서 사용할 수 있습니다.
• 광고 그룹이 게재 중인지 또는 게재되지 않는 이유를 표시하기 위해 AdGroup의 다음 필드에 추가했습니다.
  • primary_status
  • primary_status_reasons
• 광고그룹 광고가 게재 중인지 또는 게재되지 않는 이유를 표시하기 위해 AdGroupAd의 다음 필드가 추가되었습니다.
  • primary_status
  • primary_status_reasons
• AdGroupError에 다음 값을 추가했습니다.
  • CANNOT_ADD_AD_GROUP_FOR_CAMPAIGN_TYPE
  • INVALID_STATUS

실험

• 실험에서 동기화를 사용 설정해야 하는지 지정하는 Experiment.sync_enabled를 추가했습니다. 동기화가 사용 설정된 경우 실험이 진행되는 동안 기존 캠페인에 적용된 변경사항이 실험 캠페인에 자동으로 복사됩니다.
• ExperimentError.CANNOT_ENABLE_SYNC_FOR_UNSUPPORTED_EXPERIMENT_TYPE를 추가했습니다.
• CampaignError.CANNOT_MODIFY_TEXT_ASSET_AUTOMATION_WITH_ENABLED_TRIAL를 추가했습니다.

호텔 및 여행

• 여행 활동을 이용할 수 있는 주와 도시를 기반으로 등록정보 그룹을 만들 수 있도록 할 목적으로 ListingDimensionInfo의 할 일 광고에 다음 필드를 추가했습니다.
  • activity_state
  • activity_city
• travel_activity_performance_view에 다음 세그먼트 지원을 추가했습니다.
  • segments.activity_city
  • segments.activity_country
  • segments.activity_state

지역 서비스

• 광고주가 비즈니스 등록 인증 절차의 진행 상황을 모니터링할 수 있도록 LocalServicesVerificationArtifact.business_registration_check_verification_artifact 및 BusinessRegistrationCheckArtifact를 추가했습니다.
• 광고주가 추가한 직원 정보를 가져올 수 있도록 새 리소스 local_services_employee를 추가했습니다.

계획

• AudienceInsightsAttributeMetadata에서 score를 삭제했습니다.

권장사항

• 추천 유형, 광고 채널 유형과 같은 지정된 설정에 따라 추천을 반환하는 RecommendationService.GenerateRecommendations()를 추가했습니다. 이는 캠페인 구성 중에 특히 유용합니다.
• RecommendationMetrics.conversions_value를 추가했습니다.
• 이제 키워드 검색 유형이 설정되지 않은 추천 키워드의 recommended_match_type가 UNKNOWN 대신 UNSPECIFIED로 설정됩니다.
• 다음과 같은 추천 유형이 추가되었습니다.
  • MAXIMIZE_CONVERSION_VALUE_OPT_IN: 전환 가치 극대화 입찰 전략을 선택하는 것이 좋습니다.
  • IMPROVE_GOOGLE_TAG_COVERAGE: 더 많은 페이지에 Google 태그를 배포하도록 권장합니다.
  • PERFORMANCE_MAX_FINAL_URL_OPT_IN: 실적 최대화 캠페인에 최종 URL 확장을 사용 설정하도록 권장하는 카드
  • REFRESH_CUSTOMER_MATCH_LIST: 지난 90일 동안 업데이트되지 않은 고객 목록을 업데이트할 것을 권장합니다.
  • CUSTOM_AUDIENCE_OPT_IN: 맞춤 잠재고객을 만드는 것이 좋습니다.
  • LEAD_FORM_ASSET: 캠페인 또는 고객 수준에서 리드 양식 확장 소재를 추가하도록 권장합니다.
  • IMPROVE_DEMAND_GEN_AD_STRENGTH: 디맨드젠 캠페인의 광고 효력을 개선하도록 권장

쇼핑

• Comparison Shopping Service Center 계정에 연결된 쇼핑 캠페인에 관한 더 자세한 오류를 제공하기 위해 CampaignError.CANNOT_LINK_TO_COMPARISON_SHOPPING_SERVICE_ACCOUNT 및 CampaignError.CANNOT_TARGET_NETWORK_FOR_COMPARISON_SHOPPING_SERVICE_LINKED_ACCOUNTS를 추가했습니다.
• AssetGroupListingGroupFilterError에 다음 값을 추가했습니다.
  • DIMENSION_TYPE_NOT_ALLOWED
  • DUPLICATE_WEBPAGE_FILTER_UNDER_ASSET_GROUP
  • FILTER_EXCLUSION_NOT_ALLOWED
  • LISTING_SOURCE_NOT_ALLOWED
  • MULTIPLE_LISTING_SOURCES
  • MULTIPLE_WEBPAGE_CONDITION_TYPES_NOT_ALLOWED
  • MULTIPLE_WEBPAGE_TYPES_PER_ASSET_GROUP
  • PAGE_FEED_FILTER_HAS_PARENT

수명 주기 목표

• 이러한 작업 유형을 API의 다른 작업 유형과 일치시키기 위해 CustomerLifecycleGoalOperation 및 CampaignLifecycleGoalOperation에 update를 추가했습니다.

보관처리된 출시 노트

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