Примечания к выпуску

v17 (05.06.2024)

Следующие функции и изменения были добавлены в v17.

Объявления

• Удален AdService.getAd . Это приводит AdService в соответствие с другими сервисами Google Ads API. Рекомендуемый способ получения рекламы и других типов ресурсов см. в разделе «Извлечение объектов».
• Добавлены дополнительные проверки для ImageAdInfo.image_asset относительно размеров и формата. Если изображение недействительно, могут возникнуть следующие ошибки:
  • ImageError.UNEXPECTED_SIZE
  • ImageError.FORMAT_NOT_ALLOWED

Ресурсы

• Добавлено новое перечисление: ClickType.AD_IMAGE
• Добавлены следующие новые отчеты с новыми показателями для кампаний с максимальной эффективностью и кампаний в поисковой сети:
  • campaign_aggregate_asset_view
  • channel_aggregate_asset_view

Аудитории

• Добавлен OfflineUserDataJobError.OPERATION_LEVEL_CONSENT_PROVIDED .

Пакетные задания

• Добавлен BatchJobError.REQUEST_TOO_LARGE , который будет выдан, если отправленный AddBatchJobOperationsRequest превышает 10484504 байта.
• Добавлена ​​поддержка настройки MutateOperation.asset_group_operation при использовании BatchJobService . Это позволяет использовать пакетную обработку для создания целых кампаний с максимальной эффективностью и управления ими. См. наше новое специальное руководство .

Кампании

• Обнаружение переименовано в Генерирование спроса во всех полях, перечислениях и ошибках всех ресурсов в API Google Рекламы, таких как кампании, объявления и активы. Например, 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 .
• Следующие метрики теперь возвращаются вместе с ответом, даже если они равны нулю. Это делает их совместимыми с другими показателями.
  • 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
• Добавлена ​​поддержка metrics.search_impression_share для gender_view
• Добавлена ​​поддержка metrics.phone_calls для keyword_view

Местные услуги

• Добавлен LocalServicesLeadService.AppendLeadConversation() используемый для добавления нового LocalServicesLeadConversation к LocalServicesLead , который отправляет сообщения пользователям через соответствующие каналы, такие как SMS, в зависимости от того, как был создан интерес.
  • Размер AppendLeadConversationRequest.conversations ограничен 1000.
  • В Conversation.local_services_lead можно указать только LocalServicesLead с lead_type установленным в LeadType.MESSAGE .
• Добавлены новые значения перечисления в 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 .

Покупка

• Добавлен новый отчет shopping_product , который соответствует странице «Товары» в пользовательском интерфейсе Google Рекламы. Он поддерживает возврат данных о текущем состоянии продуктов из учетных записей Google Merchant Center, связанных с учетной записью Google Рекламы.
  • Вы можете фильтровать показатели из отчета shopping_product , используя segments.date при использовании GoogleAdsService.Search или GoogleAdsService.SearchStream . Сегментация по дате не разрешена. В результате будет возвращена ошибка 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
• Добавлен AdVideoAsset.ad_video_asset_info для поддержки настроек инвентаря для видеоресурсов при создании DemandGenVideoResponsiveAdInfo .
• (Только учетные записи из белого списка) Campaign.video_brand_safety_suitability стал изменяемым.

v16.1.0 (24 апреля 2024 г.)

Следующие функции и изменения были добавлены в версию 16.1.

Управление аккаунтом

• CustomerNegativeCriterion.ip_block , который поддерживает добавление IP-адреса в качестве отрицательного критерия на уровне клиента.
• Новое значение перечисления: ProductLinkError.LINK_EXISTS .
• Новое значение перечисления: ProductLinkInvitationError.CUSTOMER_NOT_PERMITTED_TO_CREATE_INVITATION .

Ресурсы

• Поддержка объектов, связанных с формированием спроса, для ad_group_ad_asset_view и asset_field_type_view .
• Новое значение перечисления: AssetFieldType.DISCOVERY_CAROUSEL_CARD .

Аудитории

• Новое значение перечисления: ResourceLimitType.LOOKALIKE_USER_LISTS_PER_CUSTOMER , которое ограничивает количество похожих списков пользователей, которые может иметь клиент, до 1000.

Кампании

• Поддержка возврата имитаций ставок кампании с целевой рентабельностью инвестиций в рекламу для кампаний для приложений с помощью отчета campaign_simulation .
• Новое значение перечисления: CampaignError.DYNAMIC_TEXT_ASSET_CANNOT_OPT_OUT_WITH_FINAL_URL_EXPANSION_OPT_IN .
• Новое значение перечисления: AdGroupPrimaryStatusReason.AD_GROUP_PAUSED_DUE_TO_LOW_ACTIVITY .
• Новое значение перечисления: 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 :
  • INVALID_EVENT_COUNTER
  • INVALID_EVENT_NAME

Критерии

• Новые поля в BrandInfo :
  • display_name
  • primary_url
  • rejection_reason
  • status
• Новое перечисление: BrandRequestRejectionReason .
• Новое значение перечисления: CriterionType.LIFE_EVENT .

Эксперименты

• Новое значение перечисления: 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 , которые поддерживают получение информации о пригодности бренда видео для обеспечения безопасности на уровне клиента.
• Новое значение перечисления: VideoCampaignError.MUTATE_REQUIRES_RESERVATION .

версия 16 (21 февраля 2024 г.)

Следующие функции и изменения были добавлены в v16.

Управление аккаунтом

• advertising_partner перенесен из AccountLink в ProductLink и ProductLinkInvitation .
• Удалены data_partner и google_ads из AccountLink .
• Добавлен 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
  • Перечисления:
    • 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 .
• В следующие поля в 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 , позволяющий рекламодателям получать добавленную ими информацию о сотрудниках.

Планирование

• Удалена score из AudienceInsightsAttributeMetadata .

Рекомендации

• Добавлена RecommendationService.GenerateRecommendations() , которая возвращает рекомендации на основе указанных настроек, таких как типы рекомендаций и типы рекламных каналов. Это особенно полезно во время разработки кампании.
• Добавлена RecommendationMetrics.conversions_value .
• Для рекомендуемых ключевых слов с неустановленным типом соответствия ключевого слова теперь recommended_match_type имеет значение UNSPECIFIED вместо UNKNOWN .
• Добавлены следующие типы рекомендаций:
  • 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 , который рекомендует повысить эффективность рекламы в кампаниях по формированию спроса.

Покупка

• Добавлены 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

Цели жизненного цикла

• Добавлено update для CustomerLifecycleGoalOperation и CampaignLifecycleGoalOperation , чтобы эти типы операций соответствовали другим типам операций в API.

v15 (18 октября 2023 г.)

Следующие новые функции и обновления были представлены в версии 15.

Управление аккаунтом

• Если ваша учетная запись заблокирована из-за несанкционированной активности , customer.status и customer_client.status теперь возвращаются как SUSPENDED . Раньше они возвращались как ENABLED .
• Добавлена ​​поддержка добавления и удаления связи между аккаунтом Google Ads и аккаунтом Merchant Center:
  • Добавлены ProductLink.merchant_center и MerchantCenterIdentifier .
  • Добавлен LinkedProductType.MERCHANT_CENTER .
• Добавлены ProductLinkInvitationService и ProductLinkInvitation для поддержки обновления приглашения по ссылке, отправленного из других продуктов, доступных для аккаунтов Hotel Center и Merchant Center .
• Удален MerchantCenterLinkService .
  • Чтобы связать аккаунты Google Рекламы с аккаунтами Merchant Center, используйте ProductLinkInvitationService и ProductLinkService .
• Удален AccountLink.hotel_center и поддержка обновления приглашений на ссылку из учетных записей Hotel Center с помощью AccountLinkService .
  • Чтобы обновить приглашение по ссылке из учетной записи Hotel Center, используйте ProductLinkInvitationService .

Ресурсы

• ImageAdInfo.media_file заменен на ImageAdInfo.image_asset для поддержки добавления и удаления изображений с использованием ресурсов. В результате мы также удалили MediaFileService , который больше не нужен.
• Добавлен ListingGroupFilterDimension.webpage для поддержки создания фильтра группы списков на основе пользовательских меток и подстрок URL-адресов.
  • Также заменен AssetGroupListingGroupFilter.vertical на AssetGroupListingGroupFilter.listing_source и ListingGroupFilterListingSource
• Добавлен asset_group_asset.source , чтобы показать источник актива группы активов.
• Добавлен ad_group_ad_asset_view.source , чтобы показать источник рекламного объекта группы объявлений.

Аудитории

• Для списка электронных адресов добавлен CustomerMatchUserListMetadata.consent для поддержки предоставления согласия. Начиная с 6 марта 2024 г., если согласие отсутствует для пользователей из ЕЭЗ, значение согласия определяется как несогласованное. Данные пользователей из ЕЭЗ, не получивших согласия, не будут обрабатываться и не могут использоваться для персонализации рекламы с помощью списков электронных адресов. Более подробную информацию можно найти в нашем руководстве по спискам электронных адресов .
• Для продаж в магазине добавлен UserData.consent для поддержки предоставления согласия. Более подробную информацию можно найти в нашем руководстве по продажам в магазине . Если вы используете списки электронных адресов для продаж в магазине, дополнительную информацию можно найти в разделе часто задаваемых вопросов .
• Добавлен UserList.lookalike_user_list для поддержки создания сегмента Lookalike — аудитории, созданной на основе предоставленной существующей исходной аудитории. Похожие сегменты можно использовать только в кампаниях по формированию спроса .

Кампании

• Обновления в кампаниях с максимальной эффективностью:

  • AssetGroupSignal теперь поддерживает два типа сигналов, которые можно прикрепить к группе активов для расширенного таргетинга:
    • AssetGroupSignal.audience
      • Добавлены Audience.scope и Audience.asset_group , чтобы ограничить использование аудитории определенной группой активов. Audience.asset_group должен быть установлен тогда и только тогда, когда Audience.scope имеет значение ASSET_GROUP .
    • AssetGroupSignal.search_theme
      • Добавлен CriterionType.SEARCH_THEME для поддержки этого нового типа критерия. Этот новый тип критерия можно использовать только в кампаниях с максимальной эффективностью для создания AssetGroupSignal путем заполнения AssetGroupSignal.search_theme критерием SearchThemeInfo .
  • Добавлен AssetGroupSignalOperation.exempt_policy_violation_keys для поддержки запроса исключения при добавлении сигналов группы активов.
  • Добавлен новый asset_group_top_combination_view для отчета о наиболее эффективных активах на уровне группы активов.
  • asset_group теперь можно запрашивать с полями показателей, чтобы получить информацию об эффективности кампании с максимальной эффективностью.
  • В PerformanceMaxUpgradeStatus переименован в UPGRADE_ELIGIBLE в UPGRADE_ELIGIBLE .

• Для кампаний «Создание спроса» и «Целевая цена за конверсию Discovery» моделирование ставок целевой цены за конверсию на уровне кампании ( campaign_simulation.target_cpa_point_list.points ) теперь возвращает TargetCpaSimulationPoint.interactions вместо TargetCpaSimulationPoint.clicks .

• Добавлен BrandSuggestionService , который может предлагать бренды на основе предоставленного префикса бренда и исключенного списка брендов. Эти бренды можно использовать для создания критерия BRAND , добавить его в общий набор BRANDS , а затем прикрепить к кампании, создав CampaignCriterion с набором brand_list для общего набора. Критерии кампании можно настроить в поисковых кампаниях и исключить из кампаний с максимальной эффективностью соответственно.

  • Поля:
    • SharedCriterion.brand
    • CampaignCriterion.brand_list
  • Перечисления:
    • SharedSetType.BRANDS
    • CriterionType.BRAND_LIST

• Добавлен Campaign.asset_automation_settings[] для отображения статуса автоматизации каждого типа активов.

• В перечисление CampaignPrimaryStatusReason добавлены следующие значения:

  • NO_ASSET_GROUPS
  • ASSET_GROUPS_PAUSED

Конверсии

• Добавлены CallConversion.consent и ClickConversion.consent для поддержки предоставления согласия. Ознакомьтесь с нашим руководством по конверсиям звонков и руководством по конверсиям по кликам для получения более подробной информации.
• Добавлены следующие поля, связанные с конверсиями SKAdNetwork , доступные при запросе их у customer или campaign :
  • Сегменты:
    • 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 Privacy Sandbox без перенаправлений :
  • 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

Реклама местных услуг

• В отчет customer добавлен LocalServicesSettings и его поля для возврата подробной информации о лицензии и статусах страхования рекламодателя местных услуг.
• Добавлены следующие новые отчеты для местных служб :
  • local_services_lead содержит все сведения, относящиеся к потенциальным клиентам из Рекламы местных услуг, такие как lead_charged , lead_type , lead_status .
    • Перечисления:
      • LeadStatus
      • LeadType
  • local_services_lead_conversation содержит сведения о сообщениях и телефонных разговорах, такие как conversation_channel , call_duration_millis , call_recording_url .
    • URL-адрес записи телефонного звонка аутентифицируется по целевой учетной записи клиента и ее управляющим учетным записям.
  • local_services_verification_artifact возвращает артефакты рекламодателя местных услуг, такие как проверка анкетных данных, бизнес-лицензии и данные бизнес-страхования. Доступ к любым документам, связанным с лицензией и страховкой, можно получить через URL-адрес.
    • Перечисления:
      • LocalServicesVerificationArtifactStatus
      • LocalServicesVerificationArtifactType
      • LocalServicesInsuranceRejectionReason
      • LocalServicesLicenseRejectionReason

Планирование

• Добавлена ​​поддержка возврата Forecast.views и PlannedProductForecast.views для ReachPlanService.ListPlannableProducts для применимых типов продуктов.
• Добавлена ​​поддержка возврата PlannableTargeting.surface_targeting для ReachPlanService.ListPlannableProducts , который описывает доступные поверхности для продукта.
• Добавлено новое перечисление ReachPlanSurface .
• Добавлена ​​поддержка таргетинга на целевую частоту с помощью AdvancedProductTargeting.target_frequency_settings Frequency_settings , который возвращает PlannedProductForecast.average_frequency .
• Добавлен 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 , который рекомендует установить целевую цену за конверсию для кампаний, для которых она не указана, до наступления сезонного события, которое, по прогнозам, приведет к увеличению трафика.
  • SET_TARGET_CPA , который рекомендует установить целевую цену за конверсию для кампаний, для которых она не указана.
  • SET_TARGET_ROAS , который рекомендует установить целевую рентабельность инвестиций в рекламу для кампаний, для которых она не указана.

Составление отчетов

• Добавлены следующие новые показатели, которые можно запросить с помощью campaign (доступно для кампаний в контекстно-медийной сети, видео, Discovery и кампаний для приложений) и segments.device :
  • metrics.unique_users
  • metrics.average_impression_frequency_per_user

Покупка

• Удален ShoppingSetting.sales_country , значения которого теперь возвращаются как ShoppingSetting.feed_label .
  • Вы можете продолжать использовать определенный фид Merchant Center для кампании, используя поле ShoppingSetting.feed_label . В качестве значения должно быть установлено значение метки фида или двухбуквенный код страны, ранее использовавшийся для ShoppingSetting.sales_country . Более подробную информацию можно найти в статье поддержки ярлыков фидов .
• Убрана зависимость категорий товаров от кода страны в отчетности. Набор поддерживаемых идентификаторов категорий не изменился.
  • Заменены следующие поля, используемые в shopping_performance_view :
    • segments.product_bidding_category_level1 с segments.product_category_level1
    • segments.product_bidding_category_level2 с segments.product_category_level2
    • segments.product_bidding_category_level3 с segments.product_category_level3
    • segments.product_bidding_category_level4 с segments.product_category_level4
    • segments.product_bidding_category_level5 с segments.product_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 .

Архивированные примечания к выпуску

Архивные примечания к выпуску см. в разделе «Устаревшие версии» .