Предыдущий API отчетов Search Ads 360 прекращает свою работу и будет выведен из эксплуатации 30 июня 2024 года. Обратите внимание, что API Search Ads 360 Conversion API не затрагивается и будет по-прежнему поддерживаться. Все новые разработки отчетов должны использовать новый API отчетов Search Ads 360 , который теперь доступен в виде открытой бета-версии. Мы также настоятельно рекомендуем вам приступить к планированию переноса всех существующих реализаций Поисковой рекламы 360 на новый API. Дополнительную информацию см. в новом Руководстве по началу работы и миграции API отчетов Search Ads 360.

Загрузить данные о конверсиях

Когда клиент выполняет определенное действие на веб-сайте рекламодателя, например покупает товар или запрашивает дополнительную информацию, Поисковая реклама 360 регистрирует конверсию .

Конверсии для некоторых рекламодателей начинаются онлайн и заканчиваются офлайн. Например, потребитель инициирует поиск в Интернете для покупки, нажимает на рекламу, а затем звонит в колл-центр, чтобы совершить покупку. Или потребитель со смартфоном нажимает кнопку «Позвонить сейчас» в рекламе и покупает товар по телефону. Для этих конверсий Поисковая реклама 360 автоматически получит данные об онлайн-части. Если вы хотите предоставить данные об автономной части — для улучшения отчетов, для использования в автоматических правилах или для оптимизации в стратегии назначения ставок — вы можете загрузить их в Поисковая реклама 360.

В некоторых случаях может потребоваться изменить ценность существующей конверсии. Например, вы можете изменить значение конверсии, чтобы учесть скидки, которые были применены после совершения онлайн-покупки (например, скидка по почте), возвраты, которые произошли с комиссией за пополнение запасов, или кредиты, которые были применены после покупки.

После того как вы настроите свое клиентское приложение, как описано в разделе «Мое первое приложение » (включая активацию службы конверсии ), вы сможете отправлять следующие запросы, связанные с конверсиями, в API Search Ads 360:

Получать

Возвращает конверсии, соответствующие указанным вами критериям.

Вставлять

Добавляет новые конверсии.

Обновлять

Изменяет существующие преобразования.

Синхронные запросы

Все запросы на конвертацию синхронны. Вы можете делать параллельные синхронные запросы (до предела вашего проекта) в одном клиенте.

Идентификаторы и конверсии Поисковой рекламы 360

Поскольку конверсии необходимо отнести к определенной кампании, объявлению, ключевому слову и, при необходимости, к посещению, для каждой конверсии указывается идентификатор Search Ads 360 для объявления, ключевого слова и кампании, а также идентификаторы родительских объектов в Search Ads. 360 иерархия . Когда вы получаете, добавляете или обновляете конверсию, вам нужно указать большинство этих идентификаторов в запросе.

Получение идентификаторов Поисковой рекламы 360

Чтобы найти эти идентификаторы, выполните одно из следующих действий:

  • Используйте пользовательский интерфейс Search Ads 360, чтобы загрузить отчет , содержащий идентификаторы рекламодателя, системных учетных записей, кампаний, групп объявлений, ключевых слов и объявлений.

  • Добавьте макросы Поисковой рекламы 360, такие как CampaignID и TrackerID в URL целевых страниц. Когда клиент нажимает на объявление, каждый макрос будет указывать Поисковой рекламе 360 передавать свой идентификатор на целевую страницу рекламодателя в качестве параметра URL. Вы можете получить эти идентификаторы из веб-журналов рекламодателя и использовать их в своих запросах Conversion .

    Поисковая реклама 360 предоставляет несколько различных макросов для отправки идентификаторов ключевых слов на целевую страницу. Чтобы связать конверсии с ключевым словом, вам нужно добавить макрос TrackerID к URL-адресам целевых страниц.

Идентификаторы кликов

Идентификатор клика отслеживает клик по объявлению, и вы можете использовать его, чтобы связать конверсию с конкретным посещением, вместо предоставления всей иерархии идентификаторов для объектов Search Ads 360. Поисковая реклама 360 будет использовать идентификатор клика, чтобы найти и атрибутировать подходящее ключевое слово и объявление.

Идентификаторы кликов чувствительны к регистру, поэтому убедитесь, что ваши веб-журналы и программное обеспечение для отслеживания не меняют регистр идентификатора клика .

Создание идентификатора клика

Идентификатор клика создается либо Поисковой рекламой 360, либо Google Рекламой.

Если в аккаунте Google Ads включена автоматическая пометка , Google Ads генерирует идентификатор клика при показе объявления. В результате, если пользователь нажимает на определенный показ объявления несколько раз, эти клики будут связаны только с одним идентификатором клика. Посещения целевой страницы для одного и того же показа будут иметь один и тот же идентификатор клика.

Поисковая реклама 360 может генерировать идентификатор клика, если вы активируете службу API конверсии . Если клик перенаправляется из Google Ads, а Google Ads уже сгенерировал идентификатор клика, Search Ads 360 использует идентификатор Google Ads вместо создания нового. Если клик перенаправляется с другого типа поддерживаемой системы, Поисковая реклама 360 создает идентификатор.

Параметры идентификатора клика

Каждый идентификатор клика состоит из двух параметров. Например:

gclid=CJjsqefUkAJSHDJ_gPdDiEAAA&gclsrc=ds

Параметр gclid содержит идентификатор клика с учетом регистра. Поисковая реклама 360 поддерживает информацию об атрибуции (например, ключевое слово, объявление, кампанию, группу объявлений) для каждого сгенерированного идентификатора клика.

Параметр gclsrc указывает источник идентификатора клика. В настоящее время он может принимать одно из следующих значений:

  • gclsrc=ds : идентификатор клика был сгенерирован Поисковой рекламой 360. Кроме того, клик был либо в системе, отличной от Google, либо в Google, но в аккаунте Google Реклама не используется автоматическая пометка.

  • gclsrc=aw.ds : идентификатор клика был сгенерирован Google Ads, использующим автоматическую пометку, и клик прошел через сервер кликов Search Ads 360.

  • gclsrc= : параметр пуст, если идентификатор клика был сгенерирован Google Ads, но служба API конверсии не была включена в Search Ads 360, когда произошел клик.