Import/Export-System

Verfügbar in:

• Post Affiliate Pro
• Post Affiliate Pro Ultimate
• Post Affiliate Network

Überblick

Das Import/Export-System in Post Affiliate Pro bietet leistungsstarke Werkzeuge für Massen-Datenoperationen. Ob Sie von einer anderen Plattform migrieren, große Datensätze verwalten oder Daten zwischen Systemen synchronisieren - die Import/Export-Funktionalität spart Zeit und reduziert manuelle Fehler.

Das System unterstützt Import und Export von:

• Partner - Benutzerkonten mit allen Profildaten und Auszahlungsoptionen
• Kampagnen - Kampagneneinstellungen, Provisionstypen, Gruppen und Sätze
• Banner - Bannerdefinitionen und Werbematerialien
• Transaktionen - Verkäufe, Provisionen und Transaktionsdatensätze
• Themes - Benutzerdefinierte Panel-Themes und Vorlagen

Partner-Import/Export

Partner exportieren

Die Partner-Exportfunktion erstellt eine umfassende CSV-Datei mit allen Partnerdaten Ihrer Installation. Der Export umfasst:

Kern-Partnerfelder:

• Benutzer-ID (eindeutige Kennung)
• Referenz-ID (refid)
• Benutzername (E-Mail)
• Vorname und Nachname
• Kontostatus (ausstehend, genehmigt, abgelehnt)
• Eingefügt am und Genehmigt am
• Übergeordnete Benutzer-ID (für Multi-Tier-Strukturen)
• Mindestauszahlung Schwellenwert
• Notizen und Foto

Benutzerdefinierte Datenfelder:

• Data1 bis Data25 (benutzerdefinierte Partnerfelder)

Auszahlungsoptionen: Der Export enthält auch einen separaten Abschnitt für Auszahlungsoptionen mit:

• Benutzer-ID
• Auszahlungsfeldname
• Auszahlungsfeldwert

Partner importieren

Beim Import von Partnern verarbeitet das System die CSV-Datei und erstellt entweder neue Partnerkonten oder aktualisiert bestehende basierend auf der Benutzer-ID.

Erforderliche Felder:

• !USERID - Die eindeutige Kennung für den Partner

Hauptverhalten:

• Wenn ein Partner mit der angegebenen Benutzer-ID existiert, wird der Datensatz aktualisiert
• Wenn die Benutzer-ID nicht existiert, wird ein neues Partnerkonto erstellt
• Leere Statusfelder werden standardmäßig auf “Genehmigt” gesetzt
• Das System behandelt automatisch Eltern-Benutzer-Beziehungen für Multi-Tier-Strukturen
• Passwörter können mit oder ohne Salt-Verschlüsselung importiert werden

Feldzuordnung: Die CSV-Kopfzeile definiert Feldnamen im Format !FELDNAME. Zum Beispiel:

!USERID,!REFID,!USERNAME,!FIRSTNAME,!LASTNAME,!STATUS

CSV-Format Beispiel

!USERID,!REFID,!USERNAME,!FIRSTNAME,!LASTNAME,!STATUS,!MINIMUMPAYOUT
abc12345,REF001,john@example.com,John,Smith,A,50.00
def67890,REF002,jane@example.com,Jane,Doe,A,100.00

Statuswerte:

• A - Genehmigt
• P - Ausstehend
• D - Abgelehnt

Kampagnen-Import/Export

Was wird exportiert

Der Kampagnenexport erstellt ein umfassendes Backup Ihrer Kampagnenstruktur einschließlich:

Kampagnen:

• Kampagnen-ID, Name und Beschreibung
• Typ und Status
• Eingefügt am
• Anzeigereihenfolge
• Cookie-Lebensdauer und Überschreibungseinstellungen
• Geo-Targeting-Einstellungen (Länder, Anzeigeregeln)
• Gültige Datumsbereichseinstellungen
• Logo-URL und Produkt-ID

Provisionstypen:

• Provisionstyp-ID
• Typ (Verkauf, Lead, Klick, etc.)
• Name und Code
• Status und Genehmigungseinstellungen
• Wiederholungs-Voreinstellungen
• Optionen zur Behandlung von Null-Provisionen
• Länder- und Stadtbeschränkungen

Provisionsgruppen:

• Gruppen-ID und Name
• Kampagnenzuordnung
• Standardgruppen-Kennzeichnung

Provisionen:

• Provisions-ID
• Stufe
• Provisionstyp (Prozentsatz, fest)
• Wert
• Zuordnung zu Provisionstypen und Gruppen

Kampagnen importieren

Der Kampagnenimport unterstützt das Erstellen oder Aktualisieren von Kampagnen mit allen zugehörigen Provisionsstrukturen.

Erforderliche Felder nach Abschnitt:

• Kampagnen: !CAMPAIGNID
• Provisionstypen: !COMMTYPEID
• Provisionsgruppen: !COMMISSIONGROUPID
• Provisionen: !COMMISSIONID

Der Import verarbeitet jeden Abschnitt nacheinander und stellt ordnungsgemäße Beziehungen zwischen Kampagnen, Provisionstypen, Gruppen und Provisionssätzen sicher.

Banner-Import/Export

Banner-Datenstruktur

Banner-Import/Export behandelt die Metadaten und Konfiguration Ihrer Werbematerialien:

Exportierte Felder:

• Banner-ID
• Konto-ID und Kampagnen-ID
• Bannertyp (Bild, HTML, Textlink, etc.)
• Status (aktiv/inaktiv)
• Name und Beschreibung
• Ziel-URL
• Größenabmessungen
• Datenfelder (Data1-Data4) für typspezifische Inhalte
• Anzeigereihenfolge
• SEO-String
• Wrapper-ID
• Eingefügt am

Wichtiger Hinweis: Der Banner-Import/Export behandelt nur Definitionen, nicht die physischen Bilddateien oder Assets. Stellen Sie sicher, dass referenzierte Bilder nach dem Import unter den angegebenen URLs verfügbar sind.

Erforderliches Feld:

• !BANNERID - Eindeutige Banner-Kennung

CSV-Format Beispiel

!BANNERID,!CAMPAIGNID,!TYPE,!NAME,!DESTINATIONURL,!STATUS
ban12345,camp001,I,Sommer-Sale-Banner,https://example.com/sale,A
ban67890,camp001,T,Textlink-Promo,https://example.com/promo,A

Bannertypen:

• I - Bildbanner
• T - Textlink
• H - HTML-Banner
• Und andere unterstützte Typen

Transaktionsimport

Überblick

Der Transaktionsimport ist eine leistungsstarke Funktion für das Massenladen von Verkäufen, Provisionen und anderen Transaktionsdatensätzen. Dies ist besonders nützlich für:

• Migration historischer Daten von anderen Plattformen
• Import von Offline-Verkäufen
• Stapelverarbeitung von Transaktionsaktualisierungen
• Synchronisation mit externen Systemen

Verfügbare Felder

Der Transaktionsimport unterstützt einen umfassenden Satz von Feldern:

Kern-Transaktionsfelder:

• Transaktions-ID
• Konto-ID
• Benutzer-ID (Partner) - unterstützt ID, refid oder Benutzername
• Banner-ID und Übergeordnete Banner-ID
• Kampagnen-ID
• Bestell-ID und Produkt-ID
• Status (ausstehend, genehmigt, abgelehnt)
• Typ (Verkauf, Lead, Klick, Rückerstattung, Rückbuchung)
• Eingefügt am und Genehmigt am
• Provisionsbetrag
• Gesamtkosten und Fixkosten
• Stufe

Tracking-Informationen:

• Ländercode
• IP-Adresse
• Browser
• Referrer-URL
• Tracking-Methode
• Klickanzahl
• Kanal
• Besucher-ID

Zusätzliche Daten:

• Extra-Datenfelder (Data1-Data5)
• Händlernotiz und Systemnotiz
• Gutschein-ID oder -Code
• Währungsinformationen (ID, Wert, Kurs)
• Provisionstyp-ID und Gruppen-ID
• Netzwerkgebühr
• Verkaufs-ID und Split-Informationen

Importoptionen

Transaktionsabgleich: Der Import kann bestehende Transaktionen abgleichen nach:

• Bestell-ID - Aktualisiert Transaktionen mit passender Bestell-ID
• Transaktions-ID - Aktualisiert bestimmte Transaktionen nach ID
• Bestell-ID (Alle Stufen) - Aktualisiert alle Stufen-Transaktionen für eine Bestellung

Automatische Provisionsberechnung: Aktivieren Sie die automatische Provisionsberechnung, damit das System Provisionsbeträge berechnet basierend auf:

• Kampagnen-Provisionseinstellungen
• Provisionsgruppe des Partners
• Gesamtkostenwert
• Provisionstyp-Regeln

Multi-Tier-Provisionsgenerierung: Wenn aktiviert, erstellt der Import automatisch Stufenprovisionen basierend auf der Upline-Struktur des Partners und den Kampagneneinstellungen.

Statusbehandlung:

• Einen bestimmten Status für alle importierten Transaktionen festlegen
• Status aus Datei verwenden (Feldwert)
• Originalstatus beim Aktualisieren bestehender Transaktionen beibehalten

Importformat-Voreinstellungen

Sie können Importformat-Konfigurationen speichern und wiederverwenden:

• Spaltenzuordnungen definieren
• Importoptionen festlegen
• Als benannte Voreinstellungen für wiederkehrende Importe speichern

CSV-Format Beispiel

userid,campaignid,totalcost,orderid,rstatus,dateinserted
aff12345,camp001,99.99,ORD-001,A,2025-01-10 10:30:00
aff67890,camp001,149.99,ORD-002,P,2025-01-10 11:45:00

Behandlung von Rückerstattungen und Rückbuchungen

Beim Import von Rückerstattungen oder Rückbuchungen:

• Setzen Sie den Transaktionstyp auf Rückerstattung (R) oder Rückbuchung (H)
• Geben Sie die übergeordnete Transaktions-ID oder Bestell-ID als Referenz an
• Provisionsbeträge werden automatisch als negative Werte berechnet, wenn automatische Berechnung verwendet wird

Theme-Import/Export

Theme-Export

Exportieren Sie Ihre benutzerdefinierten Themes als vollständige Pakete für Backup oder Migration:

Was wird exportiert:

• Theme-Konfiguration (theme.php-Einstellungen)
• Alle Vorlagendateien (.tpl und .stpl)
• Benutzerdefinierte CSS-Dateien (custom.css, custom_colors.css)
• Bild-Assets (JPEG, PNG, GIF, BMP)

Der Export erstellt ein ZIP-Archiv mit der vollständigen Theme-Struktur.

Theme-Konfiguration enthält:

• Theme-Name und Beschreibung
• Autor und URL
• Modul (Händler-/Partner-Panel)
• Anzeigemodus (einzeln/Fenster)
• Standard-Hintergrundbild-Einstellungen
• Vorschaubild
• CSS-Überschreibungseinstellungen
• Original-Theme-Referenz

Theme-Import

Importieren Sie Themes aus ZIP-Paketen, um benutzerdefinierte Designs schnell bereitzustellen:

Anforderungen:

• Gültiges ZIP-Archiv mit theme.php-Konfiguration
• Ordnungsgemäße Vorlagensyntax (während des Imports validiert)
• Gültige Original-Theme-Referenz
• Vorschaubild angegeben

Validierung: Der Importprozess validiert:

• Vollständigkeit der Theme-Konfiguration
• Smarty-Vorlagensyntax
• Existenz des Original-Themes
• Dateitypbeschränkungen (nur erlaubte Erweiterungen)

Unterstützte Dateitypen:

• Vorlagen: .tpl, .stpl
• Stile: .css (nur custom.css, custom_colors.css)
• Bilder: .jpg, .jpeg, .png, .gif, .bmp

Datenformat-Anforderungen

CSV-Dateistruktur

Allgemeine Anforderungen:

• UTF-8-Kodierung für ordnungsgemäße Zeichenbehandlung verwenden
• Erste Zeile sollte Spaltenüberschriften enthalten
• Konsistentes Trennzeichen in der gesamten Datei (Komma, Semikolon oder Tab)
• Ordnungsgemäß escapete Sonderzeichen

Feldnamenformat:

• Erforderliche Felder werden mit ! vorangestellt (z.B. !USERID)
• Feldnamen sind nicht groß-/kleinschreibungssensitiv
• Benutzerdefinierte Zuordnung ermöglicht flexible Spaltenreihenfolge

Datumsformat: Daten sollten in einem erkennbaren Format vorliegen:

• JJJJ-MM-TT HH:MM:SS (empfohlen)
• Standarddatumsformate werden automatisch geparst

Numerische Werte:

• Punkt (.) als Dezimaltrennzeichen verwenden
• Keine Tausendertrennzeichen
• Negative Werte werden unterstützt (z.B. für Rückerstattungen)

Multi-Abschnitt-Dateien

Einige Exporte (Partner, Kampagnen) enthalten mehrere Datenabschnitte:

[[AFFILIATES]]
!USERID,!REFID,!USERNAME
...

[[Payout options]]
!USERID,name,value
...

Jeder Abschnitt wird durch eine Kopfzeilenmarkierung identifiziert und hat seine eigene Spaltenstruktur.

Best Practices für Massen-Operationen

Vor dem Import

1. Backup erstellen Exportieren Sie immer Ihre aktuellen Daten, bevor Sie Massenimporte durchführen, besonders wenn Sie die Löschoption verwenden.

2. Ihre Daten validieren

   • Auf doppelte IDs prüfen
   • Überprüfen, ob erforderliche Felder vorhanden sind
   • Sicherstellen, dass Datumsformate konsistent sind
   • Status- und Typcodes validieren

3. Mit kleinem Datensatz testen Importieren Sie zuerst einige Datensätze, um Zuordnung und Verhalten zu überprüfen, bevor Sie große Dateien verarbeiten.

4. Abhängigkeiten prüfen

   • Sicherstellen, dass referenzierte Kampagnen vor dem Bannerimport existieren
   • Überprüfen, dass Partnerkonten vor dem Transaktionsimport existieren
   • Bestätigen, dass Provisionstypen vor dem Provisionsimport eingerichtet sind

Während des Imports

5. Fortschritt überwachen Der Import läuft als Hintergrundaufgabe mit Fortschrittsverfolgung. Prüfen Sie die Aufgabenbenachrichtigungen auf Statusaktualisierungen und Fehlermeldungen.

6. Fehler elegant behandeln Das System protokolliert Fehler für einzelne Datensätze, während es gültige Einträge weiter verarbeitet. Überprüfen Sie das Importprotokoll, um fehlgeschlagene Datensätze zu bearbeiten.

Nach dem Import

7. Ergebnisse überprüfen

   • Importierte Datensätze stichprobenartig prüfen
   • Überprüfen, ob Summen und Anzahlen den Erwartungen entsprechen
   • Partner-Logins testen, wenn Passwörter importiert wurden

8. Verwandte Datensätze aktualisieren Einige Importe erfordern möglicherweise Folgeaktionen:

   • Partner Kampagnen zuweisen
   • Bannerbilder hochladen
   • Provisionssätze konfigurieren

Leistungsüberlegungen

9. Große Dateiverarbeitung Das Importsystem verarbeitet Daten in Stapeln, um Timeouts zu vermeiden. Sehr große Dateien können mehrere Minuten dauern.

10. Während geringer Aktivität planen Planen Sie große Importe für die beste Leistung zu Zeiten geringer Aktivität, wenn die Systemlast niedriger ist.

Sicherheitshinweise

11. Sensible Daten

    • Passwortfelder werden sicher mit Salt-Verschlüsselung behandelt
    • Vermeiden Sie den Import sensibler Auszahlungsinformationen über unsichere Kanäle
    • Importdateien auf unbeabsichtigte Datenoffenlegung überprüfen

12. Zugriffskontrolle Import/Export-Funktionen erfordern entsprechende Händler-Administratorberechtigungen.

Häufige Anwendungsfälle

Migration von einer anderen Plattform

1. Daten von Ihrer bestehenden Plattform im CSV-Format exportieren
2. Spalten den Post Affiliate Pro Feldnamen zuordnen
3. Partner zuerst importieren, um Benutzerkonten einzurichten
4. Kampagnen und Provisionsstrukturen importieren
5. Historische Transaktionen importieren
6. Banner und Werbematerialien hochladen

Monatliche Transaktionssynchronisation

1. Importformat-Voreinstellung für Ihr externes System erstellen
2. Transaktionen von Ihrer E-Commerce-Plattform exportieren
3. Mit Bestell-ID-Abgleich importieren, um bestehende Transaktionen zu aktualisieren
4. Importprotokoll auf Abweichungen überprüfen

Theme-Backup und Bereitstellung

1. Ihr Theme in einer Entwicklungsumgebung anpassen
2. Das Theme als ZIP-Paket exportieren
3. In die Produktionsinstallation importieren
4. Theme-Erscheinung und -Funktionalität überprüfen

Massen-Partneraktualisierungen

1. Aktuelle Partnerdaten exportieren
2. CSV-Datei mit aktualisierten Informationen ändern
3. Mit Benutzer-ID-Abgleich importieren
4. Überprüfen, ob Aktualisierungen korrekt angewendet wurden