search
Developer DocsContact SupportLog In

Daten Ihres Empfehlungsprogramms importieren

Wenn Sie von einer anderen Empfehlungsplattform zu Advocate wechseln, importieren Sie nicht nur Daten – Sie verbessern das Potenzial Ihres Programms mit leistungsstarkem Tracking, anpassbaren Erlebnissen und fachkundiger Unterstützung. 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

  • Gängige Validierungsfehler und wie Sie sie vermeiden

hashtag
Warum einen strategischen Migrationsplan erstellen?

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

  • Störungen des Empfehlungserlebnisses zu minimieren

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

  • Einen sauberen Bruch mit Altsystemen zu ermöglichen

  • Ihr Empfehlungsprogramm mit Spannung und Klarheit neu vorzustellen

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

Ihr Advocate-Team arbeitet mit Ihnen zusammen, um Ihre Exportdateien zu prüfen, festzustellen, was machbar ist, und einen Plan zu erstellen, der den Bedürfnissen und Zielen Ihres Programms entspricht.

hashtag
Was Sie tun müssen

  • Exportieren Sie die Benutzerdaten Ihres Programms, Empfehlungsdaten, und Belohnungsdaten. Kontaktieren Sie entweder Ihren CSM auf Ihrer alten Empfehlungsplattform zur Unterstützung oder verwenden Sie ein im System vorhandenes Exportwerkzeug, falls eines angeboten wird.

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

    • Siehe die Beispiele unten dafür, wie der Inhalt jeder .csv-Datei aussehen könnte, oder sehen Sie die vollständige Referenz für das Destination-Feld.

Dies beinhaltet E-Mails, Empfehlungs-Codes, Sharelinks , und benutzerdefinierte Felder. Affiliates sollten herausgefiltert werden, um doppelte Belohnungen zu vermeiden.

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

Die Benutzerdaten-Datei enthält detaillierte Informationen über jeden Teilnehmer Ihres Programms. Exportieren Sie eine Liste aller Teilnehmer, um Ihr Programm mit deren Sharelinks und Empfehlungs-Codes aktuell zu halten.

Die folgenden Felder sind erforderlich:

  • Benutzer-ID

  • Konto-ID

Verwenden Sie die E-Mail des Benutzers als seine Benutzer-ID und Konto-ID. Daten sollten formatiert sein in Millisekunden seit Unix-Epochearrow-up-right. Laden Sie ein Beispiel der erforderlichen Felder herunterarrow-up-right oder verwenden Sie das Beispiel unten im .csv Format.

Dies umfasst Start- und Konversionsdaten sowie Empfehlungs-/Geworbene-Beziehungen. Es unterstützt die Abbildung historischer Empfehlungsleistung.

Die Empfehlungsdaten-Datei liefert eine Aufzeichnung des Status jeder Empfehlungsverbindung in Ihrem Empfehlungsprogramm.

Die folgenden Felder sind erforderlich:

  • Advocate-Benutzer-ID

  • Advocate-Konto-ID

  • Geworbene Benutzer-ID

  • Geworbenes Konto-ID

Verwenden Sie die E-Mail des Benutzers als seine Benutzer-ID und Konto-ID. Daten sollten formatiert sein in Millisekunden seit Unix-Epochearrow-up-right. Laden Sie ein Beispiel der erforderlichen Felder herunterarrow-up-right oder verwenden Sie das Beispiel unten im .csv Format.

Dies umfasst Werte, Daten gegeben/eingelöst, Belohnungsarten und -status. Es ermöglicht, Glaubwürdigkeit und Fairness gegenüber Nutzern zu bewahren.

Die Belohnungsdaten-Datei bietet eine Aufzeichnung der Belohnungshistorie der Teilnehmer, einschließlich ihres Werts und des eingelösten Betrags, der durch Ihr Empfehlungsprogramm generiert wurde.

Die folgenden Felder sind erforderlich:

  • Advocate-Benutzer-ID

  • Advocate-Konto-ID

  • Belohnungsname

  • Belohnungseinheit

  • Belohnungswert

  • Erstellungsdatum

  • Ausgabedatum

  • Einlösedatum

  • Eingelöster Betrag

Verwenden Sie die E-Mail des Benutzers als seine Benutzer-ID und Konto-ID. Daten sollten formatiert sein in Millisekunden seit Unix-Epochearrow-up-right.

Der Belohnungswert ist der numerische Wert der Belohnung in ihrer kleinsten Maßeinheit (z. B. für eine Bargeldbelohnung von $1,00 wäre der Wert 100 Cent). Wenn die Belohnungseinheit Bargeld ist, sollte sie den Währungscode im folgenden Format enthalten <Einheitename>/<Währung> (z. B. Cash/USD).

circle-exclamation

Wichtig: Wenn die Einlösedatum und Eingelöster Betrag Felder nicht angemessen gesetzt sind — das heißt, sie sind entweder leer gelassen oder enthalten falsche Werte (z. B. ein Datum in der Zukunft oder ein ungenauer eingelöster Betrag) — kann die Belohnung wieder für den Benutzer zur Einlösung verfügbar werden.

Laden Sie ein Beispiel der erforderlichen Felder herunterarrow-up-right oder verwenden Sie das Beispiel unten im .csv Format.

circle-exclamation

Wichtig: Alle 3 Exportdateien sollten Daten nur aus einem einzelnen Programm enthalten. Wenn die Dateien Daten aus mehreren Programmen enthalten, wird der Import sie zu einem einzigen Programm konsolidieren.

chevron-rightEin Beispiel-Migrationsplanhashtag

Jede Migration ist einzigartig, aber erfolgreiche folgen einer ähnlichen Struktur, die Vorbereitung, Kommunikation und Ausführung ausbalanciert. Unten steht ein Migrationsplan, der Kontinuität und ein nahtloses Erlebnis für Ihr Team und Ihre Advocates sicherstellt. Zeitpläne und Phasen können je nach Einrichtung Ihres Programms variieren.

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

Dies ist Ihre Grundlagebene, die das Fundament für einen reibungslosen Übergang legt.

Ziele

• Interessengruppen abstimmen.

• Technische Einrichtung.

• Migrationsumfang bestätigen.

• Benutzerkommunikation planen.

Aufgaben

• Sichern Sie ein Musterset Ihrer historischen Daten (Benutzer, Empfehlungen, Belohnungen) und teilen Sie es mit dem Advocate-Team zur Überprüfung und Feldzuordnung .

• Exportieren Sie vollständige Datensätze, sobald das Muster validiert wurde. Die Exportdaten müssen höchstwahrscheinlich bearbeitet werden (z. B. Anpassung von Kopfzeilen, Feldnamen oder Dateistruktur), um den Importanforderungen zu entsprechen.

• Legen Sie ein Go-Live-Datum und ein Rollback-Fenster fest.

• Fügen Sie Advocate-Widgets im versteckten Modus hinzu (Testumgebung oder nicht verlinkte Seiten).

• Richten Sie notwendige Integrationen ein (z. B. Shopify, HubSpot, Segment).

• Schließen Sie die Programmkonfiguration in Advocate ab (z. B. Belohnungssetup, Programmregeln, E-Mail-Vorlagen, Segmentierung).

• Testen Sie die Programmfunktionalität End-to-End — bestätigen Sie, dass Shares, Konversionen und Belohnungen in einer Testumgebung korrekt nachverfolgt werden, bevor Sie live gehen.

• Entwerfen Sie Nachrichten, um die Übergabe an Advocates zu kommunizieren.

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

Tipps

• Wenn Ihre Plattformen sich überschneiden, stellen Sie sicher, dass nur eine Belohnungen ausgibt.

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

Phase 2: Cutover und Live-Schaltung (1–2 Tage)

Dies ist Ihr Übergabemoment. Planen Sie eine kurze Pause im Tracking zwischen den Systemen ein und legen Sie den Zeitpunkt wenn möglich in verkehrsarmen Stunden.

Ziele

• Wechseln Sie nahtlos von Ihrer Legacy-Plattform zu Advocate.

• Stellen Sie sicher, dass Benutzer sofort auf das neue Erlebnis zugreifen können.

• Vermeiden Sie den Verlust von Empfehlungsdaten oder Belohnungen.

Aufgaben

• Entfernen Sie alte Plattform-Skripte/Widgets von Ihrer Seite.

• Schalten Sie Advocate-Widgets live.

• Importieren Sie die finalen Benutzer-, Empfehlungs- und Belohnungsdaten.

• Verfolgen/markieren Sie manuell alle Konversionen zwischen Systemabschaltung und Start.

• Überwachen Sie das Advocate-Dashboard auf Aktivität.

• Versenden Sie eine Startmitteilung an Ihre Advocates. Informieren Sie die Nutzer darüber, 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

• Schließen Sie gegebenenfalls einen kurzen Belohnungs-Blackout-Puffer ein (z. B. „Empfehlungen, die am 15. Mai gemacht wurden, werden nach dem Launch überprüft und hinzugefügt.“).

• Verwenden Sie advocacy-orientierte Kommunikation, um Begeisterung zu erzeugen (z. B. „Wir haben Ihr Empfehlungserlebnis verbessert!“).

Phase 3: Nachmigration & Bereinigung (1–2 Tage)

Jetzt, da Sie live sind, stellen Sie sicher, dass Ihr Programm wie erwartet funktioniert, und beheben Sie offene Punkte.

Ziele

• Überprüfen Sie die Datenintegrität und das Belohnungstracking.

• Erfassen Sie verpasste Konversionen.

• Unterstützen und schulen Sie Benutzer.

Aufgaben

• Validieren Sie, dass Empfehlender/Geworbener-Beziehungen im Live-Modus funktionieren.

• Importieren Sie alle verpassten Konversionen, die zwischen dem Cutover aufgetreten sind.

• Führen Sie einen QA-Test durch (werben Sie sich selbst, bestätigen Sie Tracking- und Belohnungslogik).

• Stellen Sie interne und externe FAQs oder Hilfedokumente bereit.

• Überwachen Sie das Support-Postfach auf Probleme im Zusammenhang mit Legacy-Nutzern.

Tipps

• Wenn Sie ein altes Belohnungs-Finanzierungskonto einstellen, geben Sie den Nutzern eine Gnadenfrist zum Einlösen.

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

hashtag
Importieren Sie die Daten Ihres Programms

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

  2. Wählen Sie oben rechts Importieren.

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

    Importtyp
    Beschreibung

    Benutzer

    Wählen Sie diese Option, um neue Benutzer oder bestehende Benutzerdaten hochzuladen. Sie können diese Daten auch aus einem anderen Konto oder einer anderen Plattform importieren.

    Benutzer-Belohnungssalden aktualisieren

    Wählen Sie diese Option, um Benutzer-Belohnungssalden zu aktualisieren und einzulösen.

    Benutzerereignisse

    Wählen Sie diese Option, um Benutzereignisdaten hochzuladen.

    Benutzer löschen

    Wählen Sie diese Option, wenn Sie vorhandene Benutzer in Ihrem Programm im Bulk löschen möchten.

    Sie können auch die Behandlung gelöschter Benutzer festlegen und wählen:

    • Leere Konten beibehalten

    • Verhindern, dass gelöschte Benutzer erneut erstellt werden

    Belohnungshistorie

    Wählen Sie diese Option, um eine Aufzeichnung aller Belohnungsinformationen hochzuladen. Sie können diese Daten auch aus einem anderen Konto oder einer anderen Plattform importieren.

    Empfehlungshistorie

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

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

  5. Wählen Importieren um Ihre Daten hochzuladen.

    • Wenn Sie vorhandene Benutzer im Bulk löschen, wählen Sie Massenlöschung.

hashtag
Referenz für Validierungsfehler

Sie können 3 Arten von Validierungsfehlern erhalten:

  1. Inline-Fehlermeldung: diese erscheinen in der Vorschau-Validierungstabelle und bewirken, dass Fehlerzeilen rot hervorgehoben werden:

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

    • FEHLENDE_KOPFZEILE — z. B. ein erforderlicher Spaltenkopf wie Konto-ID oder Belohnungswert fehlt.

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

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

  3. Aufgelistete Fehler: diese erscheinen als Liste von Fehleranzahlen auf dem Importe & Exporte Bildschirm im Bereich Berichte wenn der Importtyp keine Vorschau-Validierungstabelle hat. Zeilenfehler und Dateifehler werden zusammen angezeigt:

hashtag
Support

Sie müssen die Migration nicht alleine meistern. Unser Advocate-Onboarding-Team ist bereit zu helfen bei:

  • Unterstützung bei der Feldzuordnung

  • Anleitung zur Datenformatierung

  • Strategie für Belohnungsmigration

  • Tests und QA

Kontaktieren Sie Ihr Advocate-Supportteamenvelope.

VorherigeNeue Partnerschaften mit Advocate entdeckenNächsteZu impact.com von SaaSquatch migrieren

Zuletzt aktualisiert

War das hilfreich?