# 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 Chance, die Art und Weise zu verbessern, wie Sie Ihre Kunden einbinden und belohnen. Eine gut geplante Migration hilft dabei: * Störungen Ihres Empfehlungserlebnisses zu minimieren * Historische Daten zu bewahren und die Kontinuität der Belohnungen sicherzustellen ![](/files/11a3200e987d0b74a8dbcd82ae3eb408806545d2) * Einen sauberen Bruch mit 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, ob 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, herauszufinden, was machbar ist, und einen Plan zu erstellen, der zu den Anforderungen und Zielen Ihres Programms passt. #### Was Sie tun müssen * Exportieren Sie die *Benutzerdaten*, *Empfehlungsdaten*, und *Belohnungsdaten*Ihres Programms. Wenden Sie sich entweder an Ihren CSM auf Ihrer alten Empfehlungsplattform, um Unterstützung zu erhalten, oder verwenden Sie ein Export-Tool innerhalb der Plattform, falls eines bereitgestellt wird. * 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 Zielfelder 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 auf dem neuesten Stand bleibt. Die folgenden Felder sind **erforderlich**: * Benutzer-ID * Konten-ID Verwenden Sie die E-Mail des Benutzers als seine *Benutzer-ID* und *Konten-ID*. Datumsangaben sollten formatiert sein in [Millisekunden seit dem Unix-Epoch](https://currentmillis.com/). Laden Sie ein [Beispiel der erforderlichen Felder](https://res.cloudinary.com/product-enablement/raw/upload/v1750169976/CSVs/Migration_User_Import_examples_-_User_Data.csv) herunter oder verwenden Sie das folgende Beispiel in `.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 Beziehungen zwischen Empfehlendem und Empfohlenem. Es unterstützt die Abbildung der historischen Empfehlungsleistung. Die Datei mit den Empfehlungsdaten liefert eine Aufzeichnung des Status jeder in Ihrem Empfehlungsprogramm erstellten Empfehlungsverbindung. Die folgenden Felder sind **erforderlich**: * Advocate-Benutzer-ID * Advocate-Konten-ID * Benutzer-ID des Empfohlenen * Konten-ID des Empfohlenen Verwenden Sie die E-Mail des Benutzers als seine *Benutzer-ID* und *Konten-ID*. Datumsangaben sollten formatiert sein in [Millisekunden seit dem Unix-Epoch](https://currentmillis.com/). Laden Sie 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 verwenden Sie das folgende Beispiel in `.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, Ausgabedaten und Einlösedaten, Belohnungstypen und Status. Es trägt dazu bei, Glaubwürdigkeit und Fairness gegenüber den Nutzern zu bewahren. Die Datei mit den Belohnungsdaten liefert eine Aufzeichnung der 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-Konten-ID * Belohnungsname * Belohnungseinheit * Belohnungswert * Erstellungsdatum * Ausgabedatum * Einlösedatum * Eingelöster Betrag Verwenden Sie die E-Mail des Benutzers als seine *Benutzer-ID* und *Konten-ID*. Datumsangaben sollten formatiert sein in [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 bei einer Geldprämie von 1,00 $ der Wert 100 Cent betragen). Wenn die Belohnungseinheit Bargeld ist, sollte sie den Währungscode im folgenden Format enthalten `/` (z. B. Cash/USD). {% hint style="warning" %} **Wichtig**: Wenn die *Einlösedatum* und *Eingelöster Betrag* Felder nicht korrekt gesetzt sind — also entweder leer bleiben oder falsche Werte enthalten (z. B. ein zukünftiges Datum oder ein ungenauer eingelöster Betrag) — kann die Belohnung für den Benutzer erneut zur Einlösung verfügbar werden. {% endhint %} Laden Sie 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 verwenden Sie das folgende Beispiel in `.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,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 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 Umsetzung ausbalanciert. Unten sehen Sie einen 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 angepasst werden. **Phase 1: Planung und Vorbereitung (1–2 Wochen)** Dies ist Ihre Phase, in der das Fundament gelegt wird — die Basis für einen reibungslosen Übergang. | | | | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Ziele |

• Beteiligte abstimmen.

• Technische Einrichtung.

• Migrationsumfang bestätigen.

• Benutzerkommunikation planen.

| | Aufgaben |

• Sichern Sie einen Beispiel-Datensatz Ihrer historischen Daten (Benutzer, Empfehlungen, Belohnungen) und teilen Sie ihn mit dem Advocate-Team zur Prü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 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 die erforderlichen 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 Funktionalität des Programms von Anfang bis Ende — bestätigen Sie in einer Testumgebung vor dem Livegang, dass Shares, Konversionen und Belohnungen korrekt erfasst werden.

• Entwerfen Sie Mitteilungen, um den Übergang für 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 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 eine besondere Behandlung benötigen (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 legen Sie, wenn möglich, Zeiten mit geringem Traffic fest. | | | | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Ziele |

• Wechseln Sie nahtlos von Ihrer alten 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 die endgültigen Benutzer-, Empfehlungs- und Belohnungsdaten.

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

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

• Senden Sie eine Startkommunikation an Ihre Advocates. Teilen Sie den Nutzern 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 ein (z. B. „Empfehlungen, die am 15. Mai erstellt werden, werden geprüft und nach dem Start hinzugefügt.“).

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

| **Phase 3: Nach der Migration und Bereinigung (1–2 Tage)** Jetzt, da Ihr Programm live ist, stellen Sie sicher, dass es wie erwartet funktioniert, und kümmern Sie sich um offene Punkte. | | | | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Ziele |

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

• Erfassen Sie alle verpassten Konversionen.

• Unterstützen und schulen Sie die Nutzer.

| | Aufgaben |

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

• Importieren Sie alle verpassten Konversionen, die während der Umstellung aufgetreten sind.

• Führen Sie einen QA-Test durch (empfehlen 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 mit alten Nutzern.

| | Tipps |

• Wenn Sie ein altes Belohnungs-Finanzierungskonto auslaufen lassen, geben Sie den Nutzern eine Nachfrist, um ihre Belohnungen einzulösen.

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

|
#### Importieren Sie die Daten Ihres Programms 1. Wählen Sie im linken Navigationsmenü ![](/files/8189ccdb3d6833e64eac05afbd5a6e7ceadce224) **\[Engage] → Berichterstellung → Importe & Exporte**. 2. Wählen Sie oben rechts ![](/files/35332659ecce74be9f92ede33e67b850a096b176) **Importieren**. 3. Wählen Sie das *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 Benutzer-Belohnungssalden zu aktualisieren und einzulösen. | | Benutzerereignisse | Wählen Sie diese Option, um Benutzereventdaten 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 Benutzerbehandlung löschen und sich entscheiden für:

• 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 Sie **Datei auswählen** oder ziehen Sie die Datei, die Sie importieren möchten, per Drag-and-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 Es gibt 3 Arten von Validierungsfehlern: 1. **Inline-Fehlermeldung:** diese erscheinen in der Vorschau-Validierungstabelle und führen dazu, dass Fehlerzeilen rot hervorgehoben werden: * `UNGÜLTIGES_FELD` — z. B. wurde das *Erstellungsdatum* Feld nicht in [Millisekunden seit dem Unix-Epoch](https://currentmillis.com/) . * `FEHLENDES_FELD` — z. B. ein erforderliches Feld wie *Benutzer-ID* oder *Konten-ID* fehlt.
2. **Fehlerhinweis:** diese erscheinen anstelle der Vorschau-Validierungstabelle als rote Warnmeldungen: * `FEHLENDE_KOPFZEILE` — z. B. eine erforderliche Spaltenüberschrift wie *Konten-ID* oder *Belohnungswert* fehlt. * `CSV_PARSING` — z. B. enthält die CSV-Datei Sonderzeichen, die fehlerhaft 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 *Im- und Exporte* Bildschirm im *Berichterstellung* Abschnitt, wenn der Importtyp keine Vorschau-Validierungstabelle hat. Zeilenfehler und Datei-Fehler werden zusammen angezeigt:
#### Support Sie müssen die Migration nicht allein bewältigen. Unser Onboarding-Team von Advocate unterstützt Sie gerne bei: * Unterstützung bei der Feldzuordnung * Anleitung zur Datenformatierung * Strategie für die Migration von Belohnungen * Tests und Qualitätssicherung Kontaktieren Sie Ihr [Advocate-Supportteam](mailto:support-advocate@impact.com). --- # Agent Instructions: 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: ``` GET https://help.impact.com/brand/de/woruber-mochten-sie-mehr-erfahren/advocate-program/getting-started-with-advocate/import-your-referral-program-data.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.