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

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 Credits

Snapchat 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).

ParameterTypBeschreibung
account_idOptionalstringSnapchat-Werbekonto-ID; Standard: das in der Verbindung ausgewählte Konto
daysOptionalinteger (1–31)letzte N ganze Tage, endend mit gestern; Standard 7
statusOptionalactive | paused—

snapchat_performance_report

Lesen1 Credits

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

ParameterTypBeschreibung
account_idOptionalstringSnapchat-Werbekonto-ID; Standard: das in der Verbindung ausgewählte Konto
daysOptionalinteger (1–31)letzte N ganze Tage, endend mit gestern; Standard 7
campaign_idOptionalstringbeschränkt den Bericht auf eine Kampagne
start_dateOptionalstringYYYY-MM-DD
end_dateOptionalstringYYYY-MM-DD; höchstens gestern
granularityOptionaltotal | dayStandard total

diagnose_snapchat_delivery

Lesen1 Credits

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

ParameterTypBeschreibung
account_idOptionalstringSnapchat-Werbekonto-ID; Standard: das in der Verbindung ausgewählte Konto
campaign_idPflichtstringSnapchat-Kampagnen-ID (list_snapchat_campaigns)

Schreib-Tools3 Tools

update_snapchat_campaign_status

Schreiben2 Credits

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

ParameterTypBeschreibung
account_idOptionalstringSnapchat-Werbekonto-ID; Standard: das in der Verbindung ausgewählte Konto
campaign_idPflichtstring—
statusPflichtpause | activate—

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

update_snapchat_campaign_budget

Schreiben2 Credits

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

ParameterTypBeschreibung
account_idOptionalstringSnapchat-Werbekonto-ID; Standard: das in der Verbindung ausgewählte Konto
campaign_idPflichtstring—
daily_budgetPflichtnumberneues 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 Credits

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

ParameterTypBeschreibung
account_idOptionalstringSnapchat ad account id; defaults to the connection's selected account
namePflichtstring—
daily_budgetPflichtnumberin Kontowährung, mindestens 5 (Snapchats Untergrenze sind 5.000.000 Mikro)
objectiveOptionalBRAND_AWARENESS | WEB_CONVERSION | APP_INSTALL | APP_CONVERSION | CATALOG_SALES | ENGAGEMENT | LEAD_GENERATION | VIDEO_VIEW | PROMOTE_PLACES | PROMOTE_STORIES—
optimization_goalOptionalIMPRESSIONS | SWIPES | LANDING_PAGE_VIEW | PIXEL_PAGE_VIEW | PIXEL_ADD_TO_CART | PIXEL_PURCHASE | PIXEL_SIGNUP | LEAD_FORM_SUBMISSIONS | VIDEO_VIEWS | APP_INSTALLS—
bid_strategyOptionalAUTO_BID | LOWEST_COST_WITH_MAX_BID | TARGET_COST—
bidOptionalnumber—
pixel_idOptionalstring—
ad_squad_nameOptionalstring—
start_timeOptionalstringISO 8601 UTC, e.g. 2026-12-01T00:00:00.000Z
audienceOptionalobjectcountries, age_min, age_max, genders

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