# Яндекс Директ

Контекстная реклама — кампании, объявления, ключевые слова, ставки и аналитика

## Scenarios

### Spend and conversions by campaign
The agent pulls a report on impressions, clicks, CTR, spend and conversions for the period and shows which campaigns pay off and which just burn budget.

### Keywords that bring nothing back
The agent breaks down stats by ad group and keyword, finds queries with spend and zero conversions and shows where the bid should come down.

### Bids and budget stoppages
The agent checks keyword bids, campaign state and moderation status and names the ones stalled by a daily budget cap or by rejected ads.

### Daily spend digest
The agent posts yesterday's spend in chat, compares it with last week and names the campaigns whose CTR slipped or whose cost per conversion went up.

## How to connect

### Pick a Yandex login registered in Direct
The API only admits a business representative, an agency, or an agency client the agency has granted access to. Decide which login to use and sign out of your other Yandex accounts in the browser.

### Make sure the campaigns sit on that same login
The agent works with the campaigns of the login that confirmed access. Client campaigns under an agency login won't show up: Direct requires the Client-Login header with the advertiser's login, which we don't ask for.

### Check your rights if an agency runs the campaigns
Web interface rights carry over to the API as is: with read-only access the agent can only fetch data and won't change bids or statuses. The right to edit campaigns is granted by the agency.

### Accept the terms on the API Settings page
API use requires accepting the terms of the agreement on the API Settings page. On its Parameters tab check the allowed IP list: if it is filled in, Direct rejects requests coming from any other address.

## FAQ

### How do I connect Yandex Direct?
By signing in to your Yandex account: you confirm a code on a Yandex page, with no tokens to copy. Sign in with the login that owns the campaigns — client campaigns under an agency login will not be pulled in. The agreement terms are accepted on the API Settings page.

### What does the agent see in Direct?
Campaigns, ad groups, ads, keywords with bids, negative keywords, region reference books and API v5 reports — for the advertiser whose login authorized access.

### Can the agent change bids and campaigns?
Yes, if the login has edit rights: the agent pauses and resumes campaigns and sets keyword bids and adjustments. Permissions carry over from the web interface one to one, and with read-only access you still get the analytics.

### What about Direct API limits?
Direct counts Units and holds a daily quota per advertiser, and it allows no more than five parallel requests. The agent paginates through selections and orders heavy reports in offline mode, waiting until they are ready.

[Open Яндекс Директ](https://direct.yandex.ru)