Переход с 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 Рекламы и различается в зависимости от варианта использования.
Шифрование Поддерживает шифрование. Не поддерживается.
Токен разработчика Необязательно Обязательно.
Поддержка загрузки атрибутов сеансов и 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 Рекламе.

    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. Вы можете пересчитать ценность конверсии, но количество конверсий останется прежним.

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

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