---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://yandex.com/dev/direct/doc/en/curl-ads-keywords-modify.md
  - https://yandex.com/dev/direct/doc/ru/curl-ads-keywords-modify.md
  - href: ru/curl-ads-keywords-modify.md
    type: text/markdown
    title: Markdown version
  - href: llms.txt
    type: text/markdown
    title: llms.txt
sourcePath: ru/examples/curl-ads-keywords-modify.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/direct/doc/ru/llms.txt

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

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

Пример демонстрирует передачу произвольных меток в ссылке объявления. Значения метки указываются в параметре `UserParam1` ключевых фраз с помощью метода [Keywords](https://yandex.ru/dev/direct/doc/ref-v5/keywords/keywords.html).[update](https://yandex.ru/dev/direct/doc/ref-v5/keywords/update.html), метка добавляется в ссылку объявления с помощью метода [Ads](https://yandex.ru/dev/direct/doc/ref-v5/ads/ads.html).[update](https://yandex.ru/dev/direct/doc/ref-v5/ads/update.html). Таким способом можно передавать, например, идентификаторы ключевых фраз в вашей внутренней системе или другие атрибуты, позволяющие отслеживать эффективность продвижения.

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

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

```bash translate=no
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/v501/keywords
```

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

```bash translate=no
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/v501/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.

<!-- source: ru/_includes/curl-bids/id-curl-bids/curl-win.md -->
{% note info %}

Для cURL в ОС Windows нужно заменить все кавычки на двойные, а в JSON-коде экранировать двойные кавычки, например: `-d "{\"method\"`...

{% endnote %}
<!-- endsource: ru/_includes/curl-bids/id-curl-bids/curl-win.md -->