Einordnung des Features
Seit dem 29. Juli 2026 zeigt Shopify in Analytics-Charts auch Annotationen an, die von installierten Apps erstellt wurden. Eine Annotation markiert ein Ereignis an einem bestimmten Tag oder innerhalb eines Zeitraums. Shopify zeigt im Admin außerdem, welche App die Markierung erzeugt hat. Händler können dadurch beispielsweise Kampagnen, Produktstarts, Lieferantenwechsel oder neue Landingpages mit der Entwicklung ihrer Kennzahlen vergleichen. Die Annotation verändert keine Berichtsdaten, sondern ergänzt sie um geschäftlichen Kontext.
Was das Feature ist und was es nicht ist
Eine zeitliche Markierung für geschäftliche Ereignisse
Eine Annotation ist ein sichtbarer Marker unterhalb eines Analytics-Charts. Sie zeigt, dass zu diesem Zeitpunkt ein Ereignis stattgefunden hat, das für die Interpretation der Kennzahlen relevant sein könnte.
Das lässt sich mit einer Notiz in einem Kalender vergleichen. Die Notiz verändert nicht, was an diesem Tag passiert ist. Sie hilft aber dabei, das Ereignis später wieder einzuordnen.
Shopify unterscheidet zwei Quellen.
Shopify kann bestimmte Aktivitäten des Shops automatisch markieren. Dazu gehören veröffentlichte oder deaktivierte Produkte, veröffentlichte Themes, installierte oder deinstallierte Apps, Änderungen an Kennzahlendefinitionen und Zeiträume mit fehlenden Daten.
Installierte Apps können zusätzliche Ereignisse markieren. Unterstützte Beispiele sind Produktstarts, Kampagnen, Preisaktionen, Änderungen am Werbebudget, neue Zahlungsmethoden, Lagerwechsel, Markteintritte, Loyalty-Programme und externe Ereignisse.
Kein Beweis für Ursache und Wirkung
Eine Annotation zeigt einen zeitlichen Zusammenhang. Sie beweist nicht, dass ein Ereignis eine Veränderung verursacht hat.
Steigt der Umsatz nach dem Start einer Kampagne, kann die Kampagne eine Rolle gespielt haben. Gleichzeitig könnten jedoch ein Feiertag, eine Medienerwähnung, eine veränderte Nachfrage oder eine Aktion eines Wettbewerbers den Umsatz beeinflusst haben.
Eine sachlich richtige Aussage lautet deshalb
Nach dem Kampagnenstart stieg der Umsatz. Der Effekt sollte nun nach Markt, Kanal, Produktgruppe und Kundentyp untersucht werden.
Eine zu weit gehende Aussage wäre
Die Kampagne hat den Umsatzanstieg verursacht.
Shopify beschreibt Annotationen ausdrücklich als zusätzlichen Kontext, der dabei helfen kann, mögliche Einflüsse auf Kennzahlen zu untersuchen.
Kein Ersatz für einen kontrollierten Test
Eine Annotation ersetzt keinen A/B-Test und keine Vergleichsgruppe.
Wer beispielsweise ein neues Layout der Produktdetailseite veröffentlicht, kann die Conversion Rate vor und nach dem Start vergleichen. Der Vergleich allein zeigt jedoch noch nicht, ob das Layout für die Veränderung verantwortlich war.
Dafür müssten unter anderem saisonale Effekte, Geräte, Länder, Produkte und gleichzeitig durchgeführte Änderungen berücksichtigt werden.
Kein vollständiges Projektarchiv
Eine Annotation kann nur eine kurze Zusammenfassung enthalten. Technische Entscheidungen, Abnahmen, Fehleranalysen und Rollback-Anweisungen gehören weiterhin in ein Ticket- oder Projektsystem.
Die Annotation dient als sichtbare Verbindung zwischen dem Ereignis und den Kennzahlen. Sie ersetzt nicht die ausführliche Dokumentation des Ereignisses.
Keine frei beschreibbare Notizfunktion im Admin
Händler können laut aktueller Shopify-Dokumentation keine beliebigen eigenen Annotationen direkt im Shopify-Admin anlegen.
Annotationen werden entweder automatisch aus Aktivitäten des Shops erzeugt oder von einer installierten App erstellt. Wer unternehmensinterne Ereignisse markieren möchte, benötigt deshalb eine App, die diese Ereignisse unterstützt, oder eine individuell entwickelte Integration.
Voraussetzungen und Datenbasis
Der Bericht benötigt eine Zeitdimension
Annotationen können nur in Berichten erscheinen, deren horizontale Achse eine Zeitdimension verwendet. Dazu gehören beispielsweise Tages-, Wochen- und Monatsverläufe.
Visualisierungen ohne Zeitachse unterstützen keine Annotationen. Shopify nennt unter anderem Tabellen, Donut-Diagramme und Kohortenansichten.
Auch Multi-Store-Berichte zeigen derzeit keine Annotationen. Beim Export eines Berichts werden die Markierungen ebenfalls nicht übernommen. Für Unternehmensgruppen mit mehreren Shops und für externe Analysen bleibt deshalb häufig ein zusätzliches Ereignisregister notwendig.
Shopify erzeugt nicht in jedem Shop automatische Annotationen
Für automatisch von Shopify erzeugte Annotationen gelten Mindestanforderungen.
Der Shop muss in mindestens zwölf nicht aufeinanderfolgenden Wochen innerhalb der vergangenen sechs Monate durchschnittlich zehn oder mehr Bestellungen pro Woche erreicht haben. Zusätzlich muss innerhalb der vergangenen zwei Wochen mindestens eine Bestellung eingegangen sein.
Diese Voraussetzungen beziehen sich auf Shopify-erzeugte Annotationen. Für Annotationen, die von Apps erstellt werden, nennt Shopify in dieser Händlerdokumentation keine entsprechende Mindestbestellmenge.
Das bedeutet in der Praxis
Ein kleinerer oder saisonaler Shop kann möglicherweise App-Annotationen sehen, obwohl Shopify selbst noch keine automatischen Shop-Aktivitäten als Annotationen erzeugt.
Die verwendete App muss Annotationen unterstützen
Nicht jede installierte App erstellt automatisch Annotationen.
Der App-Anbieter muss die Funktion technisch implementieren und festlegen, welche Ereignisse an Shopify übermittelt werden. Eine Marketing-App könnte beispielsweise Kampagnen markieren. Eine Fulfillment-App könnte Lager- oder Dienstleisterwechsel dokumentieren.
Shopify zeigt bei app-erzeugten Einträgen den Namen oder das Symbol der verantwortlichen App an. Dadurch lässt sich nachvollziehen, aus welchem System der Kontext stammt.
Die gewählte Kennzahl muss zur Fragestellung passen
Eine Annotation ist nur hilfreich, wenn sie mit einer passenden Kennzahl betrachtet wird.
Bei einer neuen Versandkostenregel sollte nicht ausschließlich der Gesamtumsatz geprüft werden. Je nach Fragestellung sind zusätzlich diese Werte relevant
- Conversion Rate
- durchschnittlicher Bestellwert
- abgebrochene Checkouts
- Bestellungen nach Lieferland
- gewählte Versandarten
- Retourenquote
- Zeit bis zum Fulfillment
Bei einer neuen B2B-Preisliste können dagegen der Bestellwert, die Bestellhäufigkeit und der Umsatz pro Unternehmen wichtiger sein als die allgemeine Sitzungszahl.
Eine praktische Regel lautet
Wenn eine Annotation ein geschäftliches Ereignis beschreibt, sollte bereits vorher feststehen, an welcher Kennzahl eine mögliche Veränderung erkennbar wäre.
Consent beeinflusst einen Teil der ausgewerteten Daten
Die Annotation selbst benötigt keine Einwilligung eines Shopbesuchers. Sie beschreibt ein geschäftliches Ereignis.
Die daneben betrachteten Sitzungs- und Attributionsdaten können jedoch von Datenschutzeinstellungen beeinflusst werden. Wenn Besucher der Analyse nicht zustimmen, können weniger Sitzungen erfasst werden. Dadurch können auch sitzungsbasierte Conversion Rates und Marketingauswertungen unvollständig sein.
Bestellungen und Umsatz beruhen dagegen auf erfassten Transaktionen und müssen getrennt von sitzungsbasierten Kennzahlen bewertet werden.
Märkte und Zeitzonen müssen eindeutig sein
Internationale Shops sollten ein Ereignis nicht nur mit Kampagne gestartet beschreiben, wenn die Maßnahme ausschließlich in einem bestimmten Land lief.
Besser ist eine Formulierung wie
AT Sommerschlussverkauf gestartet
oder
US-Markt kostenlose Lieferung ab 100 USD aktiviert
Auch die Zeitzone muss eindeutig sein. Eine Kampagne, die um 23 Uhr deutscher Zeit startet, kann in einem anderen Markt einem anderen Kalendertag zugeordnet sein.
Technische Integrationen sollten Zeitstempel deshalb einheitlich speichern und für die Anzeige in der benötigten Zeitzone aufbereiten.
So nutzt man Annotationen im Shopify-Admin
Einen geeigneten Bericht öffnen
Öffnen Sie im Shopify-Admin den Bereich Analytics und anschließend Berichte.
Wählen Sie einen Bericht mit einer Zeitdimension. Geeignet sind beispielsweise Berichte mit täglichen, wöchentlichen oder monatlichen Verläufen.
Die Annotationen einblenden
Annotationen sind standardmäßig ausgeblendet.
Öffnen Sie im Bericht die Einstellungen der Visualisierung und aktivieren Sie die Anzeige der Annotationen. Alternativ können Sie in das Annotationen-Panel wechseln und dort die Markierungen sichtbar machen.
Unterhalb des Charts erscheint anschließend eine eigene Zeitachse. Kleine und größere Punkte zeigen, wie viele Ereignisse an einem Tag vorhanden sind.
Ereignistypen filtern
Über den Filter lassen sich einzelne Aktivitätstypen ein- oder ausblenden.
Für eine Kampagnenanalyse können beispielsweise diese Markierungen relevant sein
- Kampagnen
- Änderungen am Werbebudget
- Rabatte
- Produktstarts
- Landingpage-Starts
Für eine Fulfillment-Auswertung können diese Ereignisse sinnvoller sein
- Lieferantenwechsel
- Lagerwechsel
- Wechsel des Fulfillment-Dienstleisters
- externe Störungen
Die ausgewählten Filter werden mit dem Bericht gespeichert. Beim nächsten Öffnen wird die zuvor gewählte Ansicht erneut angezeigt.
Einzelne Einträge untersuchen
Bewegen Sie den Mauszeiger über einen Marker, um eine Zusammenfassung der Ereignisse für den jeweiligen Tag zu sehen.
Ein Klick auf den Marker öffnet die Details im Annotationen-Panel. App-erzeugte Ereignisse zeigen dort den Namen und das Symbol der App.
Shopify zeigt pro Aktivitätstyp bis zu zehn Ereignisse gleichzeitig an. Die Reihenfolge richtet sich nach der geschäftlichen Bedeutung. Bei Produkt-Ereignissen werden beispielsweise Produkte mit höheren Umsätzen zuerst aufgeführt.
Diese Begrenzung gilt nicht pauschal für alle Ereignisse eines Tages. Sie gilt für den jeweiligen Aktivitätstyp innerhalb des Panels.
Einen geeigneten Vergleichszeitraum wählen
Die Tage unmittelbar vor und nach einem Ereignis sind nicht immer der beste Vergleich.
Bei einer Osteraktion kann der Vergleich mit der Vorwoche irreführend sein. Ostern liegt jedes Jahr an einem anderen Datum. Bei internationalen Shops müssen zusätzlich lokale Feiertage, Verkaufstage und saisonale Muster berücksichtigt werden.
Für wiederkehrende Aktionen kann ein Vergleich mit demselben Ereignis des Vorjahres sinnvoller sein.
Auffällige Veränderungen eingrenzen
Wenn nach einer Annotation eine deutliche Veränderung sichtbar wird, sollte der Bericht schrittweise weiter aufgeteilt werden.
Praktische Regeln sind
- Wenn der Gesamtumsatz steigt, dann nach Markt und Vertriebskanal aufteilen.
- Wenn die Conversion Rate sinkt, dann nach Gerät und Landingpage unterscheiden.
- Wenn der Bestellwert steigt, dann Rabatte und Produktmix prüfen.
- Wenn die Fulfillment-Zeit steigt, dann Lagerstandort und Dienstleister vergleichen.
- Wenn der B2B-Umsatz sinkt, dann Unternehmen, Preislisten und Zahlungsbedingungen getrennt betrachten.
Die Annotation zeigt einen möglichen Ausgangspunkt. Die Segmentierung zeigt, wo die Veränderung tatsächlich aufgetreten ist.
Praxislogik für Aussagekraft und Pflegeaufwand
Nicht jede Änderung ist eine sinnvolle Annotation
In einem größeren Shop passieren täglich zahlreiche Änderungen.
Würde jede kleine Textkorrektur, jede Bestandsanpassung und jeder Produktimport markiert, wäre die Zeitachse schnell unübersichtlich.
Eine einfache Auswahlregel lautet
Wenn ein Ereignis eine sichtbare Veränderung einer geschäftlichen Kennzahl auslösen könnte, ist eine Annotation wahrscheinlich sinnvoll.
Die Korrektur eines einzelnen Schreibfehlers erfüllt diese Regel normalerweise nicht.
Ein neues Checkout-Angebot, ein Wechsel des Zahlungsanbieters oder eine deutliche Veränderung des Werbebudgets erfüllen sie eher.
Zeitpunkt und Zeitraum müssen zur Maßnahme passen
Ein Produkt-Launch ist häufig ein punktuelles Ereignis.
Eine Kampagne, eine Rabattaktion oder eine Störung kann dagegen über mehrere Tage laufen. Die API unterstützt deshalb einen Startzeitpunkt und ein optionales Enddatum.
Wird eine vierwöchige Kampagne nur an ihrem ersten Tag markiert, fehlt in den folgenden Wochen der unmittelbar sichtbare Kontext.
Der technische Ereignistyp ist nicht frei wählbar
Der sichtbare Titel einer Annotation kann individuell formuliert werden. Der technische Ereignistyp muss jedoch aus den von Shopify unterstützten Typen stammen.
Dazu gehören unter anderem Kampagnen, Produktstarts, Store-Redesigns, Preisaktionen, Lagerwechsel, Marktänderungen und externe Ereignisse.
Passt eine strategische Änderung in keine vorhandene Kategorie, kann eine App den allgemeinen Typ Other verwenden.
Für eine neue B2B-Preisliste könnte je nach Umsetzung der Typ Marktänderung passen. Ist das nicht der Fall, sollte die App Other verwenden und die Änderung im Titel klar beschreiben.
Gleichzeitige Änderungen erschweren die Interpretation
Wer am selben Tag ein neues Theme veröffentlicht, einen Rabatt startet, das Werbebudget erhöht und eine neue Zahlungsmethode aktiviert, kann einen späteren Effekt kaum einer einzelnen Änderung zuordnen.
Annotationen machen diese Überschneidung sichtbar. Sie lösen das Problem jedoch nicht.
Geschäftskritische Änderungen sollten deshalb nach Möglichkeit zeitlich getrennt werden. Ist das nicht möglich, sollten vorab zusätzliche Kennzahlen und Vergleichsgruppen festgelegt werden.
Apps können nicht unbegrenzt Annotationen speichern
Shopify begrenzt die Anzahl der Annotationen, die eine App für einen Shop anlegen kann.
Die offizielle API-Dokumentation nennt keine allgemeine feste Zahl. Wird das Limit erreicht, gibt die Schnittstelle den Fehler LIMIT_REACHED zurück. Shopify empfiehlt in diesem Fall, vorhandene Annotationen zu löschen oder den Support wegen eines höheren Limits zu kontaktieren.
Eine App sollte deshalb nicht jeden kleinen Vorgang automatisch als Annotation speichern.
Titel und Beschreibung sind begrenzt
Die aktuelle API-Dokumentation nennt diese Grenzen
- Titel mit maximal 75 Zeichen
- Beschreibung mit maximal 150 Zeichen
Der Titel erscheint am Marker im Chart. Die Beschreibung liefert zusätzlichen Kontext.
Allgemeine Formulierungen wie Update durchgeführt sind nach einigen Monaten kaum noch hilfreich.
Typische Praxisanwendungen
Kampagnen und Rabattaktionen
Eine Marketing-App kann den Anfang und das Ende einer Kampagne markieren.
Im Bericht lässt sich anschließend prüfen, wie sich Umsatz, Conversion Rate, Bestellwert und verkaufte Einheiten während dieses Zeitraums entwickelt haben.
Ein Shop startet beispielsweise 15 Prozent Rabatt auf ausgewählte Jacken. Der Umsatz steigt um 20 Prozent. Gleichzeitig sinkt der durchschnittliche Bestellwert.
Die Kampagne hat zeitlich mit mehr Umsatz und einem niedrigeren Bestellwert zusammengepasst. Ob sie wirtschaftlich erfolgreich war, lässt sich erst mit Margen, Werbekosten, Rabattkosten und Neukundenanteil beurteilen.
Produkt- und Kollektionsstarts
Bei einem Produkt-Launch kann die Annotation mit Umsatz, verkauften Einheiten und Sitzungen auf der Produktseite verglichen werden.
Zusätzlich sollte geprüft werden, ob der neue Artikel zusätzlichen Umsatz erzeugt oder Verkäufe von einem bestehenden Produkt verschoben hat.
Internationale Shops sollten getrennte Ereignisse verwenden, wenn ein Produkt nicht gleichzeitig in allen Märkten verfügbar wird.
Theme- und Landingpage-Änderungen
Eine App kann den Start einer neuen Landingpage oder ein größeres Store-Redesign markieren.
Nach der Veröffentlichung lassen sich Conversion Rate, Bestellwert und Sitzungen untersuchen. Sinkt die Conversion Rate, sollte geprüft werden, ob der Effekt nur auf Mobilgeräten, in bestimmten Browsern oder in einzelnen Märkten auftritt.
Eine automatisch von Shopify erzeugte Theme-Veröffentlichung und eine von einer App erzeugte Redesign-Annotation können dabei unterschiedliche Zwecke erfüllen.
Die automatische Markierung zeigt, wann ein Theme veröffentlicht wurde. Die App-Annotation kann zusätzlich beschreiben, welches Ziel der Relaunch hatte und welche Kennzahlen beobachtet werden sollen.
Wechsel des Lagers oder Fulfillment-Dienstleisters
Ein neuer Logistikpartner kann sich auf Fulfillment-Zeit, Stornierungen, Support-Anfragen und Retouren auswirken.
Eine Annotation macht sichtbar, ab welchem Zeitpunkt die neue operative Struktur aktiv war.
Das ist besonders hilfreich, wenn ein Problem nicht sofort, sondern erst mehrere Wochen später auffällt.
Neue Märkte
Beim Start in einem neuen Land ändern sich häufig mehrere Einstellungen gleichzeitig.
Dazu gehören
- Währung
- Preise
- Übersetzungen
- Versandregeln
- Zahlungsmethoden
- Steuern und Zölle
- Lieferzeiten
Eine Markt-Annotation schafft einen eindeutigen zeitlichen Ausgangspunkt.
In der späteren Auswertung sollte der neue Markt getrennt von bereits etablierten Ländern betrachtet werden.
Neue B2B-Regeln
Bei B2B-Shops können Änderungen an Preislisten, Zahlungszielen, Mindestbestellwerten und Unternehmensstandorten markiert werden.
Die Auswertung sollte anschließend nur die betroffenen B2B-Kunden enthalten. Werden D2C-Bestellungen einbezogen, kann der Effekt der B2B-Änderung im Gesamtergebnis verschwinden.
Regelwerke für laufende, geschäftskritische und reaktive Ereignisse
Laufende Maßnahmen
Regel
Wenn eine Maßnahme einen klaren Start und ein klares Ende hat, dann wird sie als Zeitraum angelegt.
Dazu gehören Kampagnen, saisonale Rabatte, zeitlich begrenzte Versandaktionen und Preisexperimente.
Die Beschreibung sollte beantworten
- Welcher Markt ist betroffen
- Welche Zielgruppe ist betroffen
- Was wurde verändert
- Welche Kennzahl soll geprüft werden
Ein geeignetes Beispiel lautet
DE kostenloser Versand ab 60 Euro. Bestellwert und Conversion prüfen.
Geschäftskritische Änderungen
Regel
Wenn eine Änderung mehrere Teams, Märkte oder Kernprozesse betrifft, dann erhält sie eine einheitliche Benennung und einen klaren Verantwortlichen.
Dazu gehören
- Theme-Relaunches
- ERP-Wechsel
- neue Lager
- Markteintritte
- Checkout-Umbauten
- neue B2B-Preislogiken
Für diese Ereignisse sollte vor dem Start festgelegt werden, welche Berichte nach einem Tag, einer Woche und einem Monat geprüft werden.
Reaktive Ereignisse
Regel
Wenn ein Vorfall Kennzahlen oder deren Messung beeinflussen kann, dann werden Beginn und Ende des Vorfalls markiert.
Dazu gehören
- Tracking-Ausfälle
- falsche Preise
- nicht verfügbare Zahlungsmethoden
- Fulfillment-Störungen
- fehlerhafte Produktdaten
- ausgefallene Schnittstellen
Ein geeignetes Beispiel lautet
AT und DE PayPal zwischen 10.20 Uhr und 12.45 Uhr nicht verfügbar.
Eine reaktive Annotation ersetzt keine vollständige Störungsdokumentation. Sie verbindet den Vorfall lediglich mit dem Analysezeitraum.
Text- und Template-Beispiele
Shopify bietet im dokumentierten Eingabeobjekt kein eigenes Feld für eine URL oder eine externe Ereignis-ID.
Eine App kann deshalb Titel, Beschreibung, Startzeitpunkt, Endzeitpunkt und Ereignistyp an Shopify übermitteln. Ausführliche Links und interne Referenzen sollten im Quellsystem gepflegt werden.
Eine kurze Ticketkennung kann in die Beschreibung aufgenommen werden, wenn dadurch das Zeichenlimit nicht überschritten wird.
Kampagne
Titel
DE Sommeraktion gestartet
Beschreibung
15 Prozent auf ausgewählte Kategorien bis 10. August. Umsatz und Bestellwert prüfen. Ticket MKT-241.
Technische Veröffentlichung
Titel
Neues Layout der Produktdetailseite veröffentlicht
Beschreibung
Neue Bildergalerie und Größenwahl aktiv. Conversion nach Gerät und Markt prüfen. Ticket WEB-118.
Logistik
Titel
Fulfillment für AT auf neues Lager umgestellt
Beschreibung
Bestellungen ab 1. August über Wien. Fulfillment-Zeit und Stornos prüfen. Ticket OPS-73.
Messfehler
Titel
Tracking-Ausfall im Checkout
Beschreibung
Checkout-Ereignisse von 10.20 Uhr bis 12.45 Uhr unvollständig. Funnel-Daten vorsichtig lesen. Ticket DATA-62.
B2B-Änderung
Titel
Neue B2B-Preisliste für Fachhändler aktiv
Beschreibung
DACH-Händler mit Staffelpreisen. Bestellwert und Bestellhäufigkeit prüfen. Ticket B2B-39.
Die Beispiele enthalten jeweils drei Informationen
- betroffener Markt oder betroffene Zielgruppe
- konkrete Änderung
- zu prüfende Kennzahl
Titel und Beschreibung sollten vor der Übermittlung automatisch gegen die Zeichenlimits geprüft werden.
Wann Annotationen sinnvoll sind und wann nicht
Sinnvoll bei klar abgrenzbaren Änderungen
Annotationen sind hilfreich, wenn ein Ereignis einen eindeutigen Zeitpunkt oder Zeitraum hat und eine geschäftliche Kennzahl beeinflussen könnte.
Das gilt besonders, wenn
- der Zeitpunkt später schwer rekonstruierbar wäre
- mehrere Teams denselben Kontext benötigen
- eine Maßnahme nach mehreren Wochen erneut bewertet werden soll
- das Ereignis aus einer externen App stammt
- ein Rollout mehrere Märkte betrifft
- eine Störung Berichtsdaten beeinflusst
Sinnvoll bei vielen beteiligten Systemen
In größeren Unternehmen liegen relevante Informationen häufig verteilt in Werbeplattformen, Ticketsystemen, Release-Werkzeugen, ERP, PIM, CRM und Fulfillment-Systemen.
Eine Annotation schafft einen gemeinsamen Bezugspunkt im Shopify-Bericht.
Sie ersetzt die anderen Systeme nicht. Sie zeigt aber, wann dort nach weiteren Informationen gesucht werden sollte.
Weniger sinnvoll bei alltäglichen Kleinständerungen
Wenn täglich hunderte Preise, Bestände oder Inhalte aktualisiert werden, sollte nicht jeder Vorgang eine eigene Annotation erzeugen.
Eine zusammengefasste Markierung ist dann hilfreicher.
Ein Beispiel lautet
Herbstsortiment und Preise für 240 Artikel aktualisiert.
Ungeeignet für einen sicheren Wirkungsnachweis
Wer beweisen möchte, dass eine Änderung einen Effekt verursacht hat, benötigt häufig einen kontrollierten Test oder eine Vergleichsgruppe.
Eine Annotation allein reicht dafür nicht.
Ungeeignet als dauerhaftes Projektarchiv
Die kurzen Texte eignen sich nicht für technische Ursachenanalysen, Entscheidungsprotokolle oder Freigaben.
Diese Informationen gehören weiterhin in ein dafür vorgesehenes System.
Fehler, die man vermeiden sollte
Zu viele Annotationen erzeugen
Wenn jede kleine Produktänderung und jede automatisch versendete Nachricht markiert wird, gehen wichtige Ereignisse zwischen unwichtigen Einträgen verloren.
Definieren Sie deshalb einen Mindestschwellwert.
Eine Annotation sollte nur erzeugt werden, wenn das Ereignis eine geschäftlich relevante Kennzahl beeinflussen könnte.
Vage Titel verwenden
Ein Titel wie Kampagne gestartet hilft nach sechs Monaten kaum weiter.
Besser ist
AT Neukundenkampagne mit kostenlosem Versand gestartet.
Nicht unterstützte Ereignistypen übermitteln
Der technische Typ einer Annotation kann nicht beliebig benannt werden.
Die App muss einen unterstützten Shopify-Typ verwenden. Passt kein Typ, sollte Other genutzt werden.
Der individuelle Inhalt gehört in Titel und Beschreibung.
Märkte und Zielgruppen vermischen
Eine Änderung, die nur B2B-Kunden in Deutschland betrifft, darf nicht so beschrieben werden, als wäre der gesamte Shop betroffen.
Markt, Kundengruppe und Kanal sollten direkt im Titel oder in der Beschreibung stehen.
Nur den Anfang dokumentieren
Bei Kampagnen oder Störungen sollte auch das Ende gepflegt werden.
Andernfalls entsteht der Eindruck, dass das Ereignis nur an einem Tag relevant war oder weiterhin aktiv ist.
Zeitliche Nähe mit Ursache verwechseln
Eine Kurve steigt nach einer Änderung. Das ist ein Anlass zur Analyse, aber noch kein Nachweis.
Prüfen Sie Vergleichszeiträume, saisonale Einflüsse und weitere gleichzeitige Änderungen.
Personenbezogene Daten speichern
Annotationen sollten keine Kundennamen, E-Mail-Adressen oder andere personenbezogene Informationen enthalten.
Statt einen einzelnen Großkunden namentlich zu nennen, sollte eine neutrale Beschreibung verwendet werden.
Ein Beispiel lautet
B2B-Umsatz durch Wegfall eines Großkunden beeinflusst.
Rollbacks nicht dokumentieren
Wird eine Änderung zurückgenommen, muss auch die Annotation aktualisiert werden.
Sonst wird eine spätere Entwicklung möglicherweise einer Funktion zugeschrieben, die zu diesem Zeitpunkt bereits deaktiviert war.
Moving Primates Perspektive
In größeren Shopify-Projekten fehlt häufig nicht die Datenmenge, sondern die Verbindung zwischen Kennzahlen und den kurz zuvor vorgenommenen Änderungen. Ein Risiko entsteht, wenn Apps jede Aktivität ungefiltert markieren oder Teams unterschiedliche Namen für dasselbe Ereignis verwenden. Dann entsteht zusätzlicher Lärm statt hilfreichem Kontext. Bewährt hat sich eine kleine verbindliche Ereignistaxonomie mit Markt, Art der Änderung, Zeitraum, Quellsystem und zu prüfender Kennzahl. Geschäftskritische Ereignisse sollten außerdem vor dem Go-live definiert werden. Werden Annotationen erst nach einem auffälligen Rückgang nachgetragen, steigt das Risiko einer unvollständigen oder verzerrten Dokumentation.
Technische Implikationen für größere Shops
Die API ist noch als Release Candidate dokumentiert
Apps können Annotationen über die Mutation analyticsAnnotationCreate in der Admin GraphQL API erstellen.
Stand 3. August 2026 dokumentiert Shopify diese Mutation in der API-Version 2026-10. Shopify kennzeichnet diese Version derzeit als Release Candidate. Die offizielle GraphQL-Referenz weist 2026-07 als aktuelle stabile Version aus.
Teams sollten deshalb vor einer produktiven Eigenentwicklung prüfen, welche API-Version verwendet werden kann und ob sich Felder oder Verhalten bis zur stabilen Veröffentlichung noch ändern.
Die sichtbare Händlerfunktion und die technische API-Version müssen dabei getrennt betrachtet werden.
Händler können app-erzeugte Annotationen bereits im Shopify-Admin sehen. Eine neue individuelle Integration sollte trotzdem gegen die tatsächlich verwendete API-Version geprüft werden.
Berechtigungen müssen getrennt vergeben werden
Shopify nennt die Berechtigungen read_analytics_annotations und write_analytics_annotations.
Zum Erstellen, Aktualisieren und Löschen einer Annotation benötigt die App den Schreibzugriff. Für reine Lesevorgänge ist der Lesezugriff vorgesehen.
Berechtigungen sollten nur angefordert werden, wenn die App sie tatsächlich benötigt.
Eine App, die ausschließlich eigene Ereignisse schreibt und später aktualisiert, benötigt eine andere Rechteplanung als ein internes Analysewerkzeug, das Annotationen verschiedener Quellen lesen soll.
Apps dürfen nur ihre eigenen Annotationen verändern
Eine App kann nur Annotationen aktualisieren oder löschen, die sie selbst erstellt hat.
Versucht sie, eine fremde Annotation zu verändern, gibt Shopify einen NOT_FOUND-Fehler zurück. Das gilt sowohl für Aktualisierungen als auch für Löschungen.
Das hat direkte Auswirkungen auf die Governance.
Eine Fulfillment-App kann nicht nachträglich die Annotation einer Marketing-App korrigieren. Fehler müssen durch die ursprünglich verantwortliche App behoben werden.
Ein Ereignismodell sollte vor der Entwicklung feststehen
Technisch lässt sich eine Annotation schnell erzeugen. Schwieriger ist die Entscheidung, wann sie erzeugt werden soll.
Ein geeignetes Ereignismodell definiert mindestens
- Ereignistyp
- Titelkonvention
- Startzeitpunkt
- optionalen Endzeitpunkt
- Beschreibung
- betroffenen Markt
- betroffenen Kanal
- betroffene Kundengruppe
- Quellsystem
- Regel für Aktualisierung und Löschung
- Aufbewahrungsregel
Ohne diese Regeln kann dasselbe Ereignis mehrfach aus verschiedenen Systemen angelegt werden.
Die externe Ereignis-ID muss in der App gespeichert werden
Das dokumentierte Eingabeobjekt enthält kein eigenes Feld für eine externe ID oder URL.
Das Quellsystem sollte deshalb für jedes Ereignis eine stabile eigene ID erzeugen. Die App speichert diese ID zusammen mit der von Shopify zurückgegebenen Annotation-ID in ihrer eigenen Datenbank.
Kommt derselbe Webhook erneut an, kann die App den vorhandenen Eintrag aktualisieren, statt eine zweite Annotation zu erstellen.
Dieses Vorgehen verhindert doppelte Einträge und erleichtert Rollbacks.
Aktualisierung und Löschung gehören zum Lebenszyklus
Eine Integration sollte nicht nur neue Annotationen erstellen können.
Sie muss auch berücksichtigen, dass
- sich das Ende einer Kampagne verschiebt
- ein Rollout abgebrochen wird
- ein Ereignis doppelt angelegt wurde
- eine Beschreibung korrigiert werden muss
- eine Störung früher oder später endet als erwartet
Shopify stellt dafür Mutationen zum Aktualisieren und Löschen bereit.
ShopifyQL ist ein ergänzender Baustein
ShopifyQL ist die Abfragesprache hinter Shopify Analytics.
Apps können damit Shopify-Daten abfragen und tabellarisch zurückerhalten. Für die Abfrage über die Admin GraphQL API ist der Zugriff read_reports erforderlich. Je nach abgefragten Kundendaten können zusätzliche Anforderungen für geschützte Kundendaten gelten.
Shopify ordnet Annotationen in eine größere Analytics-Plattform für Apps ein. Dazu gehören auch ShopifyQL, analysierbare Metafelder, Analytics Web Components und Kennzahlenziele.
App Events befinden sich laut Shopify noch im Early Access. Für das Verständnis und die Nutzung von Annotationen sind diese zusätzlichen Funktionen jedoch keine Voraussetzung.
Annotationen ersetzen keine externe Datenarchitektur
Größere Unternehmen benötigen weiterhin externe Systeme, wenn Shopify-Daten mit weiteren Informationen kombiniert werden sollen.
Dazu gehören beispielsweise
- Einkaufskosten
- Deckungsbeiträge
- vollständige Werbekosten
- Finanzbuchhaltung
- Callcenter-Daten
- stationäre Umsätze
- Lieferantendaten
- vollständige Retourenkosten
Die relevante Architekturfrage lautet
Welche operativen Entscheidungen können direkt in Shopify getroffen werden und welche benötigen systemübergreifende Daten.
Multi-Store-Strukturen benötigen eine zusätzliche Lösung
Da Annotationen derzeit nicht in Multi-Store-Berichten verfügbar sind, müssen Unternehmensgruppen mit mehreren Shops eine eigene Strategie vorsehen.
Mögliche Ansätze sind
- Ereignisse in jedem betroffenen Shop separat anlegen
- ein zentrales Ereignisregister außerhalb von Shopify führen
- shopübergreifende Analysen im Data Warehouse durchführen
- einheitliche Ereignis-IDs über alle Shops verwenden
Relevante Testfälle
Vor dem produktiven Einsatz sollten mindestens diese Fälle geprüft werden
- punktuelles Ereignis ohne Enddatum
- Ereignis mit Start- und Enddatum
- verschiedene Zeitzonen
- Wechsel zwischen Sommerzeit und Winterzeit
- Aktualisierung eines bestehenden Ereignisses
- Löschung und Rollback
- mehrfach zugestellter Webhook
- nicht unterstützter Ereignistyp
- zu langer Titel
- zu lange Beschreibung
- fehlende API-Berechtigung
- erreichtes App-Limit
- Versuch, eine fremde Annotation zu verändern
- Anzeige und Filterung im Shopify-Admin
- Deinstallation der erzeugenden App
Prüfliste vor dem Go-live
- Ist festgelegt, welche Entscheidung durch die Annotation erleichtert werden soll
- Werden nur Ereignisse markiert, die relevante Kennzahlen beeinflussen könnten
- Wird ein von Shopify unterstützter Ereignistyp verwendet
- Enthält der Titel Markt, Maßnahme und gegebenenfalls Zielgruppe
- Sind Startzeitpunkt, Endzeitpunkt und Zeitzone eindeutig
- Bleibt der Titel unter 75 Zeichen und die Beschreibung unter 150 Zeichen
- Enthält der Text keine personenbezogenen Daten
- Verhindert eine stabile externe Ereignis-ID doppelte Einträge
- Können eigene Annotationen aktualisiert und gelöscht werden
- Sind Berichte, Kennzahlen und verantwortliche Personen vor dem Start festgelegt
Zusammenfassung
- Apps können wichtige geschäftliche Ereignisse auf Zeitachsen in Shopify Analytics markieren.
- Shopify zeigt im Admin, welche App eine Annotation erzeugt hat.
- Annotationen verändern keine Kennzahlen, sondern ergänzen geschäftlichen Kontext.
- Sie zeigen zeitliche Zusammenhänge, beweisen aber keine Ursache.
- Die Anzeige funktioniert nur in Berichten mit einer Zeitdimension.
- Annotationen erscheinen nicht in Berichtsexporten und nicht in Multi-Store-Berichten.
- Für automatisch von Shopify erzeugte Annotationen gelten Mindestanforderungen an das Bestellvolumen.
- Händler können derzeit keine beliebigen eigenen Annotationen manuell im Admin anlegen.
- Apps müssen einen von Shopify unterstützten Ereignistyp verwenden.
- Titel sind auf 75 Zeichen und Beschreibungen auf 150 Zeichen begrenzt.
- Eine App kann nur ihre eigenen Annotationen aktualisieren und löschen.
- Größere Shops benötigen ein einheitliches Ereignismodell, klare Zuständigkeiten und einen Schutz vor Duplikaten.
Häufige Fragen
Was sind App-Annotationen in Shopify
App-Annotationen sind zeitliche Markierungen, die eine installierte App auf geeigneten Analytics-Charts hinterlegt. Sie zeigen beispielsweise, wann eine Kampagne, ein Produkt-Launch oder eine operative Änderung stattgefunden hat.
Was kosten App-Annotationen
In den hier verlinkten offiziellen Shopify-Unterlagen wird kein eigener Zusatzpreis für die Anzeige genannt. Kosten können jedoch durch die verwendete App oder die Entwicklung einer individuellen Integration entstehen.
Welche Daten werden benötigt
Für eine app-erzeugte Annotation werden mindestens ein unterstützter Ereignistyp, ein Titel und ein Startzeitpunkt benötigt. Optional können eine Beschreibung und ein Endzeitpunkt ergänzt werden.
Kann ich Annotationen selbst im Shopify-Admin anlegen
Nein. Laut aktueller Shopify-Dokumentation können Händler keine beliebigen eigenen Annotationen manuell hinzufügen. Sie werden von Shopify automatisch oder durch eine App erstellt.
Beweisen Annotationen, dass eine Kampagne funktioniert hat
Nein. Sie zeigen nur, dass ein Ereignis zeitlich mit einer Veränderung zusammenfiel. Für einen belastbaren Wirkungsnachweis sind zusätzliche Analysen oder kontrollierte Tests notwendig.
Wann sind Annotationen ungeeignet
Sie sind ungeeignet, wenn jede Kleinständerung markiert werden soll, keine passende Zeitdimension vorhanden ist oder ein vollständiger Wirkungsnachweis erwartet wird. Sie ersetzen außerdem kein Projektarchiv und keine systemübergreifende Datenplattform.
Linkliste
Shopify Changelog zu app-erzeugten Annotationen
Die offizielle Händlerankündigung erklärt den grundlegenden Nutzen und die sichtbare Zuordnung zur erzeugenden App.
Shopify Help Center zu Annotationen in Berichten
Die Dokumentation enthält Voraussetzungen, unterstützte Ereignistypen, Einschränkungen und die Schritte im Shopify-Admin.
Shopify Developer Changelog zu Analytics für Apps
Die technische Einordnung verbindet Annotationen mit ShopifyQL, Analytics Web Components und Kennzahlenzielen.
Shopify API zum Erstellen einer Annotation
Die Referenz beschreibt die Mutation, benötigte Berechtigungen, das App-Limit und mögliche Fehler.
Shopify API zum Eingabeobjekt einer Annotation
Die Referenz enthält Pflichtfelder und Zeichenlimits für Titel und Beschreibung.
Shopify API zum Aktualisieren einer Annotation
Die Dokumentation erklärt, wie eine App eigene Annotationen verändert und welche Einschränkungen gelten.
Shopify API zum Löschen einer Annotation
Die Referenz beschreibt das Löschen eigener Annotationen und den Fehler bei fremden Einträgen.
Shopify API zu ShopifyQL-Abfragen
Die Dokumentation erklärt die Ausführung von ShopifyQL über die Admin GraphQL API.
Shopify Help Center zu Sitzungs- und Consent-Abweichungen
Die Seite erklärt, wie Cookie-Einwilligungen Sitzungszahlen und sitzungsbasierte Conversion Rates beeinflussen können.
