Ctrlk
Integration DocsContact SupportLog In
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Ihre Daten des Empfehlungsprogramms importieren

Beim Wechsel von einer anderen Empfehlungsplattform zu Advocate importieren Sie nicht nur Daten — Sie steigern vielmehr das Potenzial Ihres Programms mit leistungsstarkem Tracking, anpassbaren Erlebnissen und fachkundigem Support. Dieser Artikel führt Sie durch:

  • Warum Migration wichtig ist

  • Wie ein strategischer Migrationsplan aussieht

  • Welche Daten importiert werden können

  • Wie Sie Ihre Dateien vorbereiten

  • Häufige Validierungsfehler und wie Sie sie vermeiden

Warum eine strategische Migration planen?

Die Migration Ihres Empfehlungsprogramms ist nicht nur eine technische Aufgabe — sie ist eine Chance, die Art und Weise zu verbessern, wie Sie Ihre Kunden einbinden und belohnen. Eine gut geplante Migration hilft dabei:

  • Störungen Ihres Empfehlungs-Erlebnisses zu minimieren

  • Historische Daten zu bewahren und die Kontinuität von Prämien sicherzustellen

  • Einen klaren Bruch mit Altsystemen zu ermöglichen

  • Ihr Empfehlungsprogramm mit Begeisterung und Klarheit neu einzuführen

Die Migration von Empfehlungen und Prämien hängt davon ab, ob Sie Daten aus Ihrem aktuellen System exportieren können. Ihr Advocate-Team kann Ihnen auf Grundlage der von Ihnen bereitgestellten Exportdaten mitteilen, was möglich ist.

Ihr Advocate-Team arbeitet mit Ihnen zusammen, um Ihre Exportdateien zu prüfen, das Machbare zu identifizieren und einen Plan zu erstellen, der zu den Anforderungen und Zielen Ihres Programms passt.

Was Sie tun müssen

  • Exportieren Sie die Nutzerdaten, Empfehlungsdaten, und Prämien-Daten. Wenden Sie sich entweder an Ihren CSM auf Ihrer alten Empfehlungsplattform, um Unterstützung zu erhalten, oder nutzen Sie ein Export-Tool innerhalb der Plattform, sofern eines bereitgestellt wird.

  • Laden Sie die 3 Datenberichte jeweils als separate CSV-Datei herunter, z. B. user_data.CSV, referral_data.CSV, und reward_data.CSV.

    • In den folgenden Beispielen sehen Sie, wie der Inhalt der jeweiligen .csv-Datei aussehen könnte, oder sehen Sie sich die vollständige Referenz für das Ziel-Feld an.

Dies umfasst E-Mails, Empfehlungscodes, Sharelinks und benutzerdefinierte Felder. Affiliates sollten herausgefiltert werden, um doppelte Prämien zu vermeiden.

Abhängig vom Sharelink-Format und der Verwendung einer benutzerdefinierten Subdomain.

Die Datei mit den Nutzerdaten enthält detaillierte Informationen zu jedem Teilnehmer Ihres Programms. Exportieren Sie eine Liste aller Teilnehmer, damit Ihr Programm mit ihren Sharelinks und Empfehlungscodes auf dem neuesten Stand bleibt.

Die folgenden Felder sind erforderlich:

  • Benutzer-ID

  • Konto-ID

Verwenden Sie die E-Mail-Adresse des Nutzers als seine Benutzer-ID und Konto-ID. Datumsangaben sollten formatiert werden in Millisekunden seit dem Unix-Epoch. Laden Sie ein Beispiel für die erforderlichen Felder herunter oder verwenden Sie das folgende Beispiel im .csv Format.

Dies umfasst Start- und Konversionsdaten sowie Referrer-/Empfänger-Beziehungen. Es unterstützt die Zuordnung der historischen Empfehlungsleistung.

Die Datei mit den Empfehlungsdaten enthält eine Aufzeichnung des Status jeder in Ihrem Empfehlungsprogramm erstellten Empfehlungsverbindung.

Die folgenden Felder sind erforderlich:

  • Advocate-Benutzer-ID

  • Advocate-Konto-ID

  • Empfangene Benutzer-ID

  • Empfangene Konto-ID

Verwenden Sie die E-Mail-Adresse des Nutzers als seine Benutzer-ID und Konto-ID. Datumsangaben sollten formatiert werden in Millisekunden seit dem Unix-Epoch. Laden Sie ein Beispiel für die erforderlichen Felder herunter oder verwenden Sie das folgende Beispiel im .csv Format.

Dies umfasst Werte, Datum der Vergabe/Einlösung, Prämienarten und Status. Es hilft dabei, Glaubwürdigkeit und Fairness gegenüber den Nutzern zu bewahren.

Die Datei mit den Prämien-Daten enthält eine Aufzeichnung der Prämienhistorie der Teilnehmer, einschließlich ihres Werts und des eingelösten Betrags, der über Ihr Empfehlungsprogramm generiert wurde.

Die folgenden Felder sind erforderlich:

  • Advocate-Benutzer-ID

  • Advocate-Konto-ID

  • Prämienname

  • Prämieneinheit

  • Belohnungswert

  • Erstellungsdatum

  • Datum der Vergabe

  • Datum der Einlösung

  • Eingelöster Betrag

Verwenden Sie die E-Mail-Adresse des Nutzers als seine Benutzer-ID und Konto-ID. Datumsangaben sollten formatiert werden in Millisekunden seit dem Unix-Epoch.

Der Prämienwert ist der numerische Wert der Prämie in ihrer kleinsten Maßeinheit (z. B. würde bei einer Barprämie von 1,00 $ der Wert 100 Cent betragen). Wenn die Prämieneinheit Bargeld ist, sollte sie den Währungscode im folgenden Format enthalten <unitName>/<Currency> (z. B. Cash/USD).

Wichtig: Wenn die Datum der Einlösung und Eingelöster Betrag Felder nicht korrekt gesetzt sind — das heißt, sie bleiben entweder leer oder enthalten falsche Werte (z. B. ein zukünftiges Datum oder einen ungenauen eingelösten Betrag) — kann die Prämie erneut zur Einlösung durch den Nutzer verfügbar werden.

Laden Sie ein Beispiel für die erforderlichen Felder herunter oder verwenden Sie das folgende Beispiel im .csv Format.

Wichtig: Alle 3 Exportdateien sollten nur Daten aus einem einzigen Programm enthalten. Wenn die Dateien Daten aus mehreren Programmen enthalten, wird der Import diese in einem einzigen Programm zusammenführen.

Ein Beispiel für einen Migrationsplan

Jede Migration ist einzigartig, aber erfolgreiche folgen einer ähnlichen Struktur, die Vorbereitung, Kommunikation und Umsetzung ausbalanciert. Nachfolgend finden Sie einen Migrationsplan, der Kontinuität und ein nahtloses Erlebnis sowohl für Ihr Team als auch für Ihre Advocates sicherstellt. Zeitrahmen und Phasen können je nach Einrichtung Ihres Programms variieren.

Phase 1: Planung und Vorbereitung (1–2 Wochen)

Dies ist Ihre Phase, in der die Grundlagen geschaffen werden und das Fundament für einen reibungslosen Übergang gelegt wird.

Ziele

• Stakeholder abstimmen.

• Technische Einrichtung.

• Migrationsumfang bestätigen.

• Nutzerkommunikation planen.

Aufgaben

• Eine Stichprobe Ihrer historischen Daten (Nutzer, Empfehlungen, Prämien) sichern und dem Advocate-Team zur Prüfung und Feldzuordnung zur Verfügung stellen .

• Vollständige Datensätze exportieren, sobald die Stichprobe validiert wurde. Die Exportdaten müssen höchstwahrscheinlich angepasst werden (z. B. Header, Feldnamen oder Dateistruktur), um den Importanforderungen zu entsprechen.

• Ein Go-Live-Datum und ein Rollback-Fenster festlegen.

• Advocate-Widgets im versteckten Modus hinzufügen (Testumgebung oder nicht verknüpfte Seiten).

• Erforderliche Integrationen einrichten (z. B. Shopify, HubSpot, Segment).

• Programmkfiguration in Advocate abschließen (z. B. Prämieneinrichtung, Programmlogik, E-Mail-Vorlagen, Segmentierung).

• Die Programmfunktionalität End-to-End testen — bestätigen Sie, dass Shares, Konversionen und Prämien in einer Testumgebung korrekt erfasst werden, bevor Sie live gehen.

• Eine Nachricht entwerfen, um die Umstellung den Advocates mitzuteilen.

Die Migration von Empfehlungen und Prämien hängt davon ab, ob Sie Daten aus Ihrem aktuellen System exportieren können. Ihr Advocate-Team kann Ihnen auf Grundlage der von Ihnen bereitgestellten Exportdaten mitteilen, was möglich ist.

Tipps

• Wenn Sie Plattformen parallel betreiben, stellen Sie sicher, dass nur eine Prämien ausgibt.

• Identifizieren Sie Power-User, die eine besondere Behandlung benötigen könnten (VIPs, Influencer).

Phase 2: Umstellung und Go-Live (1–2 Tage)

Dies ist Ihr Übergangsmoment. Planen Sie eine kurze Unterbrechung des Trackings zwischen den Systemen ein und wählen Sie nach Möglichkeit Zeiten mit geringem Traffic.

Ziele

• Nahtlos von Ihrer Legacy-Plattform zu Advocate wechseln.

• Sicherstellen, dass Nutzer sofort auf die neue Erfahrung zugreifen können.

• Verlust von Empfehlungsdaten oder Prämien vermeiden.

Aufgaben

• Alte Plattform-Skripte/Widgets von Ihrer Website entfernen.

• Advocate-Widgets live schalten.

• Finale Nutzer-, Empfehlungs- und Prämien-Daten importieren.

• Alle Konversionen zwischen Abschaltung des alten Systems und Start manuell verfolgen/kennzeichnen.

• Das Advocate-Dashboard auf Aktivität überwachen.

• Launch-Kommunikation an Ihre Advocates versenden. Lassen Sie die Nutzer wissen, dass ihre Empfehlungslinks aktualisiert wurden, und fügen Sie idealerweise die neuen Links direkt in die E-Mail ein, damit sie sofort mit dem Teilen beginnen können.

Tipps

• Fügen Sie bei Bedarf einen kurzen Sperrzeit-Puffer für Prämien ein (z. B. „Empfehlungen, die am 15. Mai gemacht werden, werden geprüft und nach dem Launch hinzugefügt.“).

• Nutzen Sie die Kommunikation an die Advocates, um Begeisterung zu erzeugen (z. B. „Wir haben Ihr Empfehlungs-Erlebnis verbessert!“).

Phase 3: Nach der Migration und Bereinigung (1–2 Tage)

Da Sie nun live sind, stellen Sie sicher, dass Ihr Programm wie erwartet funktioniert, und klären Sie alle offenen Punkte.

Ziele

• Datenintegrität und Prämien-Tracking überprüfen.

• Verpasste Konversionen erfassen.

• Nutzer unterstützen und schulen.

Aufgaben

• Validieren, dass Referrer-/Empfänger-Beziehungen im Live-Modus funktionieren.

• Alle verpassten Konversionen importieren, die zwischen der Umstellung aufgetreten sind.

• Einen QA-Test durchführen (sich selbst empfehlen, Tracking und Prämienlogik bestätigen).

• Interne und externe FAQs oder Hilfedokumente bereitstellen.

• Das Support-Postfach auf Probleme mit Legacy-Nutzern überwachen.

Tipps

• Wenn Sie ein altes Prämien-Finanzierungskonto auslaufen lassen, geben Sie den Nutzern eine Frist zur Einlösung.

• Verwenden Sie E-Mail- oder In-App-Erinnerungen, um frühe Empfehlungsaktivitäten im neuen Programm anzustoßen.

Importieren Sie die Daten Ihres Programms

  1. Wählen Sie im linken Navigationsmenü [Engage] → Berichte → Importe & Exporte.

  2. Wählen Sie oben rechts Import.

  3. Wählen Sie den Importtyp aus den verfügbaren Optionen:

    Importtyp
    Beschreibung

    Nutzer

    Wählen Sie diese Option, um neue Nutzer oder vorhandene Nutzerdaten hochzuladen. Sie können diese Daten auch aus einem anderen Konto oder von einer anderen Plattform importieren.

    Prämienguthaben der Benutzer aktualisieren

    Wählen Sie diese Option, um Nutzer-Prämienguthaben zu aktualisieren und einzulösen.

    Nutzerereignisse

    Wählen Sie diese Option, um Nutzereignisdaten hochzuladen.

    Nutzer löschen

    Wählen Sie diese Option, wenn Sie vorhandene Nutzer massenhaft aus Ihrem Programm löschen möchten.

    Sie können auch die Nutzerbehandlung löschen und sich dafür entscheiden,

    • Leere Konten beibehalten

    • Verhindern, dass gelöschte Nutzer erneut erstellt werden

    Prämienverlauf

    Wählen Sie diese Option, um einen Datensatz aller Prämieninformationen hochzuladen. Sie können diese Daten auch aus einem anderen Konto oder von einer anderen Plattform importieren.

    Empfehlungsverlauf

    Wählen Sie diese Option, um einen Datensatz aller Empfehlungsverbindungen hochzuladen. Sie können diese Daten auch aus einem anderen Konto oder von einer anderen Plattform importieren.

  4. Wählen Sie Datei auswählen oder ziehen Sie die Datei per Drag-and-Drop hinein, die Sie importieren möchten.

  5. Wählen Sie Import um Ihre Daten hochzuladen.

    • Wenn Sie vorhandene Nutzer massenhaft löschen, wählen Sie Massenlöschung.

Referenz zu Validierungsfehlern

Es gibt 3 Arten von Validierungsfehlern:

  1. Inline-Fehlermeldung: Diese erscheinen in der Vorschau-Validierungstabelle und führen dazu, dass Fehlerzeilen rot hervorgehoben werden:

    • INVALID_FIELD — z. B. war das Erstellungsdatum Feld nicht im Format Millisekunden seit dem Unix-Epoch .

    • MISSING_FIELD — z. B. ein erforderliches Feld wie Benutzer-ID oder Konto-ID fehlt.

  2. Fehlerhinweis: Diese erscheinen anstelle der Vorschau-Validierungstabelle als rote Warnmeldungen:

    • MISSING_HEADER — z. B. eine erforderliche Spaltenüberschrift wie Konto-ID oder Belohnungswert fehlt.

    • CSV_PARSING — z. B. enthält die CSV-Datei Sonderzeichen, die falsch formatiert sind.

    • FILE_REF_IO — z. B. ist die Datei beschädigt und kann nicht gelesen werden.

  3. Aufgelistete Fehler: Diese erscheinen als Liste von Fehleranzahlen auf dem Importe & Exporte Bildschirm innerhalb des Berichterstattung Bereichs, wenn der Importtyp keine Vorschau-Validierungstabelle hat. Zeilenfehler und Dateifehler werden zusammen angezeigt:

Support

Sie müssen die Migration nicht allein bewältigen. Unser Advocate-Onboarding-Team hilft Ihnen gerne bei:

  • Unterstützung beim Feldmapping

  • Hinweise zur Datenformatierung

  • Strategie zur Migration von Prämien

  • Testing und QA

Kontaktieren Sie Ihr Advocate-Support-Team.

VorherigeNeue Partnerschaften mit Advocate entdeckenNächsteVon SaaSquatch zu impact.com migrieren

Zuletzt aktualisiert

War das hilfreich?