Yandex-Direct-Tools
Yandex-Direct-Konten, Kampagnen und Leistungsberichte; Status- und Wochenbudgetänderungen laufen über Vorschau und Freigabe und lassen sich rückgängig machen.
Toolnamen und Beschreibungen werden direkt aus dem Servercode erzeugt; die Beschreibungen sind Übersetzungen des Textes, den der Assistent sieht, Tool- und Parameternamen bleiben unverändert.
Lese-Tools4 Tools
list_yandex_clients
Lesen1 CreditsÜber die verbundene Anmeldung erreichbare Yandex Direct-Konten: die Kunden einer Agentur, sonst das verbundene Konto selbst. Liefert Login (account_id), Name, Währung, Typ und Archiv-Kennzeichen. Nur lesend; connected=false, wenn Yandex nicht verbunden ist.
Dieses Tool hat keine Parameter.
list_yandex_campaigns
Lesen1 CreditsYandex Direct-Kampagnen: ID, Name, Typ, Zustand, Status, Gebotsstrategie und Wochenbudget, mit Ausgaben, Impressionen, Klicks und Conversions der letzten N Tage. Ist der Statistikbericht noch in der Warteschlange, bleibt stats leer und stats_ready=false. Nur lesend; erfindet keine Zahlen.
| Parameter | Typ | Beschreibung |
|---|---|---|
account_idOptional | string | Yandex-Login eines Agenturkunden (wird als Client-Login gesendet); Standard: das in der Verbindung ausgewählte Konto oder das verbundene Konto selbst |
daysOptional | integer (1–365) | letzte N Tage einschließlich heute, Standard 30 |
stateOptional | on | off | suspended | ended | archived | converted | — |
yandex_performance_report
Lesen1 CreditsYandex Direct-Kampagnenleistungsbericht: Impressionen, Klicks, Kosten, CTR, durchschnittlicher CPC, Conversions und Kosten pro Conversion, pro Kampagne oder pro Tag. Große Berichte stellt Yandex in die Warteschlange: pending=true bedeutet, mit denselben Argumenten erneut aufzurufen. Nur lesend; erfindet keine Zahlen.
| Parameter | Typ | Beschreibung |
|---|---|---|
account_idOptional | string | Yandex-Login eines Agenturkunden (wird als Client-Login gesendet); Standard: das in der Verbindung ausgewählte Konto oder das verbundene Konto selbst |
daysOptional | integer (1–365) | letzte N Tage einschließlich heute, Standard 30 |
date_fromOptional | string | YYYY-MM-DD, zusammen mit date_to |
date_toOptional | string | YYYY-MM-DD, zusammen mit date_from |
campaign_idOptional | string | — |
group_byOptional | campaign | day | — |
include_vatOptional | boolean | bezieht die MwSt. in Geldwerte ein, Standard false |
diagnose_yandex_delivery
Lesen1 CreditsLIVE-Auslieferungsdiagnose einer Yandex Direct-Kampagne. Zuerst aufrufen, wenn der Nutzer meldet, dass die Kampagne nicht ausgespielt wird, aus oder angehalten ist, in der Moderation hängt oder abgelehnt wurde. Liest die Kampagne (Zustand, Status, Zahlungsstatus, Statuserläuterung von Yandex, Ziele und Limits der Gebotsstrategie, Guthaben), ihre Anzeigengruppen (Keyword-Prüfstatus, Auslieferungsstatus) und Anzeigen (Zustand, Moderationsstatus, Ablehnungstext, Moderation von Sitelinks / Bildern / einzelnen Elementen) sowie die in den letzten 7 Tagen geänderten Objekte; liefert eine Befundliste (Ebene, Code von Yandex, Kategorie, Beleg) und cannot_read für das, was die API nicht bereitstellt. Nur lesend.
| Parameter | Typ | Beschreibung |
|---|---|---|
account_idOptional | string | Yandex-Login eines Agenturkunden (wird als Client-Login gesendet); Standard: das in der Verbindung ausgewählte Konto oder das verbundene Konto selbst |
campaign_idPflicht | string | Yandex Direct-Kampagnen-ID (list_yandex_campaigns) |
Schreib-Tools3 Tools
update_yandex_campaign_status
Schreiben2 CreditsPausiert oder aktiviert eine Yandex Direct-Kampagne. Wird auf Wunsch des Nutzers angewendet, im Prüfprotokoll erfasst und ist mit undo_action rückgängig machbar.
| Parameter | Typ | Beschreibung |
|---|---|---|
account_idOptional | string | Yandex-Login eines Agenturkunden (wird als Client-Login gesendet); Standard: das in der Verbindung ausgewählte Konto oder das verbundene Konto selbst |
campaign_idPflicht | string | — |
statusPflicht | pause | activate | — |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
update_yandex_campaign_budget
Schreiben2 CreditsLegt das Wochenbudget einer Yandex Direct-Kampagne fest (Kontowährung); Yandex verwendet keine täglichen Kampagnenbudgets mehr. Nur für Text- und Unified-Kampagnen; Portfolio-Strategien, Strategien mit benutzerdefiniertem Zeitraum und mit Prioritätszielen werden abgelehnt. Erhöhungen über 50 % pro Änderung oder 2× innerhalb von 24 Stunden werden blockiert; mit undo_action rückgängig machbar.
| Parameter | Typ | Beschreibung |
|---|---|---|
account_idOptional | string | Yandex-Login eines Agenturkunden (wird als Client-Login gesendet); Standard: das in der Verbindung ausgewählte Konto oder das verbundene Konto selbst |
campaign_idPflicht | string | — |
weekly_budgetPflicht | number | neues Wochenbudget in der Kontowährung |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
create_yandex_campaign
Schreiben5 CreditsErstellt eine Yandex Direct-Textkampagne (automatische Strategie: wöchentliches Klickbudget) und pausiert sie sofort – Yandex startet Kampagnen live und akzeptiert seit 2024 keine manuellen Strategien für neue Kampagnen. Das Budget ist WÖCHENTLICH, nicht täglich. Anzeigengruppen und Anzeigen werden in der Yandex-Oberfläche angelegt.
| Parameter | Typ | Beschreibung |
|---|---|---|
account_idOptional | string | Yandex-Login eines Agenturkunden (wird als Client-Login gesendet); Standard: das in der Verbindung ausgewählte Konto oder das verbundene Konto selbst |
namePflicht | string | — |
weekly_budgetPflicht | number | in Kontowährung; Yandex-Budgets sind WÖCHENTLICH |
placementOptional | search_only | search_and_network | — |
start_dateOptional | string | YYYY-MM-DD, not in the past |
end_dateOptional | string | YYYY-MM-DD |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.