Zum Inhalt springen
Tecrübetecrube.com
Assistenten-Tools · Einrichtung und Kampagnen

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 Credits

Yandex 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.

ParameterTypBeschreibung
account_idOptionalstringYandex-Login eines Agenturkunden (wird als Client-Login gesendet); Standard: das in der Verbindung ausgewählte Konto oder das verbundene Konto selbst
daysOptionalinteger (1–365)letzte N Tage einschließlich heute, Standard 30
stateOptionalon | off | suspended | ended | archived | converted—

yandex_performance_report

Lesen1 Credits

Yandex 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.

ParameterTypBeschreibung
account_idOptionalstringYandex-Login eines Agenturkunden (wird als Client-Login gesendet); Standard: das in der Verbindung ausgewählte Konto oder das verbundene Konto selbst
daysOptionalinteger (1–365)letzte N Tage einschließlich heute, Standard 30
date_fromOptionalstringYYYY-MM-DD, zusammen mit date_to
date_toOptionalstringYYYY-MM-DD, zusammen mit date_from
campaign_idOptionalstring—
group_byOptionalcampaign | day—
include_vatOptionalbooleanbezieht die MwSt. in Geldwerte ein, Standard false

diagnose_yandex_delivery

Lesen1 Credits

LIVE-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.

ParameterTypBeschreibung
account_idOptionalstringYandex-Login eines Agenturkunden (wird als Client-Login gesendet); Standard: das in der Verbindung ausgewählte Konto oder das verbundene Konto selbst
campaign_idPflichtstringYandex Direct-Kampagnen-ID (list_yandex_campaigns)

Schreib-Tools3 Tools

update_yandex_campaign_status

Schreiben2 Credits

Pausiert 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.

ParameterTypBeschreibung
account_idOptionalstringYandex-Login eines Agenturkunden (wird als Client-Login gesendet); Standard: das in der Verbindung ausgewählte Konto oder das verbundene Konto selbst
campaign_idPflichtstring—
statusPflichtpause | activate—

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

update_yandex_campaign_budget

Schreiben2 Credits

Legt 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.

ParameterTypBeschreibung
account_idOptionalstringYandex-Login eines Agenturkunden (wird als Client-Login gesendet); Standard: das in der Verbindung ausgewählte Konto oder das verbundene Konto selbst
campaign_idPflichtstring—
weekly_budgetPflichtnumberneues 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 Credits

Erstellt 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.

ParameterTypBeschreibung
account_idOptionalstringYandex-Login eines Agenturkunden (wird als Client-Login gesendet); Standard: das in der Verbindung ausgewählte Konto oder das verbundene Konto selbst
namePflichtstring—
weekly_budgetPflichtnumberin Kontowährung; Yandex-Budgets sind WÖCHENTLICH
placementOptionalsearch_only | search_and_network—
start_dateOptionalstringYYYY-MM-DD, not in the past
end_dateOptionalstringYYYY-MM-DD

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.