Обновите API Google Ads.

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

Вот сравнение использования API Data Manager и API Google Ads для управления конверсиями.

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

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

В API Data Manager operating_account целевого объекта должна соответствовать клиенту, совершившему конверсию в Google Ads . Это отличается от API Google Ads.

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

  1. Клиент, заинтересованный в конверсии в Google Ads .

    API менеджера данных поддерживает этот подход.

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

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

Корректировки преобразования

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

В API Google Ads:

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

В API менеджера данных:

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

Для получения более подробной информации см. раздел «Корректировки преобразования» .

Далее
Шаги по обновлению