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

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

04.11.2026, версия 1.9

  • Добавлена поддержка отправки звонков-конверсий Google Рекламы.

    • В Event добавлено поле call_info. Используйте поле start_timestamp объекта CallInfo, чтобы указать, когда начался телефонный звонок, который привел к конверсии.

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

  • В ErrorCount и WarningCount добавлено поле record_indices, чтобы можно было определить, какие записи в запросе на передачу данных вызвали ошибки или предупреждения при обработке. Подробнее о том, как использовать это поле…

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

  • В перечисление ErrorReason добавлены следующие причины ошибок: ENCRYPTION_NOT_SUPPORTED, DUPLICATE_ELEMENTS, UNSUPPORTED_BASELINE_LOCATION, CONVERSION_PRECEDES_CALL, INVALID_AD_IDENTIFIER_FOR_ACCOUNT, CONVERSION_ACTION_TOO_RECENTLY_CREATED, REQUEST_TOO_OLD и INVALID_DATE.

  • В перечисление ProcessingErrorReason добавлены следующие причины ошибок: PROCESSING_ERROR_REASON_DESTINATION_TOO_RECENTLY_CREATED, PROCESSING_ERROR_REASON_TOO_RECENT_CALL, PROCESSING_ERROR_REASON_EXPIRED_CALL и PROCESSING_ERROR_REASON_INVALID_CALL.

  • В перечисление ProcessingWarningReason добавлены причины предупреждений PROCESSING_WARNING_REASON_CUSTOM_VARIABLE_NOT_ENABLED и PROCESSING_WARNING_REASON_CUSTOM_VARIABLE_NOT_PREDEFINED.

  • В перечисление WarningReason добавлена причина предупреждения WARNING_REASON_INVALID_NUMBER_FORMAT.

30.07.2026, версия 1.8

  • Добавлен метод RemoveAllAudienceMembers для IngestionService, позволяющий удалять или заменять всех участников аудитории для указанных списков пользователей.
    • Чтобы начать, ознакомьтесь с руководством по удалению всех участников из аудитории для вашей интеграции. Например, ознакомьтесь с руководствами по спискам электронных адресов для 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

07.05.2026, версия 1.6

  • Добавлена поддержка отправки конверсий типа "Продажи в магазине" в Google Рекламе с помощью IngestEventsRequest. Чтобы использовать эту функцию, ваш аккаунт Google Рекламы должен соответствовать определенным требованиям.
  • Добавлена поддержка отправки в Google Аналитику любых событий на сайте или в приложении, которые не являются зарезервированными.
  • Добавлена поддержка отправки любого события с идентификатором транзакции в потоки данных сайта и приложения в качестве дополнительного источника данных для реализаций тега или 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

17.02.2026, версия 1.5

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

2026-02-10

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

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

5 ноября 2025 г., версия 1.4

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

    • В перечисление AccountType добавлено значение GOOGLE_ANALYTICS_PROPERTY.
    • В Event добавлено несколько полей:
      • event_name
      • client_id
      • user_id
      • additional_event_parameters
    • Добавлено additional_user_properties в UserProperties.

    Подробнее о том, как отправлять события Google Аналитики purchase и сопоставлять параметры событий и свойства пользователей 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 по-прежнему требуется при отправке офлайн-конверсий в качестве дополнительного источника данных для повышения эффективности и надежности данных.

6 августа 2025 г., версия 1.2

25.06.2025, версия 1.1

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

2025-04-02 v1.0