Aller au contenu
Tecrübetecrube.com
Outils de l'assistant · Création et campagnes

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

Comptes 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édits

Campagnes 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ètreTypeDescription
account_idFacultatifstringidentifiant 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
daysFacultatifinteger (1–365)N derniers jours, aujourd'hui inclus, 30 par défaut
stateFacultatifon | off | suspended | ended | archived | converted—

yandex_performance_report

Lecture1 crédits

Rapport 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ètreTypeDescription
account_idFacultatifstringidentifiant 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
daysFacultatifinteger (1–365)N derniers jours, aujourd'hui inclus, 30 par défaut
date_fromFacultatifstringYYYY-MM-DD, avec date_to
date_toFacultatifstringYYYY-MM-DD, avec date_from
campaign_idFacultatifstring—
group_byFacultatifcampaign | day—
include_vatFacultatifbooleaninclut la TVA dans les valeurs monétaires, false par défaut

diagnose_yandex_delivery

Lecture1 crédits

Diagnostic 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ètreTypeDescription
account_idFacultatifstringidentifiant 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_idObligatoirestringid de campagne Yandex Direct (list_yandex_campaigns)

Outils d'écriture3 outils

update_yandex_campaign_status

Écriture2 crédits

Met 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ètreTypeDescription
account_idFacultatifstringidentifiant 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_idObligatoirestring—
statusObligatoirepause | 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édits

Dé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ètreTypeDescription
account_idFacultatifstringidentifiant 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_idObligatoirestring—
weekly_budgetObligatoirenumbernouveau 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édits

Cré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ètreTypeDescription
account_idFacultatifstringidentifiant 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
nameObligatoirestring—
weekly_budgetObligatoirenumberdans la devise du compte ; les budgets Yandex sont HEBDOMADAIRES
placementFacultatifsearch_only | search_and_network—
start_dateFacultatifstringYYYY-MM-DD, not in the past
end_dateFacultatifstringYYYY-MM-DD

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.