> 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 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 ![](/files/11a3200e987d0b74a8dbcd82ae3eb408806545d2) * Einen klaren Bruch mit Altsystemen zu ermöglichen * Ihr Empfehlungsprogramm mit Begeisterung und Klarheit neu einzuführen ![](/files/11a3200e987d0b74a8dbcd82ae3eb408806545d2) 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 ![](/files/11a3200e987d0b74a8dbcd82ae3eb408806545d2)und benutzerdefinierte Felder. Affiliates sollten herausgefiltert werden, um doppelte Prämien zu vermeiden. ![](/files/11a3200e987d0b74a8dbcd82ae3eb408806545d2) 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](https://currentmillis.com/). Laden Sie ein [Beispiel für die 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 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 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](https://currentmillis.com/). Laden Sie ein [Beispiel für die 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 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 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](https://currentmillis.com/). 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 `/` (z. B. Cash/USD). {% hint style="warning" %} **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. {% endhint %} Laden Sie ein [Beispiel für die 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 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, wird der Import diese 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 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ü ![](/files/8189ccdb3d6833e64eac05afbd5a6e7ceadce224) **\[Engage] → Berichte → Importe & Exporte**. 2. Wählen Sie oben rechts ![](/files/35332659ecce74be9f92ede33e67b850a096b176) **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](https://currentmillis.com/) . * `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](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.