Verwenden Sie die API von Omnisend, um benutzerdefinierte E-Commerce-Plattformen (wie Magento oder OpenCart) zu verbinden oder fortschrittliche Integrationen zu erstellen, die Kontakt-, Bestell-, Produkt- und Veranstaltungsdaten zwischen Ihrem Webshop und Omnisend übertragen.
Dieser Artikel erklärt, wann die API verwendet werden sollte, was sie tut und welchen Integrationsleitfäden zu folgen ist.
Bevor Sie beginnen
✅ Dieser Leitfaden ist für:
Magento, OpenCart oder maßgeschneiderte E-Commerce-Plattformen.
Entwickler, die Integrationen von Drittanbieter-Apps erstellen.
Erfahrene Benutzer, die benutzerdefinierte Funktionen hinzufügen (Webhooks, benutzerdefinierte Ereignisse).
❌ Nicht erforderlich für:
Shopify, WooCommerce oder BigCommerce (diese Plattformen integrieren sich automatisch – keine API-Einrichtung erforderlich).
Voraussetzungen:
Erstellen Sie einen API-Schlüssel (erforderlich für alle API-Anfragen).
Grundkenntnisse über REST-APIs und JSON (oder einen Entwickler beauftragen).
Zugriff auf das Backend/deinen Code des Shops.
Was ist die Omnisend API?
Die Omnisend API ermöglicht es Ihrem Der Webshop oder Ihrer App, automatisch Daten an Omnisend zu senden und Daten von Omnisend abzurufen – manuelle Uploads sind nicht erforderlich.
Zum Beispiel, wenn der Kunde eine Bestellung aufgibt, übergibt die API die Bestelldetails an Omnisend, damit Sie die Bestellbestätigungs-E-Mails auslösen können. Oder wenn ein Besucher Produkte durchsucht, verfolgt die API ihre Aktivitäten für Der Browsingabbruch-Workflows.
Omnisend bietet zwei API-Typen an:
REST API – überträgt Daten zwischen dem Backend Ihres Webshops und Omnisend (Kontakte, Bestellungen, Produkte, Ereignisse).
JavaScript API – verfolgt die Website-Aktivität (Seitenaufrufe, Produktansichten, Warenkorb-Hinzufügungen) für Verhaltens-Workflows.
Wann die API verwenden
Verwenden Sie die API, wenn:
Du betreibst eine maßgeschneiderte E-Commerce-Plattform (nicht Shopify/WooCommerce/BigCommerce).
Du bist auf Magento, OpenCart oder einer anderen Plattform ohne ein natives Omnisend-Plugin.
Sie möchten benutzerdefinierte Integrationen erstellen (z. B. Kontakte aus einem CRM synchronisieren, Workflows basierend auf App-Ereignissen auslösen).
Du benötigst erweiterte Funktionen wie Webhooks, benutzerdefinierte Ereignisverfolgung oder Echtzeit-Datensynchronisierung.
Verwenden Sie die API nicht, wenn:
Du bist auf Shopify, WooCommerce oder BigCommerce – verwende stattdessen das native Plugin (schnellere Einrichtung, kein Coding).
Erste Schritte
Schritt 1. Überprüfen Sie die API-Dokumentation:
Schnellstartanleitung – Grundlagen der REST API (Authentifizierung, Endpunkte, Anfrageformat).
JavaScript API-Leitfaden – Einrichtung des Website-Trackings.
Schritt 2. Erstellen Sie einen API-Schlüssel:
Befolge diesen Leitfaden, um einen Schlüssel mit den richtigen Berechtigungen (Kontakte, Bestellungen, Produkte, Ereignisse) zu erstellen.
Schritt 3. Testen Sie Ihre Integration:
Verwenden Sie API-Protokolle (Webshop-Einstellungen → API-Protokolle), um Anfragen zu debuggen und zu bestätigen, dass die Daten korrekt übertragen werden.
Funktion-spezifische Integrationsanleitungen
Sobald Ihre grundlegende API-Verbindung funktioniert, vervollständigen Sie diese Leitfäden, um spezifische Omnisend-Funktionen zu aktivieren:
Der Kontakt & Daten-Synchronisierung. Kontaktinformationen an Omnisend übergeben– Abonnentenlisten synchronisieren, benutzerdefinierte Eigenschaften hinzufügen, Kontaktdaten aktualisieren.
Bestellungen & Der Warenkorb Wiederherstellung:
Aktivieren Sie die Workflows für den Warenkorbabbruch – übergeben Sie die Warenkorbdaten, um E-Mails/SMS für den Warenkorbabbruch auszulösen.
Aktivieren Sie die Bestellbestätigung und Versandbestätigung Workflows – übergeben Sie Bestelldaten, um transaktionale E-Mails auszulösen.
Das Produkt-Tracking:
Den Produktwähler einrichten – lassen Sie Benutzer Produkte im Der E-Mail-Builder und in Automatisierungs-Workflows auswählen.
Aktivieren Sie Workflows für den Produktabbruch & Browsingabbruch – verfolgen Sie Produktansichten und Hinzufügungen zum Warenkorb.
Benutzerdefinierte Ereignisse. Trigger benutzerdefinierte Ereignisse für Die Automatisierung Workflows– benutzerdefinierte Daten übergeben (z. B. "Testversion gestartet", "Abonnement erneuert"), um Workflows auszulösen.
Analytik & Berichterstattung (Beta). Analysedaten mit der Statistics API exportieren– Abfrage der Kampagnen- und Workflow-Leistung, Engagement-Metriken, Umsatzzuordnung, produktbezogene Verkaufsmetriken (insgesamt und zugeordnete Bestelleinheiten), Zustellbarkeit und Daten zum Wachstum der Zielgruppe für BI-Tools, benutzerdefinierte Dashboards oder Datenbankintegrationen.
Formulare & Leistungsüberwachung (Beta). Formulardaten mit der Forms API exportieren– Formularlisten, Leistungsberichte, Kontaktübermittlungen und A/B-Testdaten für benutzerdefinierte Dashboards oder Drittanbieter-Integrationen abrufen.
Ereignisdaten & Eigenschaftenwerte. Abfrage von Ereigniseigenschaftswerten– Werte abrufen, die in den ausgewählten Eigenschaften unterstützter Standardereignisse gespeichert sind.Verwenden Sie diesen Endpunkt, um Filter, Dropdowns oder Segmentfilter mit Werten zu füllen, die bereits in den Ereignisdaten der Marke vorhanden sind.Benutzerdefinierte Ereignisse werden noch nicht unterstützt.
Häufig gestellte Fragen
Benötige ich Programmierkenntnisse, um die API zu verwenden?
Ja. Du musst REST-APIs, JSON und den Backend-Code deines Shops verstehen. Wenn Sie kein Entwickler sind, engagieren Sie einen oder verwenden Sie eine native Integration (Shopify/WooCommerce/BigCommerce).
Was ist der Unterschied zwischen REST API und JavaScript API?
REST API überträgt Daten zwischen Servern (Kontakte, Bestellungen, Produkte)
JavaScript API verfolgt das Nutzerverhalten auf Ihrer Website (Seitenaufrufe, Produktansichten, Warenkorb-Hinzufügungen)
Die meisten Integrationen verwenden beides.
Kann ich die API zusammen mit nativen Integrationen verwenden?
Ja. Zum Beispiel können Shopify-Nutzer die JavaScript API verwenden, um benutzerdefinierte Ereignisse zu verfolgen, obwohl die Kernintegration (Bestellungen, Kontakte) automatisch erfolgt.
Wie behebe ich API-Fehler?
Überprüfen API-Protokolle (Webshop-Einstellungen → API-Protokolle) um Anforderungs-/Antwortdetails zu sehen. Häufige Probleme: falscher API-Schlüssel, fehlende erforderliche Felder und überschrittenes Rate-Limit.
Haben Sie weitere Fragen? Kontaktieren Sie uns unter [email protected] oder im In-App-Chat.