Chuyển đến nội dung
Tecrübetecrube.com
Assistant tools · Setup and campaigns

Yandex Direct tools

Yandex Direct accounts, campaigns and performance reports; status and weekly budget changes go through preview and approval and can be undone.

Tool names and descriptions are generated straight from the server code; the descriptions are the original English text the assistant sees.

Read tools4 tools

list_yandex_clients

Đọc1 credits

Yandex Direct accounts reachable through the connected login: an agency's clients, otherwise the connected account itself. Returns login (account_id), name, currency, type and archived flag. Read only; connected=false when Yandex isn't connected.

This tool takes no parameters.

list_yandex_campaigns

Đọc1 credits

Yandex Direct campaigns: id, name, type, state, status, bidding strategy and weekly budget, with spend, impressions, clicks and conversions for the last N days. If the statistics report is still queued, stats stay empty and stats_ready=false. Read only; never invents numbers.

ParameterTypeDescription
account_idOptionalstringYandex login of an agency client (sent as Client-Login); defaults to the connection's selected account or the connected account itself
daysOptionalinteger (1–365)last N days including today, default 30
stateOptionalon | off | suspended | ended | archived | converted—

yandex_performance_report

Đọc1 credits

Yandex Direct campaign performance report: impressions, clicks, cost, CTR, average CPC, conversions and cost per conversion, per campaign or per day. Large reports are queued by Yandex: pending=true means call again with the same arguments. Read only; never invents numbers.

ParameterTypeDescription
account_idOptionalstringYandex login of an agency client (sent as Client-Login); defaults to the connection's selected account or the connected account itself
daysOptionalinteger (1–365)last N days including today, default 30
date_fromOptionalstringYYYY-MM-DD, with date_to
date_toOptionalstringYYYY-MM-DD, with date_from
campaign_idOptionalstring—
group_byOptionalcampaign | day—
include_vatOptionalbooleaninclude VAT in monetary values, default false

diagnose_yandex_delivery

Đọc1 credits

Why a Yandex Direct campaign isn't serving, or is off, suspended, in moderation or rejected: call it first when the user reports such a problem. Live read of the campaign (state, status, payment status, Yandex's status clarification text, bidding strategy targets and limits, funds), its ad groups (keyword review status, serving status) and ads (state, moderation status, rejection text, sitelink / image / per-asset moderation), plus which objects changed in the last 7 days; returned with a findings list (scope, Yandex's code, category, evidence) and cannot_read for what the API doesn't expose. Read only.

ParameterTypeDescription
account_idOptionalstringYandex login of an agency client (sent as Client-Login); defaults to the connection's selected account or the connected account itself
campaign_idRequiredstringYandex Direct campaign id (list_yandex_campaigns)

Write tools3 tools

update_yandex_campaign_status

Ghi2 credits

Pause or activate a Yandex Direct campaign. Applied when the user asks, recorded in the audit log and undoable with undo_action.

ParameterTypeDescription
account_idOptionalstringYandex login of an agency client (sent as Client-Login); defaults to the connection's selected account or the connected account itself
campaign_idRequiredstring—
statusRequiredpause | activate—

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

update_yandex_campaign_budget

Ghi2 credits

Set a Yandex Direct campaign weekly budget (account currency); Yandex no longer uses daily campaign budgets. Text and unified campaigns only; portfolio, custom period and priority goal strategies are refused. Increases above 50% per change or 2x per 24 hours are blocked; undoable with undo_action.

ParameterTypeDescription
account_idOptionalstringYandex login of an agency client (sent as Client-Login); defaults to the connection's selected account or the connected account itself
campaign_idRequiredstring—
weekly_budgetRequirednumbernew weekly budget in the account currency

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

create_yandex_campaign

Ghi5 credits

Create a Yandex Direct text campaign with an automatic strategy (weekly click budget) and suspend it right away - Yandex creates campaigns live, and manual strategies are no longer accepted for new campaigns. Budgets are weekly, not daily. Ad groups and ads are added in the Yandex interface.

ParameterTypeDescription
account_idOptionalstringYandex login of an agency client (sent as Client-Login); defaults to the connection's selected account or the connected account itself
nameRequiredstring—
weekly_budgetRequirednumberaccount currency; Yandex budgets are WEEKLY
placementOptionalsearch_only | search_and_network—
start_dateOptionalstringYYYY-MM-DD, not in the past
end_dateOptionalstringYYYY-MM-DD

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.