Snapchat-Tools
Snapchat-Werbekonten, Kampagnen und Leistungsberichte; Status- und Tagesbudgetä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_snapchat_ad_accounts
Lesen1 CreditsÜber die verbundene Anmeldung in allen ihren Organisationen erreichbare Snapchat Ads-Konten: account_id, Name, Währung, Zeitzone, Status, Organisation und welches ausgewählt ist. Nur lesend; connected=false, wenn Snapchat nicht verbunden ist.
Dieses Tool hat keine Parameter.
list_snapchat_campaigns
Lesen1 CreditsSnapchat Ads-Kampagnen des Kontos: ID, Name, Status, Ziel, Tagesbudget und Gesamtausgabenlimit (Kontowährung), Zeitplan, Auslieferungsstatus sowie Ausgaben, Impressionen, Swipes und Kauf-Conversions der letzten N ganzen Tage. Nur lesend; erfindet keine Zahlen (stats=null, wenn Snapchat keine geliefert hat).
| Parameter | Typ | Beschreibung |
|---|---|---|
account_idOptional | string | Snapchat-Werbekonto-ID; Standard: das in der Verbindung ausgewählte Konto |
daysOptional | integer (1–31) | letzte N ganze Tage, endend mit gestern; Standard 7 |
statusOptional | active | paused | — |
snapchat_performance_report
Lesen1 CreditsSnapchat Ads-Leistung für bis zu 31 ganze Tage in der Zeitzone des Kontos: Summen, Aufschlüsselung pro Kampagne und optionale Tageszeilen mit Ausgaben, Impressionen, Swipes, Käufen, Kaufwert und Add-to-Cart. Heute ist nicht enthalten. Nur lesend; erfindet keine Zahlen.
| Parameter | Typ | Beschreibung |
|---|---|---|
account_idOptional | string | Snapchat-Werbekonto-ID; Standard: das in der Verbindung ausgewählte Konto |
daysOptional | integer (1–31) | letzte N ganze Tage, endend mit gestern; Standard 7 |
campaign_idOptional | string | beschränkt den Bericht auf eine Kampagne |
start_dateOptional | string | YYYY-MM-DD |
end_dateOptional | string | YYYY-MM-DD; höchstens gestern |
granularityOptional | total | day | Standard total |
diagnose_snapchat_delivery
Lesen1 CreditsLIVE-Auslieferungsdiagnose einer Snapchat Ads-Kampagne. Zuerst aufrufen, wenn der Nutzer meldet, dass die Kampagne nicht ausgeliefert wird, pausiert, ausstehend, eingeschränkt oder abgelehnt ist. Liest das Werbekonto, die Kampagne, ihre Ad Squads (Auslieferungsstatus-Codes, Budget, Gebotsstrategie, Gebot, ROAS-Wert, Pacing) und Anzeigen (Prüfstatus und Ablehnungsgründe) sowie das Änderungsprotokoll der Kampagne und die Gebotsschätzung von Snap; liefert eine Befundliste (Ebene, Code von Snap, Kategorie, Beleg) und cannot_read für das, was nicht gelesen wurde. Nur lesend.
| Parameter | Typ | Beschreibung |
|---|---|---|
account_idOptional | string | Snapchat-Werbekonto-ID; Standard: das in der Verbindung ausgewählte Konto |
campaign_idPflicht | string | Snapchat-Kampagnen-ID (list_snapchat_campaigns) |
Schreib-Tools3 Tools
update_snapchat_campaign_status
Schreiben2 CreditsPausiert oder aktiviert eine Snapchat Ads-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 | Snapchat-Werbekonto-ID; Standard: das in der Verbindung ausgewählte Konto |
campaign_idPflicht | string | — |
statusPflicht | pause | activate | — |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
update_snapchat_campaign_budget
Schreiben2 CreditsLegt das Tagesbudget einer Snapchat Ads-Kampagne fest (Kontowährung, mindestens 20). Erhöhungen über 50 % pro Änderung oder 2× innerhalb von 24 Stunden werden blockiert; mit undo_action rückgängig machbar, wenn die Kampagne bereits ein Tagesbudget hatte.
| Parameter | Typ | Beschreibung |
|---|---|---|
account_idOptional | string | Snapchat-Werbekonto-ID; Standard: das in der Verbindung ausgewählte Konto |
campaign_idPflicht | string | — |
daily_budgetPflicht | number | neues Tagesbudget in der Kontowährung, mindestens 20 |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
create_snapchat_campaign
Schreiben5 CreditsErstellt eine Snapchat-Kampagne zusammen mit ihrer Anzeigengruppe (Targeting, Budget, Optimierungsziel, Gebotsstrategie) – beide pausiert. Eine Anzeige braucht zuerst ein zu Snapchat hochgeladenes Creative und wird hier nicht erstellt. Wird auf Wunsch angewendet; zum Schalten update_snapchat_campaign_status.
| Parameter | Typ | Beschreibung |
|---|---|---|
account_idOptional | string | Snapchat ad account id; defaults to the connection's selected account |
namePflicht | string | — |
daily_budgetPflicht | number | in Kontowährung, mindestens 5 (Snapchats Untergrenze sind 5.000.000 Mikro) |
objectiveOptional | BRAND_AWARENESS | WEB_CONVERSION | APP_INSTALL | APP_CONVERSION | CATALOG_SALES | ENGAGEMENT | LEAD_GENERATION | VIDEO_VIEW | PROMOTE_PLACES | PROMOTE_STORIES | — |
optimization_goalOptional | IMPRESSIONS | SWIPES | LANDING_PAGE_VIEW | PIXEL_PAGE_VIEW | PIXEL_ADD_TO_CART | PIXEL_PURCHASE | PIXEL_SIGNUP | LEAD_FORM_SUBMISSIONS | VIDEO_VIEWS | APP_INSTALLS | — |
bid_strategyOptional | AUTO_BID | LOWEST_COST_WITH_MAX_BID | TARGET_COST | — |
bidOptional | number | — |
pixel_idOptional | string | — |
ad_squad_nameOptional | string | — |
start_timeOptional | string | ISO 8601 UTC, e.g. 2026-12-01T00:00:00.000Z |
audienceOptional | object | countries, age_min, age_max, genders |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.