Добавление метки в ссылку объявлений

Используется утилита cURL.

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

Для использования примеров укажите во входных данных OAuth-токен, идентификаторы объявлений и ключевых фраз и отредактируйте ссылки. При запросе от имени агентства необходимо также указать логин клиента.

Изменение параметров ключевых фраз

curl \
  -H 'Authorization: Bearer ТОКЕН' \
  -H 'Client-Login: ЛОГИН_КЛИЕНТА' \
  -d '{ "method": "update",
  "params": {
    "Keywords": [{
      "Id": ИДЕНТИФИКАТОР_ФРАЗЫ_1,
      "UserParam1": "ЗНАЧЕНИЕ_1"
    },
    {
      "Id": ИДЕНТИФИКАТОР_ФРАЗЫ_2,
      "UserParam1": "ЗНАЧЕНИЕ_2"
    }]
  }
}' https://api.direct.yandex.com/json/v5/keywords

Добавление параметра в ссылку объявления

curl \
  -H 'Authorization: Bearer ТОКЕН' \
  -H 'Client-Login: ЛОГИН_КЛИЕНТА' \
  -d '{ "method": "update",
  "params": {
    "Ads": [{
      "Id": ИДЕНТИФИКАТОР_ОБЪЯВЛЕНИЯ_1,
      "TextAd": {
        "Href": "https://www.site.com/1/?utm_source=yandex-direct&utm_term={param1}"
      }
    },
    {  
      "Id": ИДЕНТИФИКАТОР_ОБЪЯВЛЕНИЯ_2,
      "TextAd": {
        "Href": "https://www.site.com/2/?utm_source=yandex-direct&utm_term={param1}"
      }
    }]   
  }
}' https://api.direct.yandex.com/json/v5/ads

Результат: в объявлении 1 ссылка будет вести на страницу https://www.site.com/1/?utm_source=yandex-direct&utm_term=ЗНАЧЕНИЕ_1 при показе по ключевой фразе 1, на страницу https://www.site.com/1/?utm_source=yandex-direct&utm_term=ЗНАЧЕНИЕ_2 при показе по ключевой фразе 2.