> 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 Wenn Sie von einer anderen Empfehlungsplattform zu Advocate wechseln, importieren Sie nicht nur Daten — Sie steigern das Potenzial Ihres Programms mit leistungsstarkem Tracking, anpassbaren Erlebnissen und fachkundigem Support. Dieser Artikel führt Sie durch: * Warum die 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 Gelegenheit, die Art und Weise zu verbessern, wie Sie Ihre Kunden einbinden und belohnen. Eine gut geplante Migration hilft dabei: * Unterbrechungen Ihres Empfehlungs-Erlebnisses zu minimieren * Historische Daten zu bewahren und die Kontinuität der Belohnungen sicherzustellen ![](/files/11a3200e987d0b74a8dbcd82ae3eb408806545d2) * Einen sauberen Schnitt von Altsystemen zu ermöglichen * Ihr Empfehlungsprogramm mit Begeisterung und Klarheit neu einzuführen ![](/files/11a3200e987d0b74a8dbcd82ae3eb408806545d2) Die Migration von Empfehlungen und Belohnungen hängt davon ab, dass Sie Daten aus Ihrem aktuellen System exportieren können. Ihr Advocate-Team kann Ihnen anhand der von Ihnen bereitgestellten Exportdaten mitteilen, was möglich ist. Ihr Advocate-Team arbeitet mit Ihnen zusammen, um Ihre Exportdateien zu prüfen, festzustellen, was umsetzbar ist, und einen Plan zu erstellen, der den Anforderungen und Zielen Ihres Programms entspricht. #### Was Sie tun müssen * Exportieren Sie die *Benutzerdaten*, *Empfehlungsdaten*, und *Belohnungsdaten*. Wenden Sie sich entweder an Ihren CSM auf Ihrer alten Empfehlungsplattform, um Unterstützung zu erhalten, oder verwenden Sie, falls vorhanden, ein Export-Tool innerhalb der Plattform. * Laden Sie jeden der 3 Datenberichte in einer separaten CSV-Datei herunter, z. B. `user_data.CSV`, `referral_data.CSV`, und `reward_data.CSV`. * Sehen Sie sich die folgenden Beispiele an, um zu sehen, wie der Inhalt jeder .csv-Datei aussehen könnte, oder sehen Sie sich die vollständige Referenz der Ziel-Felder 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 Sharelink-Format und der Verwendung einer benutzerdefinierten Subdomain. Die Datei mit den Benutzerdaten enthält detaillierte Informationen zu jedem Teilnehmer Ihres Programms. Exportieren Sie eine Liste aller Teilnehmer, damit Ihr Programm mit ihren Sharelinks und Empfehlungscodes aktuell bleibt. Die folgenden Felder sind **erforderlich**: * Benutzer-ID * Konto-ID Verwenden Sie die E-Mail-Adresse des Benutzers als seine *Benutzer-ID* und *Konto-ID*. Datumsangaben sollten formatiert sein als [Millisekunden seit dem Unix-Epoch](https://currentmillis.com/). Laden Sie ein [Beispiel der erforderlichen Felder herunter](https://res.cloudinary.com/product-enablement/raw/upload/v1750169976/CSVs/Migration_User_Import_examples_-_User_Data.csv) oder verwenden Sie 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,Vorname,Nachname,1741051242000,en_US,US, User2@example.com,User2@example.com,User2@example.com,Vorname,Nachname,,,,"vip,newuser" User3@example.com,User3@example.com,User3@example.com,Vorname,Nachname,,en_CA,, User4@example.com,User4@example.com,User4@example.com,Vorname,Nachname,,,,newuser ``` Dies umfasst Start- und Konversionsdaten sowie Verweis-/Empfohlen-Beziehungen. Es unterstützt die Abbildung der historischen Empfehlungsleistung. Die Datei mit den Empfehlungsdaten liefert einen Nachweis über den Status jeder in Ihrem Empfehlungsprogramm hergestellten Empfehlungsverbindung. Die folgenden Felder sind **erforderlich**: * Advocate-Benutzer-ID * Advocate-Konto-ID * ID des empfohlenen Benutzers * Konto-ID des empfohlenen Benutzers Verwenden Sie die E-Mail-Adresse des Benutzers als seine *Benutzer-ID* und *Konto-ID*. Datumsangaben sollten formatiert sein als [Millisekunden seit dem Unix-Epoch](https://currentmillis.com/). Laden Sie ein [Beispiel der erforderlichen Felder herunter](https://res.cloudinary.com/product-enablement/raw/upload/v1750249453/CSVs/Migration_User_Import_examples_-_Referral_Data_-_Referral_Data.csv) oder verwenden Sie 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, Datum der Gewährung/Einlösung, Belohnungstypen und Status. Es hilft dabei, Glaubwürdigkeit und Fairness gegenüber den Benutzern zu wahren. Die Datei mit den Belohnungsdaten liefert einen Nachweis über die Belohnungshistorie der Teilnehmer, einschließlich ihres Werts und des eingelösten Betrags, der über Ihr Empfehlungsprogramm erzeugt wurde. Die folgenden Felder sind **erforderlich**: * Advocate-Benutzer-ID * Advocate-Konto-ID * Belohnungsname * Belohnungseinheit * Belohnungswert * Erstellungsdatum * Gewährungsdatum * Einlösungsdatum * Eingelöster Betrag Verwenden Sie die E-Mail-Adresse des Benutzers als seine *Benutzer-ID* und *Konto-ID*. Datumsangaben sollten formatiert sein als [Millisekunden seit dem Unix-Epoch](https://currentmillis.com/). Der Belohnungswert ist der numerische Wert der Belohnung in ihrer kleinsten Maßeinheit (z. B. würde der Wert bei einer Geldbelohnung von 1,00 $ 100 Cent betragen). Wenn die Belohnungseinheit Bargeld ist, sollte sie den Währungscode im folgenden Format enthalten `/` (z. B. Bargeld/USD). {% hint style="warning" %} **Wichtig**: Wenn die *Einlösungsdatum* und *Eingelöster Betrag* Felder nicht korrekt gesetzt sind — das heißt, sie sind entweder leer oder enthalten falsche Werte (z. B. ein zukünftiges Datum oder einen ungenauen eingelösten Betrag) — kann die Belohnung für den Benutzer erneut zur Einlösung verfügbar werden. {% endhint %} Laden Sie ein [Beispiel der erforderlichen Felder herunter](https://res.cloudinary.com/product-enablement/raw/upload/v1750249453/CSVs/Migration_User_Import_examples_-_Reward_Data_-_Reward_Data.csv) oder verwenden Sie das folgende Beispiel im `.csv` Format. ```programlisting Benutzer-ID,Konto-ID,ID des empfohlenen Benutzers,Konto-ID des empfohlenen Benutzers,Belohnungsname,Belohnungseinheit,Belohnungswert,Eingelöster Betrag,Erstellungsdatum,Gewährungsdatum,Einlösungsdatum 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,Punkte,POINT,100,100,1726164909682,1726164909682,1726164909682 User1@example.com,User1@example.com,User4@example.com,User4@example.com,Punkte,POINT,100,100,1726164887075,1726164887075,1726164887075 User1@example.com,User1@example.com,User5@example.com,User5@example.com,Punkte,POINT,100,100,1726164875888,1726164875888,1726164875888 User1@example.com,User1@example.com,User6@example.com,User6@example.com,Punkte,POINT,10,10,1726164828986,1726164828986,1726164828986 User1@example.com,User1@example.com,User7@example.com,User7@example.com,Konto-Guthaben,USD,8000,8000,1726164289997,1726164289997,1726164289997 User1@example.com,User1@example.com,,,Geschenkkarte,USD,10000,10000,1726163864871,1726163864871,1726163864871 User1@example.com,User1@example.com,,,Punkte,POINT,800,800,1726095906392,1726095906392,1726095906392 User1@example.com,User1@example.com,,,Geschenkkarte,USD,30000,30000,1726163769157,1726163769157,1726163769157 User1@example.com,User1@example.com,,,20 % Rabatt,%,20,20,1726180309034,1726180309034,1726180309034 ``` {% hint style="warning" %} **Wichtig:** Alle 3 Exportdateien sollten Daten nur aus einem einzigen Programm enthalten. Wenn die Dateien Daten aus mehreren Programmen enthalten, wird der Import sie in einem einzigen Programm zusammenführen. {% endhint %}
Ein Beispiel für einen Migrationsplan Jede Migration ist einzigartig, aber erfolgreiche folgen einer ähnlichen Struktur, die Vorbereitung, Kommunikation und Umsetzung in Einklang bringt. Unten finden Sie einen Migrationsplan, der Kontinuität und ein nahtloses Erlebnis sowohl für Ihr Team als auch für Ihre Advocates sicherstellt. Zeitpläne und Phasen können je nach Programmkonfiguration variieren. **Phase 1: Planung und Vorbereitung (1–2 Wochen)** Dies ist Ihre Phase, in der das Fundament gelegt wird und die Basis für einen reibungslosen Übergang geschaffen wird. | | | | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Ziele |

• Stakeholder abstimmen.

• Technische Einrichtung.

• Migrationsumfang bestätigen.

• Benutzerkommunikation planen.

| | Aufgaben |

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

• Exportieren Sie vollständige Datensätze, sobald das Beispiel validiert wurde. Die Exportdaten müssen höchstwahrscheinlich bearbeitet werden (z. B. Anpassung von Überschriften, 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 Programmkfiguration in Advocate ab (z. B. Belohnungseinrichtung, 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 erfasst werden, bevor Sie live gehen.

• Entwerfen Sie Mitteilungen, um den Übergang an Advocates zu kommunizieren.

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

| | Tipps |

• Wenn Sie Plattformen parallel betreiben, stellen Sie sicher, dass nur eine Belohnungen ausgibt.

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

| **Phase 2: Umstellung und Go-live (1–2 Tage)** Dies ist Ihr Übergangsmoment. Planen Sie eine kurze Pause beim Tracking zwischen den Systemen ein und legen Sie nach Möglichkeit Zeiten mit geringem Traffic fest. | | | | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 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 Website.

• Schalten Sie Advocate-Widgets live.

• Importieren Sie endgültige Benutzer-, Empfehlungs- und Belohnungsdaten.

• Verfolgen/markieren Sie manuell alle Konversionen zwischen der Abschaltung des alten Systems und dem Start.

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

• Senden Sie eine Startmitteilung an Ihre Advocates. Teilen Sie den Benutzern mit, 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 Belohnungs-Blackout-Puffer hinzu (z. B. „Empfehlungen, die am 15. Mai gemacht werden, werden geprüft und nach dem Start hinzugefügt.“).

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

| **Phase 3: Nach der Migration und Bereinigung (1–2 Tage)** Jetzt, da Sie live sind, stellen Sie sicher, dass Ihr Programm wie erwartet funktioniert, und klären Sie alle offenen Punkte. | | | | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Ziele |

• Datenintegrität und Belohnungstracking überprüfen.

• Verpasste Konversionen erfassen.

• Benutzer unterstützen und informieren.

| | Aufgaben |

• Validieren, dass Verweiser-/Empfangen-Beziehungen im Live-Modus funktionieren.

• Alle verpassten Konversionen importieren, die während der Umstellung aufgetreten sind.

• Einen QA-Test durchführen (sich selbst werben, Tracking und Belohnungslogik bestätigen).

• Interne und externe FAQs oder Hilfedokumente bereitstellen.

• Das Support-Postfach auf Probleme im Zusammenhang mit Altnutzern überwachen.

| | Tipps |

• Wenn Sie ein altes Belohnungs-Finanzierungskonto auslaufen lassen, geben Sie den Benutzern eine Schonfrist zum Einlösen.

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

|
#### Importieren Sie die Daten Ihres 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 | | --------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Benutzer | Wählen Sie diese Option, um neue Benutzer oder vorhandene 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 Benutzerguthaben für Belohnungen 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 in großen Mengen löschen möchten.

Sie können auch die Benutzerverwaltung löschen und sich dafür entscheiden:

• Leere Konten beibehalten

• Verhindern, dass gelöschte Benutzer erneut erstellt werden

| | Belohnungshistorie | Wählen Sie diese Option, um einen Datensatz 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 einen Datensatz aller Empfehlungsverbindungen hochzuladen. Sie können diese Daten auch aus einem anderen Konto oder einer anderen Plattform importieren. | 4. Wählen Sie **Datei auswählen** oder ziehen Sie die Datei, die Sie importieren möchten, per Drag & Drop hinein. 5. Wählen Sie **Importieren** um Ihre Daten hochzuladen. * Wenn Sie vorhandene Benutzer in großen Mengen löschen, wählen Sie **Massenlöschung**. #### Referenz zu Validierungsfehlern Sie können 3 Arten von Validierungsfehlern erhalten: 1. **Inline-Fehlermeldung:** diese erscheinen in der VorschaulValidierungstabelle und führen dazu, dass Fehlerzeilen rot hervorgehoben werden: * `INVALID_FIELD` — z. B. wurde das *Erstellungsdatum* Feld nicht in [Millisekunden seit dem Unix-Epoch](https://currentmillis.com/) . * `MISSING_FIELD` — z. B. ein erforderliches Feld wie *Benutzer-ID* oder *Konto-ID* fehlt.
2. **Fehlerhinweis:** diese erscheinen anstelle der VorschaulValidierungstabelle 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 *Berichte* Abschnitts, wenn der Importtyp keine VorschaulValidierungstabelle hat. Zeilenfehler und Dateifehler werden gemeinsam angezeigt:
#### Support Sie müssen die Migration nicht allein bewältigen. Unser Advocate-Onboarding-Team unterstützt Sie gerne bei: * Unterstützung bei der Feldzuordnung * Anleitung zur Datenformatierung * Strategie für die Migration von Belohnungen * Tests und QA Kontaktieren Sie Ihr [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.