Outils Yandex Direct
Comptes, campagnes et rapports de performance Yandex Direct ; les changements de statut et de budget hebdomadaire passent par l'aperçu et l'approbation et peuvent être annulés.
Les noms et descriptions des outils sont générés directement depuis le code du serveur ; les descriptions sont la traduction du texte vu par l'assistant, les noms d'outils et de paramètres restent inchangés.
Outils de lecture4 outils
list_yandex_clients
Lecture1 créditsComptes Yandex Direct accessibles via la connexion liée : les clients d'une agence, sinon le compte connecté lui-même. Renvoie l'identifiant (account_id), le nom, la devise, le type et l'indicateur d'archivage. Lecture seule ; connected=false si Yandex n'est pas connecté.
Cet outil ne prend aucun paramètre.
list_yandex_campaigns
Lecture1 créditsCampagnes Yandex Direct : id, nom, type, état, statut, stratégie d'enchères et budget hebdomadaire, avec dépenses, impressions, clics et conversions des N derniers jours. Si le rapport de statistiques est encore en file d'attente, stats reste vide et stats_ready=false. Lecture seule ; n'invente jamais de chiffres.
| Paramètre | Type | Description |
|---|---|---|
account_idFacultatif | string | identifiant Yandex d'un client d'agence (envoyé comme Client-Login) ; par défaut : le compte sélectionné dans la connexion ou le compte connecté lui-même |
daysFacultatif | integer (1–365) | N derniers jours, aujourd'hui inclus, 30 par défaut |
stateFacultatif | on | off | suspended | ended | archived | converted | — |
yandex_performance_report
Lecture1 créditsRapport de performances des campagnes Yandex Direct : impressions, clics, coût, CTR, CPC moyen, conversions et coût par conversion, par campagne ou par jour. Yandex met les rapports volumineux en file d'attente : pending=true signifie qu'il faut rappeler avec les mêmes arguments. Lecture seule ; n'invente jamais de chiffres.
| Paramètre | Type | Description |
|---|---|---|
account_idFacultatif | string | identifiant Yandex d'un client d'agence (envoyé comme Client-Login) ; par défaut : le compte sélectionné dans la connexion ou le compte connecté lui-même |
daysFacultatif | integer (1–365) | N derniers jours, aujourd'hui inclus, 30 par défaut |
date_fromFacultatif | string | YYYY-MM-DD, avec date_to |
date_toFacultatif | string | YYYY-MM-DD, avec date_from |
campaign_idFacultatif | string | — |
group_byFacultatif | campaign | day | — |
include_vatFacultatif | boolean | inclut la TVA dans les valeurs monétaires, false par défaut |
diagnose_yandex_delivery
Lecture1 créditsDiagnostic de diffusion EN DIRECT d'une campagne Yandex Direct. À appeler en premier lorsque l'utilisateur signale que la campagne n'est pas diffusée, est désactivée ou suspendue, en modération ou refusée. Lit la campagne (état, statut, statut de paiement, texte d'explication de Yandex, objectifs et limites de la stratégie d'enchères, fonds), ses groupes d'annonces (statut d'examen des mots clés, statut de diffusion) et ses annonces (état, statut de modération, texte de refus, modération des liens annexes / images / par élément), ainsi que les objets modifiés au cours des 7 derniers jours ; renvoie une liste de constats (niveau, code Yandex, catégorie, preuve) et cannot_read pour ce que l'API n'expose pas. Lecture seule.
| Paramètre | Type | Description |
|---|---|---|
account_idFacultatif | string | identifiant Yandex d'un client d'agence (envoyé comme Client-Login) ; par défaut : le compte sélectionné dans la connexion ou le compte connecté lui-même |
campaign_idObligatoire | string | id de campagne Yandex Direct (list_yandex_campaigns) |
Outils d'écriture3 outils
update_yandex_campaign_status
Écriture2 créditsMet en pause ou active une campagne Yandex Direct. Appliqué à la demande de l'utilisateur, consigné dans le journal d'audit et annulable avec undo_action.
| Paramètre | Type | Description |
|---|---|---|
account_idFacultatif | string | identifiant Yandex d'un client d'agence (envoyé comme Client-Login) ; par défaut : le compte sélectionné dans la connexion ou le compte connecté lui-même |
campaign_idObligatoire | string | — |
statusObligatoire | pause | activate | — |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
update_yandex_campaign_budget
Écriture2 créditsDéfinit le budget hebdomadaire d'une campagne Yandex Direct (devise du compte) ; Yandex n'utilise plus de budgets quotidiens de campagne. Campagnes texte et unifiées uniquement ; les stratégies de portefeuille, de période personnalisée et d'objectifs prioritaires sont refusées. Les hausses de plus de 50 % par modification ou 2× en 24 heures sont bloquées ; annulable avec undo_action.
| Paramètre | Type | Description |
|---|---|---|
account_idFacultatif | string | identifiant Yandex d'un client d'agence (envoyé comme Client-Login) ; par défaut : le compte sélectionné dans la connexion ou le compte connecté lui-même |
campaign_idObligatoire | string | — |
weekly_budgetObligatoire | number | nouveau budget hebdomadaire dans la devise du compte |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
create_yandex_campaign
Écriture5 créditsCrée une campagne textuelle Yandex Direct (stratégie automatique : budget hebdomadaire de clics) et la suspend immédiatement — Yandex crée les campagnes en diffusion et n'accepte plus de stratégie manuelle pour les nouvelles campagnes depuis 2024. Le budget est HEBDOMADAIRE, pas quotidien. Les groupes d'annonces et les annonces s'ajoutent dans l'interface Yandex.
| Paramètre | Type | Description |
|---|---|---|
account_idFacultatif | string | identifiant Yandex d'un client d'agence (envoyé comme Client-Login) ; par défaut : le compte sélectionné dans la connexion ou le compte connecté lui-même |
nameObligatoire | string | — |
weekly_budgetObligatoire | number | dans la devise du compte ; les budgets Yandex sont HEBDOMADAIRES |
placementFacultatif | search_only | search_and_network | — |
start_dateFacultatif | string | YYYY-MM-DD, not in the past |
end_dateFacultatif | string | YYYY-MM-DD |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.