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

v17.1.0 (07.08.2024)

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

Ресурсы

• AdGroupAdService.RemoveAutomaticallyCreatedAssets() позволяет удалить указанные автоматически созданные объекты, связанные с адаптивными поисковыми объявлениями .

Аудитории

• Новые значения перечисления в UserListCustomerTypeCategory :
  • 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-адресов в ответе.
  • В случае возникновения ошибки метод вернет partial_failure_error вместо URL-адресов.

История изменений

• Новый тип ресурса статуса изменения: 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

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

• AudienceInsights.GenerateAudienceOverlapInsights() который принимает входной основной атрибут и набор атрибутов аудитории и возвращает оценки перекрытия потенциального охвата YouTube между основным атрибутом и атрибутами аудитории.

Отчетность

• Поддержка сегментации per_store_view на основе segments.date

Видео

• Поддержка получения информации, связанной со следующими стандартными стратегиями назначения ставок для видеокампаний, с использованием отчетов, например ad_group , campaign :
  • Campaign.fixed_cpm (Фиксированная цена за тысячу показов (стоимость за тысячу показов))
  • Campaign.target_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 (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 .

v16 (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. ## Архивированные примечания к выпуску

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