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

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

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