Переход с Google Ads API

Перейдите с Google Ads API на Data Manager API, чтобы получить доступ к новым функциям и улучшениям.

Ниже приведено сравнение Data Manager API и Google Ads API для управления конверсиями.

Data Manager API Google Ads API
Поддержка отправки офлайн-конверсий и расширенного отслеживания конверсий лидов Поддерживается. Поддерживается.
Поддержка отправки конверсий тега Google Рекламы в качестве дополнительного источника данных для конверсий тега, чтобы максимизировать сигналы взаимодействия с объявлениями и улучшить данные и общую эффективность. Поддерживается. Не поддерживается.
Модель данных Единая модель данных для всех вариантов использования конверсий Google Рекламы и всех рекламных продуктов Google. Модель данных предназначена только для Google Рекламы и различается в зависимости от варианта использования.
Шифрование Поддерживает шифрование. Не поддерживается.
Одобрение уровня доступа Необязательно Включив API, вы сможете управлять только тестовыми аккаунтами Google Рекламы. Чтобы управлять рабочими аккаунтами Google Рекламы, вашему проекту Google Cloud нужен доступ уровня Explorer, базовый или стандартный.
Поддержка загрузки атрибутов сеансов и IP-адресов для событий. Доступно всем пользователям API. Доступно только определенным пользователям API.
Корректировка конверсий Поддерживается в унифицированном методе IngestEvents. Требуется отдельный ConversionAdjustmentUploadService.
Квоты и ограничения Квоты и ограничения на количество запросов для проектов. Квоты на основе уровня доступа и ограничения на количество запросов.
Модель ошибки Используется модель быстрого отказа. Используется модель частичного сбоя.

Различия в требованиях к целевому аккаунту

В Data Manager API operating_account целевого сервиса должен быть клиентом конверсий Google Рекламы. В Google Ads API это не так.

Google Ads API поддерживает отправку конверсий для аккаунта Google Рекламы с помощью customer_id одного из следующих объектов:

  1. Клиент конверсии Google Рекламы.

    Data Manager API поддерживает этот подход.

  2. Любой аккаунт, который является родительским или дочерним для клиента, отслеживающего конверсии в Google Рекламе.

    Data Manager API не поддерживает такой подход. Если вы используете это поведение в Google Ads API, измените operating_account каждого целевого аккаунта на владельца действия-конверсии. Это значение может отличаться от значения customer_id, которое вы используете в запросах к Google Ads API.

Корректировка конверсий

Data Manager API объединяет загрузку исходных конверсий и последующие корректировки конверсий в один метод.

В Google Ads API:

  • Для корректировки конверсий необходимо использовать отдельный метод UploadConversionAdjustments в ConversionAdjustmentUploadService.
  • Если вы попытаетесь загрузить несколько конверсий, используя стандартный метод UploadClickConversions для одного и того же действия-конверсии с одинаковым идентификатором транзакции (order_id), запрос не будет выполнен.
  • В запросе необходимо указать ConversionAdjustmentType.

В Data Manager API:

  • Для загрузки и корректировки конверсий используется унифицированная конечная точка IngestEvents.
  • Если вы загрузите событие с существующим значением transaction_id для того же действия-конверсии, но с обновленными значениями конверсии или пользовательскими данными, оно будет автоматически обработано как корректировка. API не вернет ошибку повторяющегося идентификатора транзакции.
  • В запросе не нужно указывать тип корректировки. Data Manager API определяет, как обработать корректировку, на основе полей, указанных в событии.
  • В отличие от Google Ads API, Data Manager API не поддерживает отзыв конверсий, который полностью удаляет ранее зарегистрированную конверсию, устанавливая ее ценность и количество равными 0. Вы можете пересчитать ценность конверсии, но количество конверсий останется прежним.

Подробнее о корректировке конверсий…

Далее
Как перейти на новую версию