> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/de/what-would-you-like-to-learn-about/advocate-program/getting-started-with-advocate/import-your-referral-program-data.md). # Ihre Daten des Empfehlungsprogramms importieren Beim Wechsel von einer anderen Empfehlungsplattform zu Advocate importierst du nicht nur Daten — du steigerst auch das Potenzial deines Programms mit leistungsstarkem Tracking, anpassbaren Erlebnissen und fachkundigem Support. Dieser Artikel führt dich durch: * Warum Migration wichtig ist * Wie ein strategischer Migrationsplan aussieht * Welche Daten importiert werden können * Wie du deine Dateien vorbereitest * Häufige Validierungsfehler und wie du sie vermeidest #### Warum einen strategischen Migrationsplan erstellen? Die Migration deines Empfehlungsprogramms ist nicht nur eine technische Aufgabe — sie ist eine Chance, die Art und Weise zu verbessern, wie du deine Kunden einbindest und belohnst. Eine gut geplante Migration hilft dabei: * Unterbrechungen deines Empfehlungserlebnisses minimieren * Historische Daten bewahren und eine durchgängige Belohnungslogik sicherstellen ![](/files/11a3200e987d0b74a8dbcd82ae3eb408806545d2) * Einen sauberen Wechsel von Altsystemen ermöglichen * Dein Empfehlungsprogramm mit Begeisterung und Klarheit neu einführen ![](/files/11a3200e987d0b74a8dbcd82ae3eb408806545d2) Die Migration von Empfehlungen und Belohnungen hängt davon ab, ob du Daten aus deinem aktuellen System exportieren kannst. Dein Advocate-Team kann dir auf Basis der von dir bereitgestellten Exportdaten sagen, was möglich ist. Dein Advocate-Team arbeitet mit dir zusammen, um deine Exportdateien zu prüfen, festzustellen, was machbar ist, und einen Plan zu erstellen, der zu den Anforderungen und Zielen deines Programms passt. #### Was du tun musst * Exportiere die *Benutzerdaten*, *Empfehlungsdaten*, und *Belohnungsdaten*. Wende dich entweder an deinen CSM auf deiner alten Empfehlungsplattform, um Unterstützung zu erhalten, oder nutze ein Export-Tool innerhalb der Plattform, falls eines bereitgestellt wird. * Lade jeden der 3 Datenberichte als separate CSV-Datei herunter, z. B. `user_data.CSV`, `referral_data.CSV`, und `reward_data.CSV`. * Sieh dir die Beispiele unten an, um zu sehen, wie der Inhalt jeder .csv-Datei aussehen könnte, oder sieh dir die vollständige Referenz für das Zielfeld an. Dies umfasst E-Mails, Empfehlungscodes, Sharelinks ![](/files/11a3200e987d0b74a8dbcd82ae3eb408806545d2), und benutzerdefinierte Felder. Affiliates sollten herausgefiltert werden, um doppelte Belohnungen zu vermeiden. ![](/files/11a3200e987d0b74a8dbcd82ae3eb408806545d2) Abhängig vom Format des Sharelinks und der Verwendung einer benutzerdefinierten Subdomain. Die Datei mit den Benutzerdaten enthält detaillierte Informationen über jeden Teilnehmer deines Programms. Exportiere eine Liste aller Teilnehmer, damit dein Programm mit ihren Sharelinks und Empfehlungscodes auf dem neuesten Stand bleibt. Die folgenden Felder sind **erforderlich**: * Benutzer-ID * Konto-ID Verwende die E-Mail-Adresse des Nutzers als seine *Benutzer-ID* und *Konto-ID*. Daten sollten im Format [Millisekunden seit dem Unix-Epoch](https://currentmillis.com/). Lade ein [Beispiel der erforderlichen Felder](https://res.cloudinary.com/product-enablement/raw/upload/v1750169976/CSVs/Migration_User_Import_examples_-_User_Data.csv) herunter oder verwende das folgende Beispiel im `.csv` Format. ```programlisting id,accountId,email,firstName,lastName,dateCreated,locale,countryCode,segments User1@example.com,User1@example.com,User1@example.com,First,Last,1741051242000,en_US,US, User2@example.com,User2@example.com,User2@example.com,First,Last,,,,"vip,newuser" User3@example.com,User3@example.com,User3@example.com,First,Last,,en_CA,, User4@example.com,User4@example.com,User4@example.com,First,Last,,,,newuser ``` Dies umfasst Start- und Konversionsdaten sowie Beziehungen zwischen Empfehlendem und Empfohlenem. Es unterstützt die Zuordnung der historischen Empfehlungsleistung. Die Empfehlungsdatendatei liefert einen Nachweis des Status jeder in deinem Empfehlungsprogramm erstellten Empfehlungsverbindung. Die folgenden Felder sind **erforderlich**: * Advocate-Benutzer-ID * Advocate-Konto-ID * ID des empfohlenen Nutzers * Konto-ID des empfohlenen Nutzers Verwende die E-Mail-Adresse des Nutzers als seine *Benutzer-ID* und *Konto-ID*. Daten sollten im Format [Millisekunden seit dem Unix-Epoch](https://currentmillis.com/). Lade ein [Beispiel der erforderlichen Felder](https://res.cloudinary.com/product-enablement/raw/upload/v1750249453/CSVs/Migration_User_Import_examples_-_Referral_Data_-_Referral_Data.csv) herunter oder verwende das folgende Beispiel im `.csv` Format. ```programlisting referrerUser,referrerAccount,referredUser,referredAccount,dateReferralStarted,dateConverted,programId User2@example.com,User2@example.com,User12@example.com,User12@example.com,1740824979000,1740824979000,33435 User1@example.com,User1@example.com,User13@example.com,User13@example.com,1741051242000,1741051242000,33435 User1@example.com,User1@example.com,User17@example.com,User17@example.com,,,33435 User1@example.com,User1@example.com,User18@example.com,User18@example.com,,,33435 ``` Dies umfasst Werte, vergebene/eingelöste Daten, Belohnungstypen und Status. Es trägt dazu bei, Glaubwürdigkeit und Fairness gegenüber den Nutzern zu wahren. Die Datei mit den Belohnungsdaten enthält einen Nachweis der Belohnungshistorie der Teilnehmer, einschließlich des Werts und des eingelösten Betrags, der über dein Empfehlungsprogramm erzeugt wurde. Die folgenden Felder sind **erforderlich**: * Advocate-Benutzer-ID * Advocate-Konto-ID * Belohnungsname * Belohnungseinheit * Belohnungswert * Erstellungsdatum * Datum der Vergabe * Datum der Einlösung * Eingelöster Betrag Verwende die E-Mail-Adresse des Nutzers als seine *Benutzer-ID* und *Konto-ID*. Daten sollten im Format [Millisekunden seit dem Unix-Epoch](https://currentmillis.com/). Der Belohnungswert ist der numerische Wert der Belohnung in ihrer kleinsten Maßeinheit (z. B. wäre der Wert bei einer Barbelohnung von 1,00 $ 100 Cent). Wenn die Belohnungseinheit Bargeld ist, sollte sie den Währungscode im folgenden Format enthalten `/` (z. B. Cash/USD). {% hint style="warning" %} **Wichtig**: Wenn die *Datum der Einlösung* und *Eingelöster Betrag* Felder nicht korrekt gesetzt sind — also entweder leer gelassen werden oder falsche Werte enthalten (z. B. ein zukünftiges Datum oder ein ungenauer eingelöster Betrag) — kann die Belohnung dem Nutzer erneut zur Einlösung zur Verfügung stehen. {% endhint %} Lade ein [Beispiel der erforderlichen Felder](https://res.cloudinary.com/product-enablement/raw/upload/v1750249453/CSVs/Migration_User_Import_examples_-_Reward_Data_-_Reward_Data.csv) herunter oder verwende das folgende Beispiel im `.csv` Format. ```programlisting User ID,Acccount ID,Referred User ID,Referred Account ID,Reward Name,Reward Unit,Reward Value,Redeemed Amount,Date Created,Date Given,Date Redeemed User1@example.com,User1@example.com,User2@example.com,User2@example.com,Dollars,CASH/USD,1000,1000,1709712158000,1709712158000,1709712158000 User1@example.com,User1@example.com,User3@example.com,User3@example.com,Points,POINT,100,100,1726164909682,1726164909682,1726164909682 User1@example.com,User1@example.com,User4@example.com,User4@example.com,Points,POINT,100,100,1726164887075,1726164887075,1726164887075 User1@example.com,User1@example.com,User5@example.com,User5@example.com,Points,POINT,100,100,1726164875888,1726164875888,1726164875888 User1@example.com,User1@example.com,User6@example.com,User6@example.com,Points,POINT,10,10,1726164828986,1726164828986,1726164828986 User1@example.com,User1@example.com,User7@example.com,User7@example.com,Account Credit,USD,8000,8000,1726164289997,1726164289997,1726164289997 User1@example.com,User1@example.com,,,Gift Card,USD,10000,10000,1726163864871,1726163864871,1726163864871 User1@example.com,User1@example.com,,,Points,POINT,800,800,1726095906392,1726095906392,1726095906392 User1@example.com,User1@example.com,,,Gift Card,USD,30000,30000,1726163769157,1726163769157,1726163769157 User1@example.com,User1@example.com,,,20 Off,%,20,20,1726180309034,1726180309034,1726180309034 ``` {% hint style="warning" %} **Wichtig:** Alle 3 Exportdateien sollten nur Daten aus einem einzigen Programm enthalten. Wenn die Dateien Daten aus mehreren Programmen enthalten, konsolidiert der Import sie zu einem einzigen Programm. {% endhint %}
Ein Beispiel für einen Migrationsplan Jede Migration ist einzigartig, aber erfolgreiche folgen einer ähnlichen Struktur, die Vorbereitung, Kommunikation und Durchführung ausbalanciert. Nachfolgend findest du einen Migrationsplan, der Kontinuität und ein nahtloses Erlebnis sowohl für dein Team als auch für deine Advocates sicherstellt. Zeitpläne und Phasen können je nach Einrichtung deines Programms variieren. **Phase 1: Planung und Vorbereitung (1–2 Wochen)** Dies ist die Phase, in der du das Fundament legst und die Grundlage für einen reibungslosen Übergang schaffst. | | | | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Ziele |

• Stakeholder abstimmen.

• Technische Einrichtung.

• Migrationsumfang bestätigen.

• Nutzerkommunikation planen.

| | Aufgaben |

• Eine Beispielauswahl deiner historischen Daten (Nutzer, Empfehlungen, Belohnungen) sichern und dem Advocate-Team zur Überprüfung und Feldzuordnung zur Verfügung stellen .

• Vollständige Datensätze exportieren, sobald das Beispiel validiert wurde. Die Exportdaten müssen höchstwahrscheinlich angepasst werden (z. B. Kopfzeilen, Feldnamen oder Dateistruktur), damit sie den Importanforderungen entsprechen.

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

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

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

• Programmkonfiguration in Advocate abschließen (z. B. Belohnungseinrichtung, Programmregeln, E-Mail-Vorlagen, Segmentierung).

• Die Programmfunktionalität End-to-End testen — sicherstellen, dass Weiterleitungen, Konversionen und Belohnungen in einer Testumgebung korrekt erfasst werden, bevor live geschaltet wird.

• Entwurf der Nachricht erstellen, um den Wechsel an die Advocates zu kommunizieren.

Die Migration von Empfehlungen und Belohnungen hängt davon ab, ob du Daten aus deinem aktuellen System exportieren kannst. Dein Advocate-Team kann dir auf Basis der von dir bereitgestellten Exportdaten sagen, was möglich ist.

| | Tipps |

• Wenn du Plattformen parallel betreibst, stelle sicher, dass nur eine davon Belohnungen ausgibt.

• Identifiziere Power-User, die möglicherweise eine besondere Behandlung benötigen (VIPs, Influencer).

| **Phase 2: Umstellung und Go-live (1–2 Tage)** Dies ist dein Übergangsmoment. Plane eine kurze Unterbrechung des Trackings zwischen den Systemen ein und lege den Zeitpunkt wenn möglich außerhalb der Stoßzeiten fest. | | | | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Ziele |

• Wechsle nahtlos von deiner Legacy-Plattform zu Advocate.

• Stelle sicher, dass Nutzer sofort auf das neue Erlebnis zugreifen können.

• Vermeide den Verlust von Empfehlungsdaten oder Belohnungen.

| | Aufgaben |

• Entferne alte Plattform-Skripte/-Widgets von deiner Website.

• Schalte die Advocate-Widgets live.

• Importiere abschließende Benutzer-, Empfehlungs- und Belohnungsdaten.

• Verfolge/markiere manuell alle Konversionen zwischen Abschaltung des alten Systems und Start.

• Überwache das Advocate-Dashboard auf Aktivitäten.

• Sende die Startkommunikation an deine Advocates. Teile den Nutzern mit, dass ihre Empfehlungslinks aktualisiert wurden, und füge idealerweise die neuen Links direkt in die E-Mail ein, damit sie sofort mit dem Teilen beginnen können.

| | Tipps |

• Füge bei Bedarf einen kurzen Sperrzeit-Puffer für Belohnungen hinzu (z. B. „Empfehlungen, die am 15. Mai erstellt wurden, werden geprüft und nach dem Start hinzugefügt.“).

• Nutze die Kommunikation an die Advocates, um Begeisterung zu erzeugen (z. B. „Wir haben dein Empfehlungserlebnis verbessert!“).

| **Phase 3: Nach der Migration & Bereinigung (1–2 Tage)** Jetzt, da du live bist, stelle sicher, dass dein Programm wie erwartet funktioniert, und kümmere dich um alle offenen Punkte. | | | | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Ziele |

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

• Erfasse alle übersehenen Konversionen.

• Unterstütze und schule die Nutzer.

| | Aufgaben |

• Validieren, dass Beziehungen zwischen Empfehlendem und Empfohlenem im Live-Modus funktionieren.

• Importiere alle übersehenen Konversionen, die zwischen der Umstellung aufgetreten sind.

• Führe einen QA-Test durch (empfiehl dich selbst, bestätige Tracking und Belohnungslogik).

• Stelle interne und externe FAQs oder Hilfedokumente bereit.

• Überwache den Support-Posteingang auf Probleme im Zusammenhang mit Legacy-Nutzern.

| | Tipps |

• Wenn du ein Legacy-Finanzierungskonto für Belohnungen auslaufen lässt, gib den Nutzern eine Schonfrist zum Einlösen.

• Nutze E-Mail- oder In-App-Erinnerungen, um erste Empfehlungsaktivitäten im neuen Programm anzustoßen.

|
#### Importiere die Daten deines Programms 1. Wählen Sie im linken Navigationsmenü ![](/files/8189ccdb3d6833e64eac05afbd5a6e7ceadce224) **\[Engage] → Berichte → Importe & Exporte**. 2. Wählen Sie oben rechts ![](/files/35332659ecce74be9f92ede33e67b850a096b176) **Importieren**. 3. Wählen Sie den *Importtyp* aus den verfügbaren Optionen: | Importtyp | Beschreibung | | ------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Nutzer | Wähle diese Option, um neue Nutzer oder vorhandene Nutzerdaten hochzuladen. Du kannst diese Daten auch von einem anderen Konto oder einer anderen Plattform importieren. | | Prämienguthaben für Benutzer aktualisieren | Wähle diese Option, um Nutzerguthaben für Belohnungen zu aktualisieren und einzulösen. | | Nutzerereignisse | Wähle diese Option, um Nutzereignisdaten hochzuladen. | | Nutzer löschen |

Wähle diese Option, wenn du vorhandene Nutzer aus deinem Programm in großen Mengen löschen möchtest.

Du kannst auch die Handhabung gelöschter Nutzer entfernen und dich dafür entscheiden:

• Leere Konten beibehalten

• Verhindern, dass gelöschte Nutzer erneut erstellt werden

| | Belohnungsverlauf | Wähle diese Option, um einen Datensatz aller Belohnungsinformationen hochzuladen. Du kannst diese Daten auch von einem anderen Konto oder einer anderen Plattform importieren. | | Empfehlungsverlauf | Wähle diese Option, um einen Datensatz aller Empfehlungsverbindungen hochzuladen. Du kannst diese Daten auch von einem anderen Konto oder einer anderen Plattform importieren. | 4. Wählen Sie **Datei auswählen** oder ziehe die Datei, die du importieren möchtest, per Drag-and-drop hinein. 5. Wählen Sie **Importieren** um deine Daten hochzuladen. * Wenn du vorhandene Nutzer in großen Mengen löschst, wähle **Massenlöschung**. #### Referenz zu Validierungsfehlern Du kannst 3 Arten von Validierungsfehlern erhalten: 1. **Inline-Fehlermeldung:** diese erscheinen in der Validierungstabelle der Vorschau und führen dazu, dass fehlerhafte Zeilen rot hervorgehoben werden: * `INVALID_FIELD` — z. B. wurde das *Erstellungsdatum* Feld nicht im Format [Millisekunden seit dem Unix-Epoch](https://currentmillis.com/) . * `MISSING_FIELD` — z. B. fehlt ein erforderliches Feld wie *Benutzer-ID* oder *Konto-ID* fehlt.
2. **Fehlerhinweis:** diese erscheinen anstelle der Validierungstabelle der Vorschau als rote Warnmeldungen: * `MISSING_HEADER` — z. B. fehlt 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 *Imports & Exports* Bildschirm innerhalb des *Berichterstattung* Abschnitts, wenn der Importtyp keine Validierungstabelle zur Vorschau hat. Zeilenfehler und Dateifehler werden zusammen angezeigt:
#### Support Du musst die Migration nicht allein bewältigen. Unser Onboarding-Team von Advocate unterstützt dich gerne bei: * Unterstützung bei der Feldzuordnung * Hinweise zur Datenformatierung * Strategie für die Migration von Belohnungen * Testen und QA Wende dich an dein [Advocate-Support-Team](mailto:support-advocate@impact.com). --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://help.impact.com/brand/de/what-would-you-like-to-learn-about/advocate-program/getting-started-with-advocate/import-your-referral-program-data.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.