Hilfe
Einloggen

Zugriff auf detaillierte Daten in deinem Shopify-Adminbereich mithilfe von JSON

JSON, kurz für JavaScript Object Notation, ist ein Format zum Speichern und Übertragen von Daten, das häufig verwendet wird, wenn Daten von Servern an Webseiten gesendet werden. Auf den meisten Ressourcenseiten im Shopify-Adminbereich, wie z. B. auf den Seiten Bestellungen, Produkte oder Kund:innen, kannst du über JSON auf detailliertere Daten zugreifen.

Obwohl du für die Verwendung von JSON keine fortgeschrittenen Entwicklungsaufgaben ausführen musst, kann der Zugriff auf die JSON-Datei für eine bestimmte Ressource in deinem Shopify-Adminbereich dir helfen, detailliertere Informationen zu sammeln oder Probleme selbst zu beheben oder zu untersuchen. Du kannst beispielsweise die JSON-Datei für ein Produkt überprüfen, um dessen Varianten-ID zu finden, die für bestimmte Datenmigrationsaufgaben oder Theme-Code-Anpassungen erforderlich sein kann. Ein weiteres Beispiel: Du kannst die JSON-Datei einer Bestellung heranziehen, um die Datenvariable zu bestätigen, die du beim Erstellen eines automatisierten Workflows in Shopify Flow verwenden möchtest.

JSON wird am häufigsten von Entwickler:innen verwendet, aber auch Benutzer:innen mit begrenzten Programmierkenntnissen können davon profitieren, zu lernen, wie sie einige allgemeine JSON-Informationen in ihrem Shopify-Adminbereich finden und interpretieren.

Auf dieser Seite

Eine JSON-Datei neu formatieren

JSON-Rohdaten werden als eine lange Sequenz von verschachtelten Variablen und Klammern angezeigt, was für menschliche Benutzer:innen schwer zu lesen ist.

Um die JSON-Formatierung besser lesbar zu machen, stehen dir die folgenden Optionen zur Verfügung:

  • Installiere eine JSON-Viewer-Erweiterung in deinem Browser.
  • Nutze die „Pretty Print“-Funktion, die in den meisten modernen Webbrowsern standardmäßig verfügbar ist:

Screenshot einer JSON-Produktdatei mit angezeigten Beispiel-Produktinformationen. Die Kontrollkästchen-Einstellung „Pretty Print“ ist aktiv und oben links auf der Seite hervorgehoben.

Auf JSON-Dateien in deinem Shopify-Adminbereich zugreifen

Der Shopify-Adminbereich ist die zentrale Anlaufstelle für die Verwaltung aller Aspekte deines Geschäfts und ist so konzipiert, dass er standardmäßig nur die nützlichsten und relevantesten Informationen anzeigt. Die zusätzlichen Informationen, die bei Aktionen in deinem Adminbereich erfasst werden, werden in den .json-Dateien verschiedener Ressourcenseiten gespeichert. Diese zusätzlichen Details werden dir standardmäßig nicht angezeigt, weil diese Informationsmenge überfordernd und wenig hilfreich wäre und die Nutzung deines Adminbereichs erschweren würde.

Für die meisten Geschäftsaufgaben kannst du die vorhandenen Tools von Shopify verwenden, um die Informationen deines Shops abzurufen und zu interpretieren. Es kann jedoch gelegentlich hilfreich sein, die spezifischen Informationen zu bestimmten Ressourcen, wie Produkten oder Bestellungen, zu überprüfen, wenn du bei der Fehlerbehebung herausfinden musst, warum oder wann etwas passiert ist.

Beispiel: Auf die JSON-Datei einer Bestellung zugreifen

In diesem Beispiel greifst du auf die JSON-Datei einer Bestellung in deinem Shopify-Adminbereich zu.

Schritte:

  1. Gehe in deinem Shopify-Adminbereich zu Bestellungen.

  2. Klicke auf eine beliebige Bestellung in der Liste Bestellungen.

  3. Füge .json am Ende der URL-Adresse in der Adressleiste des Browsers hinzu. Sie sieht dann ähnlich wie in diesem Beispiel aus:

https://admin.shopify.com/store/{example-shop-name}/orders/12345678901234.json
  1. Drücke die Eingabetaste, um die Seite in der JSON-Formatierung neu zu laden.
  2. Optional: Wenn du keine JSON-Viewer-Erweiterung in deinem Browser installiert hast, aktiviere die Einstellung Pretty-print in deinem Browser, um die JSON-Datei benutzerfreundlicher zu machen. Erfahre mehr über das Neuformatieren einer JSON-Datei.

Du wirst feststellen, dass viele erwartete Informationen zur Bestellung angezeigt werden, wie z. B. die mit der Bestellung verknüpften Angaben zu "currency" und "line_items". Es sind aber auch viele andere detaillierte Informationen enthalten, wie z. B. die "client_details" aus der Browsersitzung der Kundin oder des Kunden, als die Bestellung aufgegeben wurde. Diese Art von Informationen ist für das allgemeine Sitzungs-Tracking und die Analysen von Marketingplattformen nützlich, aber nicht notwendig, damit du die Bestellung bearbeiten und ausführen kannst.

Spezifische Felder in einer JSON-Datei anzeigen

Du kannst die Anzeige von JSON-Dateien auf bestimmte Felder beschränken, was die Interpretation von Informationen erleichtert, wenn du weißt, welche bestimmten Eigenschaften du einbeziehen möchtest. Füge am Ende einer beliebigen JSON-Datei-URL in der Adressleiste des Browsers ?fields= hinzu und gib dann die Eigenschaftsnamen, die du anzeigen möchtest, in beliebiger Reihenfolge und durch Kommas getrennt ein.

Um beispielsweise die ID, die Kundeninformationen, den Gesamtpreis und die Tags einer Bestellung anzuzeigen, füge ?fields=id,customer,total_price,tags am Ende der URL der JSON-Datei hinzu, wie im folgenden Beispiel:

https://admin.shopify.com/store/{example-shop-name}/orders/12345678901234.json?fields=id,customer,total_price,tags

Andere JSON-Ressourcen verwenden

Du kannst die folgenden JSON-Ressourcen verwenden, um spezifische Informationen in deinem Shopify-Adminbereich anzuzeigen:

  • Produktanzahl: Füge /count.json am Ende der URL der Produktliste hinzu, um die Gesamtzahl der Produkte anzuzeigen. Die vollständige URL sollte lauten:
https://admin.shopify.com/store/{example-shop-name}/products/count.json
  • Transaktionen: Füge /transactions.json am Ende der URL einer Bestellseite hinzu, um nur die Transaktionsinformationen der Bestellung anzuzeigen. Erfahre mehr über die Ressource „Transaktionen“.
  • Fulfillments: Füge /fulfillments.json am Ende der URL einer Bestellseite hinzu, um nur die Fulfillment-Informationen der Bestellung anzuzeigen. Erfahre mehr über die Ressource „Fulfillment“.
  • Abgebrochene Checkouts: Füge .json am Ende der URL eines abgebrochenen Checkouts hinzu, um detaillierte Informationen über den abgebrochenen Checkout anzuzeigen. Erfahre mehr über die Ressource „Abgebrochener Checkout“.

Häufige JSON-Eigenschaften für die Fehlerbehebung

In der folgenden Tabelle sind JSON-Eigenschaften aufgeführt, die du zur Hilfe bei der Fehlerbehebung für verschiedene Ressourcentypen heranziehen kannst. Wenn du zum Beispiel bestätigen möchtest, wann ein bestimmtes Produkt veröffentlicht wurde, kannst du die JSON-Datei des Produkts auf die Eigenschaft published_at überprüfen, die Datum und Uhrzeit im ISO-8601-Format anzeigt.

Diese Tabelle enthält nicht alle möglichen JSON-Ressourcen oder -Eigenschaften, die im Shopify-Adminbereich gespeichert sind. Ziehe daher die Shopify-Entwicklerdokumentation für Definitionen von Ressourcen oder Eigenschaften zu Rate, die hier nicht aufgeführt sind.

Listet einige Beispiele für Admin-Ressourcen und die ihnen zugeordneten allgemeinen Eigenschaften auf, einschließlich Definitionen, wofür sie bei der Fehlerbehebung verwendet werden könnten.
RessourceJSON-EigenschaftDefinition
Produkt
"product": {
  "created_at"
Datum und Uhrzeit der ursprünglichen Erstellung des Produkts.
"product": {
  "published_at"
Datum und Uhrzeit, zu dem der Status des Produkts auf Aktiv gesetzt wurde.
"product": {
  "updated_at"
Der letzte Zeitpunkt (Datum und Uhrzeit), zu dem das Produkt aktualisiert wurde. Dies schließt Änderungen an der Produktbeschreibung, dem Titel oder den SEO-Informationen ebenso ein wie automatische Aktualisierungen, zum Beispiel Inventaränderungen, wenn ein Produkt gekauft wird.
Variante
"product": {
  "variants": [
    {
    "created_at"
Datum und Uhrzeit der ursprünglichen Erstellung der Variante. Dieser Zeitpunkt kann vom Erstellungszeitpunkt des Produkts abweichen.
"product": {
  "variants": [
    {
    "updated_at"
Das aktuellste Datum und die aktuellste Uhrzeit der Aktualisierung der Variante. Dieser Zeitpunkt kann vom Zeitpunkt der letzten Aktualisierung des Produkts abweichen.
"product": {
  "variants": [
    {
    "inventory_quantity"
Der aktuelle Datenbankwert und was für Kund:innen zum Kauf verfügbar ist. Dieser Wert kann negativ sein, wenn der Varianteninventar nicht verfolgt wird oder wenn eingestellt ist, über den Bestand zu verkaufen.
"product": {
  "variants": [
    {
    "old_inventory_quantity"
Der Datenbankwert vor dem letzten updated_at-Datum der Variante.
Bestellung
"order": {
   "line_items": [
    {
    "requires_shipping"
Wird als true oder false angezeigt. Dies gibt die Versandeinstellungen des Produkts oder der Variante zum Zeitpunkt der Bestellung an.
"order": {
   "line_items": [
    {
    "taxable"
Wird als true oder false angezeigt. Dies gibt an, wie für das Produkt oder die Variante zum Zeitpunkt der Bestellung die Erhebung von Steuern eingestellt war.
"order": {
   "line_items": [
    {
    "variant_inventory_management"
Wird als shopify, amazon_marketplace_web, null oder als Wert eines externen Anbieters angezeigt, je nachdem, welcher Fulfillmentdienst für die Verfolgung des Produktinventars eingestellt ist. Der Wert null bedeutet, dass das Produkt zum Zeitpunkt der Bestellung nicht verfolgt wurde.
"order": {
   "line_items": [
    {
    "fulfillable_quantity"
Zeigt an, wie viel Inventar vom System noch reserviert ist, um die Bestellung abzuschließen. Dies entspricht nicht dem aktuellen Varianteninventar.
"order": {
   "line_items": [
    {
    "quantity"
Die Anzahl der gekauften Produkte oder Varianten.
"order": {
   "line_items": [
    {
    "tax_lines"
In den Vereinigten Staaten werden hier Werte für Bundesstaat, Bezirk und Gemeinde angezeigt. Wenn keine Steuerpositionen angezeigt werden, aber auf die Bestellung eine Steuer erhoben wurde, bedeutet dies, dass die Steuer auf die Versandkosten erhoben wurde.
Kund:in
"customer": {
  "created_at"
Datum und Uhrzeit der ursprünglichen Erstellung des Kundenkontos.
"customer": {
  "updated_at"
Das aktuellste Datum und die aktuellste Uhrzeit der Aktualisierung des Kundenprofils.

Metafelder in JSON

Metafelder sind eine flexible Möglichkeit, zusätzliche benutzerdefinierte Informationen an eine Shopify-Ressource anzuhängen, wie z. B. Produkte oder Kollektionen. Einige Beispiele für Daten, die mit Metafeldern gespeichert werden, sind Produktspezifikationen, Größentabellen, herunterladbare Dokumente, Veröffentlichungsdaten, Bilder oder Teilenummern. Erfahre mehr über die Verwendung von Metafeldern.

Du kannst /metafields.json am Ende einer URL einer unterstützten Ressourcenseite hinzufügen, um die Metafelder anzuzeigen, die mit dieser Ressource verknüpft sind. In der folgenden Tabelle findest du einige Beispiele für Ressourcen und URL-Formate, mit denen du Metafeldinformationen mithilfe von JSON anzeigen kannst.

Liste einiger Beispiel-Admin-Ressourcen mit einer Beispiel-URL für eine JSON-Metafeld-Datei.
Beispiel-RessourcentypBeispiel-URL
Intelligente Kollektionhttps://admin.shopify.com/store/{your-store-name}/collections/{collection-id}/metafields.json
Kund:inhttps://admin.shopify.com/store/{your-store-name}/customers/{customer-id}/metafields.json
Bestellunghttps://admin.shopify.com/store/{your-store-name}/orders/{order-id}/metafields.json
Seitehttps://admin.shopify.com/store/{your-store-name}/pages/{page-id}/metafields.json
Produkthttps://admin.shopify.com/store/{your-store-name}/products/{product-id}/metafields.json
Variantehttps://admin.shopify.com/store/{your-store-name}/products/{product-id}/variants/{variant-id}/metafields.json
Produktbildhttps://admin.shopify.com/store/{your-store-name}/metafields.json?metafield[owner_id]={id}&metafield[owner_resource]=product_image

Hinweis: Produktbild-Metafelder können nur über die API hinzugefügt werden. Ersetze die {id} und andere Platzhalter in der URL durch die tatsächlichen Werte aus deinen API-Abfragen.


Shophttps://admin.shopify.com/store/{your-store-name}/metafields.json

Eine vollständige Liste der Ressourcen, die Metafelder haben können, und der spezifischen Arten von Eigenschaften, die für jeden Ressourcentyp gespeichert werden, findest du in der JSON-Ressource „Metafeld“ in der Shopify-Entwicklerdokumentation.

Ereignisse in JSON

Ereignisse werden von einigen Shopify-Ressourcen generiert, wenn bestimmte Aktionen abgeschlossen sind, wie z. B. die Erstellung eines Blog-Beitrags, das Fulfillment einer Bestellung oder das Hinzufügen eines Produkts.

Du kannst /events.json am Ende einer URL einer unterstützten Ressourcenseite hinzufügen, um die Ereignisse anzuzeigen, die mit dieser Ressource verknüpft sind. In der folgenden Tabelle findest du einige Beispiele für Ressourcen und URL-Formate, mit denen du Ereignisinformationen mithilfe von JSON anzeigen kannst.

Liste einiger Beispiel-Admin-Ressourcen mit einer Beispiel-URL für eine JSON-Ereignisdatei.
Beispiel-RessourcentypBeispiel-URL
Bestellunghttps://admin.shopify.com/store/{your-store-name}/orders/{order-id}/events.json

In dieser Datei werden die Urheber:innen (author) von Ereignissen aufgeführt. Sie informiert dich darüber, welche Benutzer:innen bestimmte Aktionen ausgeführt haben, z. B. wer oder was ein Produkt veröffentlicht hat.


Produkthttps://admin.shopify.com/store/{your-store-name}/products/{product-id}/events.json

In dieser Datei werden die Urheber:innen (author) von Ereignissen aufgeführt. Sie informiert dich darüber, welche Benutzer:innen bestimmte Aktionen ausgeführt haben, z. B. wer oder was eine Zahlung als bezahlt markiert hat.


Shophttps://admin.shopify.com/store/{your-store-name}/events.json?limit=250

Dieses URL-Format zeigt die 250 letzten Ereignisse an, die in deinem Shop stattgefunden haben. Zu den Ereignissen gehören unter anderem die Erstellung oder Aktualisierung von Produkten, das Löschen von Seiten und die Aktualisierung von Varianten.


Eine vollständige Liste der Ressourcen, die Ereignisse erstellen können, und der spezifischen Ereignisse, die für jeden Ressourcentyp erstellt werden, findest du in der JSON-Ressource „Event“ in der Shopify-Entwicklerdokumentation.