Warum automatisierter Katalog‑Import Zeit und Vertrauen schafft
Händler wollen Produkte verfügbar machen, Affiliate‑Partner wollen verlässliche Informationen und Trackergebnisse. Ein standardisierter, automatisierter Import von Produktkatalogen vermeidet manuelle Fehler, beschleunigt das Onboarding und legt die Basis für sauberes Tracking sowie exakte Provisionsabrechnung. Diese Anleitung zeigt Schritt für Schritt, wie Händler CSV/JSON/ERP‑Exporte in Affilentra einbinden, feldgenau mappen, SKUs erhalten und Fehler systematisch behandeln — bis zum Roll‑out als Werbemittel‑Kampagne.
1. Vorbereitung: Dateiformat, Export und Grundregeln
Bevor importiert wird, klären Sie das Ursprungsformat und die Exportoptionen Ihres Shopsystems oder ERP:
- CSV: UTF‑8, Spaltentrenner angeben (Komma/Semikolon) und Textqualifizierer (" oder ').
- JSON: flaches Array pro Produkt oder verschachtelte Strukturen für Varianten; Schemabezeichnung prüfen.
- ERP‑Exporte: häufig XML oder CSV mit zusätzlichen Feldern (Lager, Lieferzeit, Hersteller‑IDs).
Empfehlung: Exportieren Sie zunächst eine kleine Stichprobe (50–200 Zeilen) für das Mapping und die Validierung, bevor Sie den Vollimport starten.
2. Feldmapping: Pflichtfelder und sinnvolle Ergänzungen
Definieren Sie ein Mapping zwischen Quellfeldern und dem Affilentra‑Schema. Mindestens erforderlich sind:
- SKU / Produkt‑ID (eindeutig): Erhält Priorität zur Duplikatserkennung und SKU‑Preservation.
- Produktname / Titel
- Preis
- Produkt‑URL (Affiliate‑Landing)
- Availability / Lagerstatus
Empfohlene zusätzliche Felder:
- Bild‑URL(s)
- Kategorie (Pfad möglich)
- Marke
- Variantendaten (Farbe, Größe) mit Verknüpfung zur Parent‑SKU
- Währung und Steuerkennzeichnung
Mapping‑Hinweis: Nutzen Sie in Affilentra die Möglichkeit, Quellfelder mehrfach zu referenzieren (z. B. Alternative Bildfelder) und Standardwerte zu definieren, wenn Daten fehlen.
3. SKU‑Preservation: IDs erhalten und Varianten handhaben
Die SKU ist der zentrale Schlüssel. Ziel: keine Neukreation von Produkten beim Import, sondern Abgleich.
- Deterministische SKU‑Regel: Verwenden Sie die vom Händler vergebenen SKUs 1:1. Falls Kürzungen oder Präfixe nötig sind, legen Sie eine Transformationsregel beim Mapping fest (z. B. Trim, Uppercase).
- Varianten: Modellieren Sie Parent‑/Child‑Beziehungen im Export (ParentSKU, ChildSKU). Affilentra erkennt dann Variantenfolgen und erhält die Parent‑SKU.
- Deduplication: Importprozesse sollten bei identischer SKU prüfen, ob es sich um ein Update (Preis, Bestand) oder um potenziell widersprüchliche Daten handelt. Bei Konflikten: Versionieren statt Überschreiben.
4. Validierung: Schemaprüfungen und Datenqualität
Validierung reduziert Rückfragen. Prüfen Sie auf drei Ebenen:
- Strukturelle Validierung: Existenz der Pflichtfelder, korrekte Datentypen (Zahlen, URLs, ISO‑Währungscodes).
- Semantische Validierung: Preis > 0, SKU nicht leer, gültige Bild‑URLs (http/https), sinnvolle Lagerwerte.
- Business‑Validierung: Kategorie‑Mapping existiert, Provisionstauglichkeit (z. B. keine Produkte, die vom Affiliate‑Programm ausgeschlossen sind).
Fehlermeldungen sollten zeilenbasiert sein und einen Fehlercode sowie eine klare Beschreibung liefern (z. B. "ROW 42: SKU fehlt", "ROW 7: Preis ungültig - Zeichen ',' statt '.'").
5. Fehlermeldungs‑Workflows: Automatisieren und eskalieren
Ein robuster Fehlerworkflow minimiert manuellen Aufwand:
- Automatische Benachrichtigung: Bei Validierungsfehlern wird der Händler per E‑Mail oder Webhook informiert; die Fehlermeldung enthält Beispielzeilen und eine Link zur Fehlerübersicht in Affilentra.
- Manuelle Korrekturoberfläche: Händler kann direkt in der Weboberfläche Zeilen editieren, Mapping anpassen oder Regeln (z. B. Preisformat) ändern und den fehlerhaften Datensatz erneut validieren.
- Retry‑Queue und Dead‑Letter: Nach automatischen Korrekturversuchen verbleiben nicht behebbaren Datensätze in einer Dead‑Letter‑Queue, damit sie nicht stören, aber später adressiert werden können.
- Audit‑Logs: Pro Importversion protokollieren, wer wann welche Daten geändert hat; wichtig für Nachvollziehbarkeit im Partnervertrieb.
6. Automatisierung: Zeitgesteuerte Imports und Webhooks
Für laufenden Betrieb empfehlen sich zwei Szenarien:
- Geplante Voll‑ und Inkrementalimporte (z. B. täglicher Preis‑ und Bestandsabgleich). Nutzen Sie Last‑Window‑Mechanismen, um große Exporte in Batches zu verarbeiten.
- Eventgetriebene Aktualisierung via Webhook oder SFTP: ERP meldet Änderungen sofort an Affilentra, sodass Partner aktuelle Informationen erhalten.
7. Kampagnen‑Rollout: Produkte als Werbemittel ausrollen
Sobald der Katalog sauber eingespielt ist, lassen sich Werbemittel automatisiert erzeugen:
- Campaign Templates: Erstellen Sie Vorlagen für Banner, Produktfeeds und Newsletter‑Blöcke, die Felder aus dem Katalog referenzieren (Bild, Titel, Preis, Landing‑URL).
- Gruppierung: Produkte nach Kategorie, Preissegment oder Marke zusammenfassen und gezielte Provisionen pro Gruppe zuweisen.
- Trackinglinks: Affilentra generiert persönliche Trackinglinks für Partner automatisch, basierend auf der Produkt‑URL und den Kampagneneinstellungen.
- Freigabeprozess: Händler können Kampagnenvorschläge prüfen und freigeben; nach Freigabe werden Werbemittel für Partner sichtbar.
8. Betrieb: Monitoring, Reconciliation, Auszahlungen
Kontinuierliche Kontrolle schützt vor Fehlvermarktung:
- Reconciliation: Abgleiche zwischen Produktdaten und gemessenen Conversions; Unstimmigkeiten (z. B. falsche Preise zum Kaufzeitpunkt) markieren und korrigieren.
- Monitoring: Dashboard für Fehlerraten beim Import, Anzahl verarbeiteter Zeilen und offene Dead‑Letter‑Einträge.
- Auszahlungshistorie: Partner sehen nachvollziehbare Abrechnungszeilen, die auf den validierten Produktdaten basieren.
Praktische Schritt‑für‑Schritt‑Checkliste für Händler
- Export: Erstellen Sie einen Probeexport (CSV/JSON) mit 50–200 Produkten.
- Mapping: Legen Sie Pflichtfelder fest (SKU, Titel, Preis, URL) und ordnen Sie die Spalten in Affilentra zu.
- Validierung: Starten Sie den Validierungs‑Durchlauf und beheben Sie alle Zeilenfehler in der UI.
- SKU‑Check: Prüfen Sie, dass SKUs identisch bleiben; definieren Sie Transformationsregeln falls nötig.
- Automatisieren: Planen Sie regelmäßige Imports oder richten Sie Webhooks/SFTP ein.
- Rollout: Erstellen Sie eine Kampagnen‑Vorlage und geben Sie diese frei für Partner.
Affilentra unterstützt diesen Prozess durch eine rollengetrennte Plattformarchitektur: Händler steuern Produkte und Konditionen, Partner erhalten Trackinglinks und Auszahlungstransparenz, und Betreiber verwalten die Software als self‑hosted Lösung.
Fazit und nächster Schritt
Ein klar strukturierter Importprozess mit sauberem Feldmapping, respektierter SKU‑Preservation und einem automatisierten Fehlermeldungs‑Workflow reduziert Fehler, beschleunigt das Onboarding und schafft eine verlässliche Basis für Kampagnen. Affilentra bietet die Funktionen zur Umsetzung dieser Schritte in einer self‑hosted Plattform mit separaten Rollen für Betreiber, Händler und Partner.
Handeln Sie jetzt: Wählen Sie Ihren Einstieg und starten Sie den automatisierten Katalog‑Import. Einstieg wählen: https://affilentra.de
Nächster Schritt
Affilentra selbst ausprobieren
Einheitliche Plattform, die Produktbereitstellung, Tracking, Conversion-Validierung, Provisionsberechnung und Auszahlung entlang klar getrennter Rollen transparent zusammenführt; Option zur self-hosted Installation mit Dauerlizenz ohne Umsatzbeteiligung; Händler behalten Kontrolle über Produkte, Konditionen und Werbemittel; Partner erhalten persönliche Trackinglinks und nachvollziehbare Auszahlungshistorie.