Saltar al contenido
Tecrübetecrube.com
Herramientas del asistente · Configuración y campañas

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éditos

Cuentas 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éditos

Campañ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ámetroTipoDescripción
account_idOpcionalstringinicio 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
daysOpcionalinteger (1–365)últimos N días, incluido hoy, por defecto 30
stateOpcionalon | off | suspended | ended | archived | converted—

yandex_performance_report

Lectura1 créditos

Informe 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ámetroTipoDescripción
account_idOpcionalstringinicio 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
daysOpcionalinteger (1–365)últimos N días, incluido hoy, por defecto 30
date_fromOpcionalstringYYYY-MM-DD, junto con date_to
date_toOpcionalstringYYYY-MM-DD, junto con date_from
campaign_idOpcionalstring—
group_byOpcionalcampaign | day—
include_vatOpcionalbooleanincluye el IVA en los valores monetarios, por defecto false

diagnose_yandex_delivery

Lectura1 créditos

Diagnó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ámetroTipoDescripción
account_idOpcionalstringinicio 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_idObligatoriostringid de campaña de Yandex Direct (list_yandex_campaigns)

Herramientas de escritura3 herramientas

update_yandex_campaign_status

Escritura2 créditos

Pausa 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ámetroTipoDescripción
account_idOpcionalstringinicio 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_idObligatoriostring—
statusObligatoriopause | 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éditos

Establece 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ámetroTipoDescripción
account_idOpcionalstringinicio 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_idObligatoriostring—
weekly_budgetObligatorionumbernuevo 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éditos

Crea 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ámetroTipoDescripción
account_idOpcionalstringinicio 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
nameObligatoriostring—
weekly_budgetObligatorionumberen la moneda de la cuenta; los presupuestos de Yandex son SEMANALES
placementOpcionalsearch_only | search_and_network—
start_dateOpcionalstringYYYY-MM-DD, not in the past
end_dateOpcionalstringYYYY-MM-DD

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.