Herramientas de Yandex Direct
Cuentas, campañas e informes de rendimiento de Yandex Direct; los cambios de estado y presupuesto semanal pasan por vista previa y aprobación y se pueden deshacer.
Los nombres y descripciones se generan directamente desde el código del servidor; las descripciones son la traducción del texto que ve el asistente, los nombres de herramientas y parámetros no cambian.
Herramientas de lectura4 herramientas
list_yandex_clients
Lectura1 créditosCuentas de Yandex Direct accesibles con el inicio de sesión conectado: los clientes de una agencia o, en caso contrario, la propia cuenta conectada. Devuelve el inicio de sesión (account_id), nombre, moneda, tipo e indicador de archivado. Solo lectura; connected=false si Yandex no está conectado.
Esta herramienta no recibe parámetros.
list_yandex_campaigns
Lectura1 créditosCampañas de Yandex Direct: id, nombre, tipo, estado, estatus, estrategia de puja y presupuesto semanal, con gasto, impresiones, clics y conversiones de los últimos N días. Si el informe de estadísticas sigue en cola, stats queda vacío y stats_ready=false. Solo lectura; nunca inventa cifras.
| Parámetro | Tipo | Descripción |
|---|---|---|
account_idOpcional | string | inicio de sesión de Yandex de un cliente de agencia (se envía como Client-Login); por defecto: la cuenta seleccionada en la conexión o la propia cuenta conectada |
daysOpcional | integer (1–365) | últimos N días, incluido hoy, por defecto 30 |
stateOpcional | on | off | suspended | ended | archived | converted | — |
yandex_performance_report
Lectura1 créditosInforme de rendimiento de campañas de Yandex Direct: impresiones, clics, coste, CTR, CPC medio, conversiones y coste por conversión, por campaña o por día. Yandex pone en cola los informes grandes: pending=true significa volver a llamar con los mismos argumentos. Solo lectura; nunca inventa cifras.
| Parámetro | Tipo | Descripción |
|---|---|---|
account_idOpcional | string | inicio de sesión de Yandex de un cliente de agencia (se envía como Client-Login); por defecto: la cuenta seleccionada en la conexión o la propia cuenta conectada |
daysOpcional | integer (1–365) | últimos N días, incluido hoy, por defecto 30 |
date_fromOpcional | string | YYYY-MM-DD, junto con date_to |
date_toOpcional | string | YYYY-MM-DD, junto con date_from |
campaign_idOpcional | string | — |
group_byOpcional | campaign | day | — |
include_vatOpcional | boolean | incluye el IVA en los valores monetarios, por defecto false |
diagnose_yandex_delivery
Lectura1 créditosDiagnóstico de entrega EN VIVO de una campaña de Yandex Direct. Llámala primero cuando el usuario informe de que la campaña no se muestra, está desactivada o suspendida, en moderación o rechazada. Lee la campaña (estado, estatus, estado de pago, texto aclaratorio de Yandex, objetivos y límites de la estrategia de puja, fondos), sus grupos de anuncios (estado de revisión de palabras clave, estado de publicación) y anuncios (estado, estado de moderación, texto de rechazo, moderación de enlaces de sitio / imágenes / por elemento), además de los objetos modificados en los últimos 7 días; devuelve una lista de hallazgos (ámbito, código de Yandex, categoría, evidencia) y cannot_read con lo que la API no expone. Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
account_idOpcional | string | inicio de sesión de Yandex de un cliente de agencia (se envía como Client-Login); por defecto: la cuenta seleccionada en la conexión o la propia cuenta conectada |
campaign_idObligatorio | string | id de campaña de Yandex Direct (list_yandex_campaigns) |
Herramientas de escritura3 herramientas
update_yandex_campaign_status
Escritura2 créditosPausa o activa una campaña de Yandex Direct. Se aplica cuando el usuario lo pide, queda en el registro de auditoría y se puede deshacer con undo_action.
| Parámetro | Tipo | Descripción |
|---|---|---|
account_idOpcional | string | inicio de sesión de Yandex de un cliente de agencia (se envía como Client-Login); por defecto: la cuenta seleccionada en la conexión o la propia cuenta conectada |
campaign_idObligatorio | string | — |
statusObligatorio | pause | activate | — |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
update_yandex_campaign_budget
Escritura2 créditosEstablece el presupuesto semanal de una campaña de Yandex Direct (moneda de la cuenta); Yandex ya no usa presupuestos diarios de campaña. Solo campañas de texto y unificadas; se rechazan las estrategias de cartera, de periodo personalizado y de objetivos prioritarios. Se bloquean los aumentos superiores al 50 % por cambio o 2× en 24 horas; se puede deshacer con undo_action.
| Parámetro | Tipo | Descripción |
|---|---|---|
account_idOpcional | string | inicio de sesión de Yandex de un cliente de agencia (se envía como Client-Login); por defecto: la cuenta seleccionada en la conexión o la propia cuenta conectada |
campaign_idObligatorio | string | — |
weekly_budgetObligatorio | number | nuevo presupuesto semanal en la moneda de la cuenta |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
create_yandex_campaign
Escritura5 créditosCrea una campaña de texto en Yandex Direct (estrategia automática: presupuesto semanal de clics) y la detiene de inmediato: Yandex crea las campañas activas y desde 2024 no acepta estrategias manuales en campañas nuevas. El presupuesto es SEMANAL, no diario. Los grupos de anuncios y los anuncios se añaden en la interfaz de Yandex.
| Parámetro | Tipo | Descripción |
|---|---|---|
account_idOpcional | string | inicio de sesión de Yandex de un cliente de agencia (se envía como Client-Login); por defecto: la cuenta seleccionada en la conexión o la propia cuenta conectada |
nameObligatorio | string | — |
weekly_budgetObligatorio | number | en la moneda de la cuenta; los presupuestos de Yandex son SEMANALES |
placementOpcional | search_only | search_and_network | — |
start_dateOpcional | string | YYYY-MM-DD, not in the past |
end_dateOpcional | string | YYYY-MM-DD |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.