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

Здесь вы можете узнать, что изменилось в каждом выпуске Data Manager API.

30.07.2026, версия 1.8

• В IngestionService добавлен метод RemoveAllAudienceMembers, позволяющий удалять или заменять всех участников аудитории для указанных списков пользователей.
  • Чтобы начать, ознакомьтесь с руководством по удалению всех участников из аудитории для вашей интеграции. Например, ознакомьтесь с руководствами по спискам электронных адресов для Google Рекламы или Дисплея и Видео 360.
• Добавлена поддержка возврата подробных предупреждений при передаче событий и аудиторий.
  • В IngestEventsResponse и IngestAudienceMembersResponse добавлено поле field_warnings, содержащее список объектов FieldWarning.
  • Добавлен ресурс FieldWarning, который содержит reason (WarningReason), description и путь field.
  • Добавлено перечисление WarningReason, определяющее причины предупреждений, например пользовательские переменные не включены или в данных корзины отсутствуют идентификаторы продавцов.
• Добавлена поддержка отправки дополнительных полей адреса для передачи событий в Google Аналитику.
  • В AddressInfo (используется в UserData) добавлены поля address_line, city и administrative_area.
• В перечисление ErrorReason добавлены причины ошибок INVALID_REMOVE_AS_OF_TIME и REQUIRED_PREREQUISITE_LINK_MISSING.

28.05.2026, версия 1.7

• Добавлена поддержка отправки событий-конверсий в офлайне в продукты Google Платформы для маркетинга, включая Менеджер кампаний 360, Поисковую рекламу 360 и Дисплей и Видео 360, с помощью IngestEventsRequest.

  • В перечисление AccountType добавлено значение FLOODLIGHT_CONFIG для поддержки целевых сервисов Floodlight.
  • В AdIdentifiers добавлены поля dclid, impression_id, match_id и encrypted_user_ids.
  • В ресурс Event добавлено поле conversion_count, чтобы можно было отслеживать количество конверсий.

  Чтобы начать работу, ознакомьтесь с руководством по отправке событий или узнайте, как перейти с API Менеджера кампаний 360.

• В ресурс AudienceMember добавлено поле composite_data, которое принимает объект CompositeData и позволяет комбинировать несколько типов идентификаторов, например UserData и IpData. Подробнее о составных данных…

  • Добавлены новые статусы IngestCompositeDataStatus и RemoveCompositeDataStatus, которые включают диагностику (record_count и data_type_counts) для запросов участников аудитории, использующих CompositeData.

• Добавлена поддержка передачи IP-адресов для списков электронных адресов Google Рекламы путем отправки IpData в составных данных.

• В перечисление ErrorReason добавлены новые причины ошибок: FIELD_VALUE_TOO_SHORT, TOO_FEW_ELEMENTS, BASELINE_LOCATION_AUTO_DETECTION_FAILED и INSIGHTS_MISSING_FOR_DIMENSION.

• В ProcessingErrorReason добавлены новые значения диагностики, чтобы предоставлять более подробную информацию о сбоях при получении событий.

07.05.2026, версия 1.6

• Добавлена поддержка отправки конверсий типа "Продажи в магазине" в Google Рекламе с помощью IngestEventsRequest. Чтобы использовать эту функцию, ваш аккаунт Google Рекламы должен соответствовать определенным требованиям.
  • В сообщение Event добавлено поле event_location, в котором можно указывать физический store_id..
  • В файл Event добавлено поле third_party_user_data, позволяющее явно помечать загруженные данные как принадлежащие третьей стороне.
    • Заполнять это поле могут только партнеры по обработке данных.
  • В ресурс Item добавлены следующие поля:
    • merchant_id
    • merchant_feed_label
    • merchant_feed_language_code
    • conversion_value
    • custom_variables (принимает список объектов ItemCustomVariable)
  • Чтобы начать работу, ознакомьтесь со следующими руководствами:
    • Как преобразовать кампании в Google Рекламе
    • Как отправлять события
• Добавлена поддержка отправки в Google Аналитику любых событий на сайте или в приложении, которые не являются зарезервированными.
  • В ресурс Event добавлено поле app_instance_id.
  • В DeviceInfo добавлены поля для метаданных об устройстве пользователя.
  • В AdIdentifiers добавлено поле mobile_device_id.
  • В Event добавлено поле event_location, чтобы собирать данные из полей city, subdivision_code, region_code, subcontinent_code и continent_code.
  • Чтобы начать работу, ознакомьтесь со следующими руководствами:
    • Как отправлять рекомендуемые и специальные события
    • Как перейти с Measurement Protocol
    • Рекомендуемые события
• Добавлена поддержка отправки любого события с идентификатором транзакции в потоки данных сайта и приложения в качестве дополнительного источника данных для тега или Google Analytics for Firebase (GA4F) SDK.
  • Эта функция доступна только для ресурсов Google Аналитики, включенных в белый список. Если вы хотите добавить в него свой ресурс, заполните эту форму.
• В CartData добавлено поле coupon_codes, чтобы отслеживать все промокоды, примененные к корзине, для событий, отправляемых в Google Рекламу и Google Аналитику.
  • Для использования купонов в Google Рекламе выберите тип конверсии OFFLINE_PROMOTION_REDEMPTION.
• Добавлена новая область действия OAuth https://www.googleapis.com/auth/datamanager.partnerlink для методов, связанных с созданием, поиском и удалением связей с партнерами.
• В перечисление ErrorReason добавлены новые значения, чтобы поддерживать подробную проверку продаж в магазине и загрузки событий Google Аналитики.
• В ресурс SizeInfo добавлены поля youtube_members_count и gmail_members_count.

2026-03-26

• В перечисление ErrorReason добавлено значение EU_POLITICAL_ADVERTISING_DECLARATION_REQUIRED.

  Чтобы соблюдать регламент Европейского союза о политической рекламе (EU PAR), Google требует от всех клиентов самостоятельно декларировать, считается ли их реклама политической в соответствии с EU PAR. Подробнее о том, как определяется политическая реклама для ЕС и какие ограничения для нее существуют в Google…

  С 1 апреля 2026 г. в аккаунтах, где нет такой декларации, могут быть ограничены или не выполняться с ошибкой EU_POLITICAL_ADVERTISING_DECLARATION_REQUIRED следующие операции:

  • UserListService (create, update и delete)
  • IngestionService (ingestAudienceMembers)

  Чтобы устранить ошибку, рекламодатели должны предоставить обязательное заявление в интерфейсе Google Рекламы. Подробнее о том, как подтвердить заявление для аккаунта…

• В перечисление ErrorReason добавлено значение INVALID_MERCHANT_ID.

17.02.2026, версия 1.5

Теперь Data Manager API поддерживает весь рабочий процесс управления аудиториями, включая их создание, загрузку и получение.

• Добавлены ресурс UserList и сервис UserListService, позволяющие создавать, получать, обновлять и удалять списки пользователей.
  • В руководствах по Google Рекламе и Дисплею и Видео 360 вы найдете пошаговые инструкции по созданию, заполнению и проверке аудиторий на основе списков электронных адресов с помощью Data Manager API.
  • Инструкции по переходу вы найдете в руководствах по обновлению для Google Рекламы и Дисплея и Видео 360.
• Добавлена поддержка отправки идентификаторов пользователей при загрузке участников аудитории, что позволяет использовать их со списками электронных адресов в Google Рекламе.
  • Пользователь UserIdData добавлен в группу AudienceMember.
  • В список статусов, возвращаемых методом RetrieveRequestStatus, добавлены IngestUserIdDataStatus и RemoveUserIdDataStatus. Эти поля позволяют получать диагностическую информацию о добавлении и удалении идентификаторов пользователей.
• Добавлен ресурс PartnerLink и PartnerLinkService для создания связей между аккаунтами рекламодателя и партнера по обработке данных и управления ими.
  • Ознакомьтесь с руководствами по ссылкам на партнеров.

2026-02-10

Теперь во всех аккаунтах Google Рекламы можно отправлять конверсии с несколькими источниками данных, чтобы повысить эффективность и качество данных.

Эта функция по-прежнему доступна только для ресурсов Google Аналитики, добавленных в белый список. Если вы хотите добавить свой ресурс Google Аналитики в белый список, заполните форму.

05.11.2025, версия 1.4

• Добавлена поддержка отправки событий Google Аналитики purchase в качестве дополнительного источника данных для конверсий тега, чтобы максимизировать сигналы о взаимодействии с объявлениями и улучшить данные и общую эффективность.

  • В перечисление AccountType добавлено значение GOOGLE_ANALYTICS_PROPERTY.
  • В Event добавлены следующие поля:
    • event_name
    • client_id
    • user_id
    • additional_event_parameters
  • Добавлено additional_user_properties в UserProperties.

  Подробнее о том, как отправлять события purchase в Google Аналитику и сопоставлять параметры событий и свойства пользователей Google Аналитики с их эквивалентами в Data Manager API, рассказывается в руководстве по событиям.

• Добавлена поддержка AwsWrappedKeyInfo для использования ключей шифрования из AWS Key Management Service.

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

  • EVENT_TIME_INVALID
  • FIELD_VALUE_TOO_LONG
  • INVALID_EVENT_NAME
  • INVALID_PROPERTY_TYPE
  • INVALID_REQUEST_ID
  • INVALID_STREAM_TYPE
  • LINKED_ACCOUNT_ONLY_ALLOWED_WITH_DATA_PARTNER_LOGIN_ACCOUNT
  • MULTIPLE_DESTINATIONS_FOR_GOOGLE_ANALYTICS_EVENT
  • NOT_ALLOWLISTED
  • OPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCH
  • RESERVED_NAME_USED
  • TOO_MANY_ELEMENTS
  • UNSUPPORTED_LINKED_ACCOUNT_FOR_DATA_PARTNER
  • UNSUPPORTED_OPERATING_ACCOUNT_FOR_DATA_PARTNER

06.10.2025, версия 1.3

• Data Manager API теперь доступен всем пользователям.

  Отправка конверсий с несколькими источниками данных для повышения эффективности и надежности данных по-прежнему доступна только для аккаунтов из белого списка. Если вы хотите добавить свой аккаунт, заполните форму.

  Заполните форму для потенциальных партнеров по обработке данных.

• Добавлен метод RetrieveRequestStatus для получения диагностической информации о запросах на передачу данных о событиях и аудиториях.

• Поле product в ProductAccount и перечисление Product больше не поддерживаются. Используйте вместо него поле account_type и новое перечисление AccountType.

• Добавлена поддержка указания destination для каждого AudienceMember в IngestAudienceMembersRequest. Эта функция позволяет отправлять данные об аудитории в несколько разных целевых сервисов в рамках одного запроса.

• Аудитории, загруженные с помощью API, теперь можно использовать для таргетинга, если в них есть хотя бы 100 участников. Ранее пороговое значение составляло 1000 участников.

• Теперь при отправке офлайн-конверсий или расширенных конверсий потенциальных клиентов указывать transaction_id Event необязательно. transaction_id по-прежнему требуется при отправке офлайн-конверсий в качестве дополнительного источника данных для повышения эффективности и надежности данных.

06.08.2025, версия 1.2

• Добавлена поддержка отправки офлайн-конверсий и расширенного отслеживания конверсий потенциальных клиентов в целевые сервисы Google Рекламы с помощью метода IngestEvents. Инструкции по настройке шифрования для таких конверсий приведены в обновленном руководстве.
• В перечисление EventSource добавлены значения APP, IN_STORE, PHONE и OTHER. Для офлайн-конверсий и расширенного отслеживания конверсий лидов требуется event_source.
• В Event добавлено поле user_properties. Задайте для этого поля объект UserProperties, чтобы добавить оцененную рекламодателем информацию о пользователе на момент события.
• В CustomVariable добавлено повторяющееся поле destination_references. Используйте это поле, чтобы применить значение пользовательской переменной только к подмножеству целевых страниц для Event.
• Добавлены следующие ошибки для офлайн-конверсий и расширенного отслеживания конверсий потенциальных клиентов:
  • DESTINATION_ACCOUNT_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS
  • DESTINATION_ACCOUNT_DATA_POLICY_PROHIBITS_ENHANCED_CONVERSIONS
  • DESTINATION_ACCOUNT_ENHANCED_CONVERSIONS_TERMS_NOT_SIGNED

25.06.2025, версия 1.1

• В IngestionService добавлен метод IngestEvents. Используйте IngestEvents как дополнительный источник данных для конверсий тега, чтобы получать больше сигналов о взаимодействиях с объявлениями и повышать эффективность рекламы.

2025-04-02 v1.0

• Первый выпуск Data Manager API с поддержкой отправки данных об аудитории в Google Рекламу и Дисплей и Видео 360.
• Добавлена поддержка gRPC и REST.
• Добавлен сервис IngestionService с методами IngestAudienceMembers и RemoveAudienceMembers для управления участниками аудитории с использованием следующих типов данных:
  • Контактная информация
  • Электронные удостоверения личности
  • Идентификаторы PAIR
• Аудитории, управляемые с помощью Data Manager API, можно использовать для таргетинга, только если в них не менее 1000 участников.