Новая Поисковая реклама 360

Новая Search Ads 360 назначает новые идентификаторы учетным записям пользователей, кампаниям, группам объявлений, ключевым словам (критериям) и объявлениям. Для этих идентификаторов есть два дополнительных изменения в поведении:

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

  • Новая Search Ads 360 больше не присваивает уникальные идентификаторы ключевым словам и объявлениям.

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

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

Получение списка конверсий

Для запроса списка появилась новая конечная точка с новым идентификатором Search Ads 360. Вам необходимо предоставить идентификатор клиента учетной записи клиента. Также вы по-прежнему можете указать идентификатор кампании и идентификатор группы объявлений, которые будут указаны в параметрах запроса. И endDate , rowCount , startDate и startRow по-прежнему необходимы.

HTTP-запрос

GET https://www.googleapis.com/doubleclicksearch/v2/customer/customerId/conversion

Вставить/обновить преобразование

Мы поддерживаем следующий запрос с использованием нового идентификатора Search Ads 360:

  • Связывание конверсии с ключевым словом и объявлением
  • Связать конверсию только с ключевым словом
  • Обновить конверсию, указав criterionId конверсии (идентификатор ключевого слова).

Конечные точки все те же. Вам следует указать новый идентификатор Search Ads 360 в каждом ресурсе конверсии. Вместо установки agencyId , advertiserId и engineAccountId вы должны указать customerId и при необходимости использовать новый идентификатор Search Ads 360 в campaignId , adGroupId , criterionId , adId .

Ниже приведен пример запроса на использование нового идентификатора Search Ads 360 для привязки конверсии к ключевому слову.

POST  https://www.googleapis.com/doubleclicksearch/v2/conversion
{
  "conversion" : [
    {
      "customerId": "123-123-1234"
      "campaignId": "10000001",
      "adGroupId": "20000001",
      "criterionId": "30000001",
      "conversionId": "floodlight conversion ID 1",
      "conversionTimestamp": "1660799917714",
      "type": "ACTION",
      "quantityMillis": "1000",
      "segmentationType": "FLOODLIGHT",
      "segmentationName": "Test"
    }
  ]
}

Уточните наличие

Вы также можете использовать новый идентификатор Search Ads 360 в методе Conversion.updateAvailability() . Вы должны использовать идентификатор клиента подчиненного менеджера. Вот пример:

POST  https://www.googleapis.com/doubleclicksearch/v2/conversion/updateAvailability
{
  "availabilities": [
    {
      "customerId": "123-123-1234"
      "segmentationType": "FLOODLIGHT",
      "segmentationName": "Test",
      "availabilityTimestamp": "1389348800000"
    }
  ]
}