출시 노트

v17 (2024-06-05)

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

Google Ads

• 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가 1,048,4504바이트보다 클 때 발생하는 BatchJobError.REQUEST_TOO_LARGE를 추가했습니다.
• BatchJobService를 사용할 때 MutateOperation.asset_group_operation 설정 지원을 추가했습니다. 이렇게 하면 일괄 처리를 통해 전체 실적 최대화 캠페인을 만들고 관리할 수 있습니다. 새로운 전용 가이드를 참고하세요.

캠페인

• 캠페인, 광고, 애셋과 같은 Google Ads API 전반의 모든 필드, 열거형, 모든 리소스 오류에서 디스커버리가 디맨드젠 캠페인으로 변경되었습니다. 예를 들어 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()를 추가했습니다. 이를 통해 리드가 생성된 방식에 따라 SMS와 같은 적절한 채널을 통해 사용자에게 메시지를 전송합니다.
  • AppendLeadConversationRequest.conversations의 크기는 1,000으로 제한됩니다.
  • lead_type가 LeadType.MESSAGE로 설정된 LocalServicesLead만 Conversation.local_services_lead에서 지정할 수 있습니다.
• ConversationType에 새 enum 값을 추가했습니다.
  • 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입니다.

대상

• 새로운 열거형 값: 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입니다.

전환수

• SkAdNetworkConversionValueSchema.postback_mappings - SKAdNetwork 4.0 기능을 지원합니다.
• 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를 추가했습니다. 이는 null이 아닌 Campaign.shopping_setting를 포함하는 디맨드젠 캠페인에 사용할 수 있습니다.
• 광고그룹의 게재 여부 또는 광고가 게재되지 않는 이유를 표시하기 위해 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를 추가했습니다.

v15 (2023-10-18)

v15에 다음과 같은 새로운 기능과 업데이트가 도입되었습니다.

계정 관리

• 승인되지 않은 계정 활동으로 인해 계정이 정지된 경우 customer.status 및 customer_client.status가 이제 SUSPENDED로 반환됩니다. 이전에는 ENABLED로 반환되었습니다.
• Google Ads 계정과 판매자 센터 계정 간의 연결 추가 및 삭제에 대한 지원이 추가되었습니다.
  • ProductLink.merchant_center 및 MerchantCenterIdentifier를 추가했습니다.
  • LinkedProductType.MERCHANT_CENTER를 추가했습니다.
• 다른 제품에서 보낸 연결 초대 업데이트를 지원하도록 ProductLinkInvitationService 및 ProductLinkInvitation를 추가했습니다. Hotel Center 및 판매자 센터 계정에서 사용할 수 있습니다.
• MerchantCenterLinkService을 삭제했습니다.
  • Google Ads 계정을 판매자 센터 계정과 연결하려면 ProductLinkInvitationService 및 ProductLinkService를 사용합니다.
• AccountLink.hotel_center 및 AccountLinkService를 사용하여 Hotel Center 계정에서 연결 초대 업데이트 지원을 삭제했습니다.
  • Hotel Center 계정에서 연결 초대를 업데이트하려면 ProductLinkInvitationService을 사용하세요.

애셋

• 애셋을 사용하여 이미지를 추가하고 삭제할 수 있도록 ImageAdInfo.media_file를 ImageAdInfo.image_asset로 대체했습니다. 따라서 더 이상 필요하지 않은 MediaFileService도 삭제했습니다.
• 맞춤 라벨 및 URL 하위 문자열을 기반으로 등록정보 그룹 필터 생성을 지원하는 ListingGroupFilterDimension.webpage를 추가했습니다.
  • 또한 AssetGroupListingGroupFilter.vertical가 AssetGroupListingGroupFilter.listing_source 및 ListingGroupFilterListingSource로 대체되었습니다.
• 애셋 그룹 애셋의 소스를 표시하도록 asset_group_asset.source를 추가했습니다.
• 광고 그룹 광고 애셋의 소스를 표시하는 ad_group_ad_asset_view.source를 추가했습니다.

대상

• 고객 일치 타겟팅의 경우, 동의 제공을 지원하기 위해 CustomerMatchUserListMetadata.consent를 추가했습니다. 2024년 3월 6일부터 EEA 사용자의 동의가 누락되면 동의 값이 동의하지 않은 것으로 간주됩니다. 동의하지 않은 EEA 사용자의 데이터는 처리되지 않으며 고객 일치 타겟팅을 사용한 광고 개인 최적화에 사용할 수 없습니다. 자세한 내용은 고객 일치 타겟팅 가이드를 참고하세요.
• 매장 판매의 경우, 동의 제공을 지원하기 위해 UserData.consent를 추가했습니다. 자세한 내용은 오프라인 매장 판매 가이드를 참고하세요. 매장 판매에 고객 일치 타겟팅을 사용하는 경우 FAQ에서 자세한 내용을 확인하세요.
• 제공된 기존 시드 잠재고객을 기반으로 생성된 잠재고객인 유사 세그먼트를 만들 수 있도록 UserList.lookalike_user_list를 추가했습니다. 유사 세그먼트는 디맨드젠 캠페인에서만 사용할 수 있습니다.

캠페인

• 실적 최대화 캠페인 업데이트:

  • 이제 AssetGroupSignal에서 향상된 타겟팅을 위해 애셋 그룹에 연결할 수 있는 두 가지 신호 유형을 지원합니다.
    • AssetGroupSignal.audience
      • 잠재고객 사용을 특정 애셋 그룹으로 제한하는 Audience.scope 및 Audience.asset_group를 추가했습니다. Audience.asset_group는 Audience.scope가 ASSET_GROUP인 경우에만 설정해야 합니다.
    • AssetGroupSignal.search_theme
      • 이 새 기준 유형을 지원하는 CriterionType.SEARCH_THEME를 추가했습니다. 이 새로운 기준 유형은 AssetGroupSignal.search_theme에 SearchThemeInfo 기준을 입력하여 AssetGroupSignal를 만들기 위해 실적 최대화 캠페인에서만 사용할 수 있습니다.
  • 애셋 그룹 신호를 추가할 때 예외 요청을 지원하도록 AssetGroupSignalOperation.exempt_policy_violation_keys를 추가했습니다.
  • 애셋 그룹 수준에서 실적이 우수한 애셋을 보고하는 새 asset_group_top_combination_view를 추가했습니다.
  • 이제 측정항목 필드를 사용하여 asset_group를 쿼리하여 실적 최대화 캠페인의 실적 가져오기를 지원할 수 있습니다.
  • PerformanceMaxUpgradeStatus에서 UPGRADE_ELIGIBLE의 이름이 UPGRADE_ELIGIBLE로 변경되었습니다.

• 디맨드젠 및 디스커버리 타겟 CPA 캠페인의 경우 캠페인 수준 타겟 CPA 입찰가 시뮬레이션(campaign_simulation.target_cpa_point_list.points)에서 이제 TargetCpaSimulationPoint.clicks 대신 TargetCpaSimulationPoint.interactions를 반환합니다.

• 제공된 브랜드 접두사 및 제외된 브랜드 목록을 기반으로 브랜드를 추천할 수 있는 BrandSuggestionService를 추가했습니다. 이러한 브랜드를 사용하여 BRAND 기준을 만들고 BRANDS 공유 세트에 추가한 다음 brand_list이 공유 세트로 설정된 CampaignCriterion를 만들어 캠페인에 연결할 수 있습니다. 캠페인 기준은 검색 캠페인에서 타겟팅하고 실적 최대화 캠페인에서 각각 제외할 수 있습니다.

  • 필드:
    • SharedCriterion.brand
    • CampaignCriterion.brand_list
  • enum:
    • SharedSetType.BRANDS
    • CriterionType.BRAND_LIST

• 각 애셋 유형의 자동화 상태를 표시하는 Campaign.asset_automation_settings[]를 추가했습니다.

• CampaignPrimaryStatusReason enum에 다음 값을 추가했습니다.

  • NO_ASSET_GROUPS
  • ASSET_GROUPS_PAUSED

전환수

• 동의 제공을 지원하기 위해 CallConversion.consent 및 ClickConversion.consent를 추가했습니다. 자세한 내용은 통화 전환 가이드 및 클릭 전환 가이드를 참고하세요.
• customer 또는 campaign로 쿼리할 때 사용할 수 있는 SKAdNetwork 전환과 관련된 다음 필드가 추가되었습니다.
  • 세그먼트:
    • segments.sk_ad_network_coarse_conversion_value
    • segments.sk_ad_network_source_domain
    • segments.sk_ad_network_source_type
    • segments.sk_ad_network_postback_sequence_index
  • 측정항목:
    • metrics.sk_ad_network_total_conversions
    • metrics.sk_ad_network_installs
• metrics.sk_ad_network_conversions을 metrics.sk_ad_network_installs로 대체했습니다.
• 오프라인 전환 업로드 진단을 위한 지원이 추가되었습니다.
  • offline_conversion_upload_client_summary를 customer 리소스의 필드에서 최상위 보고서로 이동했습니다. 이 보고서를 사용하여 성공적인 이벤트 수, 성공률, 오류 비율과 같은 전환 업로드 상태에 관한 유용한 세부정보를 확인할 수 있습니다.
    • 주의사항: 업로드되었지만 ConversionUploadError.CLICK_NOT_FOUND 오류가 발생한 전환도 성공적인 것으로 집계되지만, OfflineConversionAlert로도 신고됩니다.
  • 여러 업로드 요청을 논리적으로 단일 개념 작업으로 그룹화할 수 있도록 다음 요청 유형의 선택적 매개변수로 job_id가 추가되었습니다.
    • UploadConversionAdjustmentsRequest
    • UploadClickConversionsRequest
  • 다음 오류에 INVALID_JOB_ID가 추가되었습니다.
    • ConversionAdjustmentUploadError
    • ConversionUploadError
  • 다음 오류에서 INVALID_CONVERSION_ACTION를 NO_CONVERSION_ACTION_FOUND 및 INVALID_CONVERSION_ACTION_TYPE로 대체했습니다.
    • ConversionAdjustmentUploadError
    • ConversionUploadError
• 리디렉션 없는 Android 개인 정보 보호 샌드박스 교차 네트워크 기여 분석을 지원하는 보고서 3개를 추가했습니다.
  • android_privacy_shared_key_google_campaign - shared_campaign_key와 키를 인코딩하는 데 도움이 되는 일부 필드가 포함되어 있습니다.
  • android_privacy_shared_key_google_ad_group - shared_ad_group_key와 키를 인코딩하는 데 도움이 되는 일부 필드가 포함되어 있습니다.
  • android_privacy_shared_key_google_network_type - shared_network_type_key와 키를 인코딩하는 데 도움이 되는 일부 필드가 포함되어 있습니다.
• ConversionActionError.CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS를 추가했습니다. 이제 지원 중단된 규칙 기반 기여 분석 모델 중 하나를 사용하려고 시도하는 ConversionActionOperation가 이 오류와 함께 실패합니다. 이전에는 작업이 UNKNOWN 오류와 함께 실패했습니다.

호텔 및 여행

• travel_activity_group_view 및 travel_activity_performance_view에 다음 필드 지원이 추가되었습니다.
  • 세그먼트:
    • segments.activity_account_id
    • segments.activity_rating
    • segments.external_activity_id
  • 측정항목:
    • metrics.search_absolute_top_impression_share
    • metrics.search_budget_lost_absolute_top_impression_share
    • metrics.search_budget_lost_impression_share
    • metrics.search_budget_lost_top_impression_share
    • metrics.search_impression_share
    • metrics.search_rank_lost_absolute_top_impression_share
    • metrics.search_rank_lost_impression_share
    • metrics.search_rank_lost_top_impression_share
    • metrics.search_top_impression_share

지역 서비스 광고

• 지역 서비스 광고주의 세분화된 라이선스 및 보험 상태를 반환하는 LocalServicesSettings 및 필드를 customer 보고서에 추가했습니다.
• 지역 서비스에 관한 다음과 같은 신규 보고서가 추가되었습니다.
  • local_services_lead에는 지역 서비스 광고 리드와 관련된 모든 세부정보(예: lead_charged, lead_type, lead_status)가 포함됩니다.
    • enum:
      • LeadStatus
      • LeadType
  • local_services_lead_conversation에는 conversation_channel, call_duration_millis, call_recording_url와 같은 메시지 및 전화 대화 세부정보가 포함됩니다.
    • 전화 통화 녹음 URL이 대상 고객 계정 및 해당 관리자 계정에 대해 인증됩니다.
  • local_services_verification_artifact는 백그라운드 확인, 비즈니스 라이선스, 비즈니스 보험 데이터와 같은 지역 서비스 광고주의 아티팩트를 반환합니다. 라이선스 및 보험과 관련된 모든 문서는 URL을 통해 액세스할 수 있습니다.
    • enum:
      • LocalServicesVerificationArtifactStatus
      • LocalServicesVerificationArtifactType
      • LocalServicesInsuranceRejectionReason
      • LocalServicesLicenseRejectionReason

계획

• 관련 제품 유형의 ReachPlanService.ListPlannableProducts에 Forecast.views 및 PlannedProductForecast.views를 반환하도록 지원을 추가했습니다.
• ReachPlanService.ListPlannableProducts의 PlannableTargeting.surface_targeting 반환 지원을 추가했습니다. 이는 제품에 사용할 수 있는 노출 영역을 설명합니다.
• 새 ReachPlanSurface enum을 추가했습니다.
• PlannedProductForecast.average_frequency를 반환하는 AdvancedProductTargeting.target_frequency_settings를 사용하여 타겟 게재빈도를 타겟팅하는 지원을 추가했습니다.
• 타겟팅 가능한 추천 잠재고객을 반환하는 AudienceInsightsService.GenerateSuggestedTargetingInsights를 추가했습니다.
• 다음 값을 ReachPlanError에 추가했습니다.
  • NOT_FORECASTABLE_NOT_ENOUGH_INVENTORY
  • NOT_FORECASTABLE_ACCOUNT_NOT_ENABLED

권장사항

• 추천 구독을 관리하는 RecommendationSubscriptionService를 추가했습니다.
  • 리소스: RecommendationSubscription
  • 필드: MutateOperation.recommendation_subscription_operation
  • 열거형: ChangeClientType.GOOGLE_ADS_RECOMMENDATIONS_SUBSCRIPTION
  • 오류:
    • RecommendationSubscriptionError
    • RecommendationSubscriptionStatus
• 다음 유형의 추천이 추가되었습니다.
  • FORECASTING_SET_TARGET_CPA: 트래픽 증가가 예측되는 시즌 이벤트에 앞서 타겟 CPA를 지정하지 않은 캠페인의 타겟 CPA를 설정할 것을 권장합니다.
  • SET_TARGET_CPA가 지정되지 않은 캠페인의 경우 타겟 CPA를 설정하는 것이 좋습니다.
  • SET_TARGET_ROAS가 지정되지 않은 캠페인의 경우 타겟 ROAS를 설정하는 것이 좋습니다.

보고

• campaign (디스플레이, 동영상, 디스커버리, 앱 캠페인에 사용 가능) 및 segments.device로 쿼리할 수 있는 다음과 같은 새 측정항목이 추가되었습니다.
  • metrics.unique_users
  • metrics.average_impression_frequency_per_user

쇼핑

• 값이 이제 ShoppingSetting.feed_label로 반환되는 ShoppingSetting.sales_country를 삭제했습니다.
  • ShoppingSetting.feed_label 필드를 사용하여 캠페인에 특정 판매자 센터 피드를 계속 사용할 수 있습니다. 이전에 ShoppingSetting.sales_country에 사용한 피드 라벨 값 또는 2자리 국가 코드로 설정해야 합니다. 자세한 내용은 피드 라벨 지원 도움말을 참고하세요.
• 보고에서 국가 코드에 대한 제품 카테고리의 종속 항목이 삭제되었습니다. 지원되는 카테고리 ID 집합은 변경되지 않았습니다.
  • shopping_performance_view에 사용되는 다음 필드가 대체되었습니다.
    • segments.product_category_level1로 segments.product_bidding_category_level1
    • segments.product_category_level2로 segments.product_bidding_category_level2
    • segments.product_category_level3로 segments.product_bidding_category_level3
    • segments.product_category_level4로 segments.product_bidding_category_level4
    • segments.product_category_level5로 segments.product_bidding_category_level5
  • product_bidding_category_constant를 product_category_constant로 대체했습니다. 이는 반복되는 필드에서 카테고리의 사용 가능한 모든 현지화를 반환합니다.
  • ListingDimensionInfo.product_bidding_category을 ListingDimensionInfo.product_category로 대체했습니다.
  • ListingGroupFilterDimension.product_bidding_category을 ListingGroupFilterDimension.product_category로 대체했습니다.
• 검색 캠페인에 Campaign.shopping_setting를 추가하는 작업에 대한 지원을 삭제했습니다. Campaign.shopping_setting를 사용하여 검색 캠페인을 만들거나 기존 검색 캠페인에 Campaign.shopping_setting를 추가하려고 하면 이제 OPERATION_NOT_PERMITTED_FOR_CONTEXT이 발생합니다.
• 검색 캠페인에 CampaignCriterion.listing_scope를 추가하는 기능이 삭제되었습니다. 이제 기존 검색 캠페인에 CampaignCriterion.listing_scope를 추가하면 OPERATION_NOT_PERMITTED_FOR_CONTEXT이 발생합니다.
• 다음 장바구니 데이터를 사용한 전환 측정항목이 추가되었습니다.
  • metrics.orders
  • metrics.average_order_value_micros
  • metrics.average_cart_size
  • metrics.cost_of_goods_sold_micros
  • metrics.gross_profit_micros
  • metrics.gross_profit_margin
  • metrics.revenue_micros
  • metrics.units_sold
  • metrics.cross_sell_cost_of_goods_sold_micros
  • metrics.cross_sell_gross_profit_micros
  • metrics.cross_sell_revenue_micros
  • metrics.cross_sell_units_sold
  • metrics.lead_cost_of_goods_sold_micros
  • metrics.lead_gross_profit_micros
  • metrics.lead_revenue_micros
  • metrics.lead_units_sold
  • 이러한 측정항목은 모두 다음 보고서에서 선택할 수 있습니다.
    • ad_group
    • ad_group_ad
    • asset_group_product_group_view
    • campaign
    • customer
    • keyword_view
    • product_group_view
    • shopping_performance_view

통합 목표

• 고객 수준에서 고객 획득 목표를 구성하기 위한 CustomerLifecycleGoalService.ConfigureCustomerLifecycleGoals를 추가했습니다.
  • 보고서: customer_lifecycle_goal
• 캠페인 수준에서 고객 획득 목표를 구성하기 위한 CampaignLifecycleGoalService.ConfigureCampaignLifecycleGoals를 추가했습니다.
  • 보고서: campaign_lifecycle_goal
• CampaignConversionGoalError.CANNOT_USE_STORE_SALE_GOAL_FOR_PERFORMANCE_MAX_CAMPAIGN를 추가했습니다.
• 다음 값을 ConversionGoalCampaignConfigError에 추가했습니다.
  • EMPTY_CONVERSION_GOALS
  • STORE_SALE_STORE_VISIT_CANNOT_BE_BOTH_INCLUDED
  • PERFORMANCE_MAX_CAMPAIGN_CANNOT_USE_CUSTOM_GOAL_WITH_STORE_SALES

동영상

• 캠페인 수준에서 Google TV를 타겟팅하는 지원이 추가되었습니다.
  • NetworkSettings.target_google_tv_network 추가됨
  • AdNetworkType.GOOGLE_TV를 추가했습니다.
• 캠페인 수준에서 YouTube 타겟팅에 대한 지원이 추가되었습니다.
  • NetworkSettings.target_youtube 추가됨
  • AdNetworkType에서 YOUTUBE_WATCH 및 YOUTUBE_SEARCH를 YOUTUBE에 병합했습니다.
  • CampaignError.CANNOT_TARGET_DISPLAY_NETWORK_WITHOUT_YOUTUBE를 추가했습니다.

보관처리된 출시 노트

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