Эта страница переведена с помощью Cloud Translation API.

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

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

2026-05-07 v1.6

Добавлена поддержка отправки данных о конверсиях продаж в магазине Google Ads с помощью запроса IngestEventsRequest . Для использования этой функции ваш аккаунт Google Ads должен соответствовать определенным требованиям .
- В 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 Ads на Google Ads.
  - Отправить события
Добавлена поддержка отправки в Google Analytics любых событий веб-сайта или приложения, за исключением зарезервированных событий .
- В ресурс Event добавлено поле app_instance_id .
- В DeviceInfo добавлены поля для предоставления метаданных об устройстве пользователя.
- В поле AdIdentifiers добавлено поле mobile_device_id .
- Добавлено поле event_location в Event для захвата таких полей, как city , subdivision_code , region_code , subcontinent_code и continent_code .
- Для начала ознакомьтесь со следующими руководствами:
Добавлена поддержка отправки любого события с идентификатором транзакции как в потоки данных веб-приложения, так и в потоки данных приложения в качестве дополнительного источника данных для ваших тегов или реализаций SDK Google Analytics for Firebase (GA4F) .
- Эта функция доступна только для ресурсов Google Analytics, включенных в список разрешенных; заполните эту форму, если вы хотите добавить свой ресурс в этот список.
Добавлено поле coupon_codes в CartData для отслеживания всех промокодов, примененных к корзине для событий, отправляемых в Google Ads и Google Analytics.
- Для использования купонов в Google Ads используйте тип конверсии OFFLINE_PROMOTION_REDEMPTION .
Добавлена новая область действия OAuth, https://www.googleapis.com/auth/datamanager.partnerlink , для методов, связанных с созданием, поиском и удалением партнерских ссылок.
В перечисление ErrorReason добавлены новые значения для поддержки детальной проверки данных о продажах в магазине и обработки событий Google Analytics.
В ресурс 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 Ads. Узнайте больше о том, как подтвердить это для своего аккаунта .
В перечисление ErrorReason добавлено значение INVALID_MERCHANT_ID .

2026-02-17 v1.5

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

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

2026-02-10

Теперь для всех аккаунтов Google Ads доступна функция отправки данных о конверсиях из нескольких источников для повышения производительности и надежности данных.

Эта функция пока доступна только для ресурсов Google Analytics, включенных в список разрешенных. Заполните форму, если вы хотите добавить свой ресурс Google Analytics в этот список.

2025-11-05 v1.4

Добавлена поддержка отправки событий purchase Google Analytics в качестве дополнительного источника данных для конверсий по тегам, чтобы максимизировать сигналы взаимодействия с рекламой и улучшить ваши данные и общую производительность.
- В перечисление AccountType добавлено свойство GOOGLE_ANALYTICS_PROPERTY .
- В Event добавлено несколько полей:
  - event_name
  - client_id
  - user_id
  - additional_event_parameters
- Добавлено поле additional_user_properties в UserProperties .
Подробнее об отправке событий purchase Google Analytics и о том, как сопоставить параметры событий Google Analytics и свойства пользователей с их эквивалентами в API Data Manager, читайте в руководстве по событиям .
Добавлена 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

2025-10-06 v1.3

API менеджера данных теперь доступен всем пользователям.
Функция отправки сообщений о конверсиях с использованием нескольких источников данных для повышения производительности и надежности данных по-прежнему доступна только для учетных записей, включенных в список разрешенных. Заполните форму, если вы хотите добавить свою учетную запись.
Заполните форму заявки на партнерство , чтобы выразить заинтересованность в том, чтобы стать партнером по данным.
Добавлен метод RetrieveRequestStatus для получения диагностической информации по запросам на обработку событий и данных об аудитории.
Поле product объекта ProductAccount и перечисление Product устарели. Вместо них используйте поле account_type и новое перечисление AccountType .
Добавлена поддержка указания destination для каждого AudienceMember в запросе IngestAudienceMembersRequest . Используйте эту функцию для отправки данных об аудитории в несколько разных пунктов назначения в одном запросе.
Теперь аудитории, полученные с помощью API, могут быть использованы для таргетинга, если в них насчитывается не менее 100 участников. Ранее пороговое значение составляло тысячу участников.
Теперь transaction_id Event является необязательным при отправке офлайн-конверсий или расширенных конверсий для лидов. Однако transaction_id по-прежнему необходим при отправке офлайн-конверсий в качестве дополнительного источника данных для повышения производительности и надежности данных.

2025-08-06 v1.2

Добавлена поддержка отправки офлайн-конверсий и улучшенных конверсий лидов на целевые страницы Google Ads с использованием метода IngestEvents . Инструкции по настройке шифрования для этих конверсий см. в обновленном руководстве по шифрованию .
Добавлены значения APP , IN_STORE , PHONE и OTHER в перечисление EventSource . Значение event_source необходимо для офлайн-конверсий и расширенных конверсий для лидов.
Добавлено поле user_properties в Event . Установите для этого поля объект 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

2025-06-25 v1.1

Добавлен метод IngestEvents в класс IngestionService . Используйте IngestEvents в качестве дополнительного источника данных для конверсий по тегам, чтобы максимизировать сигналы взаимодействия с рекламой и улучшить качество данных и общую производительность.

2025-04-02 v1.0

Первый релиз API Data Manager с поддержкой отправки данных об аудитории в Google Ads и Display & Video 360 .
Добавлена поддержка gRPC и REST .
Добавлен класс IngestionService с методами IngestAudienceMembers и RemoveAudienceMembers для управления участниками аудитории с использованием следующих типов данных:
Для таргетирования аудиторий, управляемых с помощью API Data Manager, достаточно, чтобы они насчитывали не менее 1000 участников.

Примечания к выпускам Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.