Yandex Direct Connector
Sync advertising campaigns and performance data from Yandex Direct into your knowledge base
The Yandex Direct connector synchronizes advertising campaigns, keywords, ads, and performance metrics from Yandex Direct into your knowledge base. Each campaign is converted to a document containing targeting, budget, and performance data.
Authentication
OAuth 2.0 — requires:
- Yandex Direct account access
campaign:read— Read campaign datareport:read— Read performance reports
Configuration
| Field | Type | Required | Description |
|---|---|---|---|
| Account | Selector | Yes | Select Yandex Direct account |
| Campaign Status | Dropdown | No | Filter by status (active/paused/archived) |
| Date Range | Date Picker | No | Sync performance metrics from date range |
| Include Keywords | Switch | No | Include keyword details and bids |
How It Works
- Account Validation — Verifies OAuth access to Yandex Direct account
- Campaign Listing — Retrieves campaigns with metadata
- Performance Fetching — Downloads metrics for date range
- Document Generation — Campaigns become searchable documents
Document Format
Campaign: Summer Sale 2026
Status: Active
Budget: 100,000 RUB
Impressions: 567,890
Clicks: 23,456
CTR: 4.13%
Conversions: 1,234
CPC: 4.26 RUB
ROI: 245%Metadata Tags
| Tag | Type | Description |
|---|---|---|
| Campaign ID | Text | Yandex Direct campaign ID |
| Status | Category | Active, Paused, Archived |
| Campaign Type | Category | Search, Display, Mobile |
Pagination
Uses campaign ID offset. Cursor format: offset:{campaign_id}.
Limitations
- Performance data updated with 24-hour delay
- Archived campaigns available for 2 years
- Keywords billing history kept for 90 days