> 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 Empfehlungsprogrammdaten 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 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: * Unterbrechungen Ihres Empfehlungs-Erlebnisses minimieren * Historische Daten bewahren und die Kontinuität der Belohnungen sicherstellen ![](https://1698965099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c11b6248bd7b0ef1b687330c8c79fba510517058%2Ff18ad34bbbcaa64fb7feb774bf5d7e154b2a259f3a75f2c3b60ec0ed3ed2371d.svg?alt=media) * Einen sauberen Bruch von Altsystemen ermöglichen * Ihr Empfehlungsprogramm mit Begeisterung und Klarheit neu einführen ![](https://1698965099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c11b6248bd7b0ef1b687330c8c79fba510517058%2Ff18ad34bbbcaa64fb7feb774bf5d7e154b2a259f3a75f2c3b60ec0ed3ed2371d.svg?alt=media) Die Migration von Empfehlungen und Belohnungen hängt von Ihrer Fähigkeit ab, Daten aus Ihrem aktuellen System zu exportieren. Ihr Advocate-Team kann Ihnen anhand der von Ihnen bereitgestellten Exportdaten sagen, was möglich ist. Ihr Advocate-Team wird mit Ihnen zusammenarbeiten, um Ihre Exportdateien zu prüfen, festzustellen, was machbar ist, und einen Plan zu erstellen, der den Anforderungen und Zielen Ihres Programms entspricht. #### Was Sie tun müssen * Exportieren Sie die *Nutzerdaten*, *Empfehlungsdaten*, und *Belohnungsdaten*. Entweder kontaktieren Sie Ihren CSM auf Ihrer alten Empfehlungsplattform um Unterstützung, 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`. * Siehe die folgenden Beispiele für den Inhalt jeder .csv-Datei, oder sehen Sie sich die vollständige Referenz des Destination-Feldes an. Dazu gehören E-Mails, Empfehlungscodes, Sharelinks ![](https://1698965099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c11b6248bd7b0ef1b687330c8c79fba510517058%2Ff18ad34bbbcaa64fb7feb774bf5d7e154b2a259f3a75f2c3b60ec0ed3ed2371d.svg?alt=media), und benutzerdefinierte Felder. Affiliates sollten herausgefiltert werden, um doppelte Belohnungen zu vermeiden. ![](https://1698965099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c11b6248bd7b0ef1b687330c8c79fba510517058%2Ff18ad34bbbcaa64fb7feb774bf5d7e154b2a259f3a75f2c3b60ec0ed3ed2371d.svg?alt=media) Abhängig vom Sharelink-Format und der Verwendung einer benutzerdefinierten Subdomain. Die Datei mit den Nutzerdaten enthält detaillierte Informationen über jeden Teilnehmer Ihres Programms. Exportieren Sie eine Liste aller Teilnehmer, um Ihr Programm mit deren Sharelinks und Empfehlungscodes auf dem neuesten Stand zu halten. Die folgenden Felder sind **erforderlich**: * Nutzer-ID * Konto-ID Verwenden Sie die E-Mail-Adresse des Nutzers als seine *Nutzer-ID* und *Konto-ID*. Datumsangaben sollten im Format [Millisekunden seit Unix-Epoche](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) 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 ``` Dazu gehören Start- und Konversionsdaten sowie Beziehungen zwischen Empfehlendem und Empfohlenem. Es unterstützt die Zuordnung der historischen Empfehlungsleistung. Die Datei mit den Empfehlungsdaten enthält einen Datensatz zum Status jeder Empfehlungsverbindung in Ihrem Empfehlungsprogramm. Die folgenden Felder sind **erforderlich**: * Advocate-Nutzer-ID * Advocate-Konto-ID * Empfohlene Nutzer-ID * Empfohlene Konto-ID Verwenden Sie die E-Mail-Adresse des Nutzers als seine *Nutzer-ID* und *Konto-ID*. Datumsangaben sollten im Format [Millisekunden seit Unix-Epoche](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) 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 ``` Dazu gehören Werte, vergebene/eingelöste Daten, Belohnungstypen und Status. So lassen sich Glaubwürdigkeit und Fairness gegenüber den Nutzern bewahren. Die Datei mit den Belohnungsdaten enthält einen Datensatz zur Belohnungshistorie der Teilnehmer, einschließlich des Werts und des eingelösten Betrags, der über Ihr Empfehlungsprogramm erzeugt wurde. Die folgenden Felder sind **erforderlich**: * Advocate-Nutzer-ID * Advocate-Konto-ID * Belohnungsname * Belohnungseinheit * Belohnungswert * Erstellungsdatum * Datum der Vergabe * Einlösedatum * Eingelöster Betrag Verwenden Sie die E-Mail-Adresse des Nutzers als seine *Nutzer-ID* und *Konto-ID*. Datumsangaben sollten im Format [Millisekunden seit Unix-Epoche](https://currentmillis.com/). Der Belohnungswert ist der numerische Wert der Belohnung in ihrer kleinsten Maßeinheit (z. B. würde der Wert bei einer Geldprämie von 1,00 $ 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 Nutzer 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) 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 einzelnen Programm enthalten. Wenn die Dateien Daten aus mehreren Programmen enthalten, fasst der Import sie zu einem einzigen Programm zusammen. {% endhint %}
Ein beispielhafter 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 für Ihr Team und Ihre Fürsprecher sicherstellt. Zeitpläne und Phasen können je nach Programmkonfiguration variieren. **Phase 1: Planung und Vorbereitung (1–2 Wochen)** Dies ist Ihre Phase zum Setzen des Fundaments und zum Schaffen der Grundlage für einen reibungslosen Übergang. | | | | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Ziele |

• Beteiligte abstimmen.

• Technische Einrichtung.

• Migrationsumfang bestätigen.

• Nutzerkommunikation planen.

| | Aufgaben |

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

• Exportieren Sie die vollständigen Datensätze, sobald das Beispiel validiert wurde. Die Exportdaten müssen höchstwahrscheinlich angepasst werden (z. B. Header, Feldnamen oder Dateistruktur), damit sie den Importanforderungen 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 Programmfunktionalität von Anfang bis Ende — bestätigen Sie in einer Testumgebung vor dem Go-live, dass Freigaben, Konversionen und Belohnungen korrekt erfasst werden.

• Entwerfen Sie die Kommunikation, um den Übergang den Fürsprechern mitzuteilen.

Die Migration von Empfehlungen und Belohnungen hängt von Ihrer Fähigkeit ab, Daten aus Ihrem aktuellen System zu exportieren. Ihr Advocate-Team kann Ihnen anhand der von Ihnen bereitgestellten Exportdaten sagen, was möglich ist.

| | Tipps |

• Wenn sich die Plattformen überschneiden, 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 Moment des Übergangs. Planen Sie eine kurze Unterbrechung des Trackings zwischen den Systemen ein und legen Sie den Zeitpunkt nach Möglichkeit in verkehrsarme Stunden. | | | | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Ziele |

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

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

• Vermeiden Sie den Verlust von Empfehlungsdaten oder Belohnungen.

| | Aufgaben |

• Entfernen Sie die alten Skripte/Widgets der Plattform von Ihrer Website.

• Schalten Sie die Advocate-Widgets live.

• Importieren Sie die endgültigen Nutzer-, Empfehlungs- und Belohnungsdaten.

• Verfolgen/markieren Sie manuell alle Konversionen zwischen Abschaltung des Systems und dem Launch.

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

• Versenden Sie die Launch-Kommunikation an Ihre Fürsprecher. Informieren Sie die Nutzer, 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 vom 15. Mai werden geprüft und nach dem Launch hinzugefügt.“).

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

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

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

• Erfassen Sie alle verpassten Konversionen.

• Unterstützen und schulen Sie die Nutzer.

| | Aufgaben |

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

• Importieren Sie alle verpassten Konversionen, die zwischen der Umstellung aufgetreten sind.

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

• Stellen Sie interne und externe FAQs oder Hilfedokumente bereit.

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

| | Tipps |

• Wenn Sie ein Altsystem-Konto zur Finanzierung von Belohnungen auslaufen lassen, gewähren Sie den Nutzern eine Schonfrist für die Einlösung.

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

|
#### Importieren Sie die Daten Ihres Programms 1. Wählen Sie im linken Navigationsmenü ![](https://1698965099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[Engage] → Berichterstattung → Importe & Exporte**. 2. Wählen Sie in der oberen rechten Ecke ![](https://1698965099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-ec3276f07285180fbb2167a40e148d3e43e8681c%2F05aa88f72076df5a744d4620574f19cc187b7154fe1f3bb73ad7a892b7d23002.svg?alt=media) **Import**. 3. Wähle das *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 einer anderen Plattform importieren. | | Nutzer-Belohnungssalden aktualisieren | Wählen Sie diese Option, um Nutzer-Belohnungssalden zu aktualisieren und einzulösen. | | Nutzerereignisse | Wählen Sie diese Option, um Nutzerereignisdaten hochzuladen. | | Nutzer löschen |

Wählen Sie diese Option, wenn Sie vorhandene Nutzer aus Ihrem Programm in großen Mengen löschen möchten.

Sie können außerdem die Handhabung gelöschter Nutzer festlegen und sich für Folgendes entscheiden:

• Leere Konten beibehalten

• Verhindern, dass gelöschte Nutzer 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 **Import** um Ihre Daten hochzuladen. * Wenn Sie vorhandene Nutzer 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 Validierungsvorschau-Tabelle und führen dazu, dass fehlerhafte Zeilen rot hervorgehoben werden: * `INVALID_FIELD` — z. B. wurde das *Erstellungsdatum* Feld nicht im Format [Millisekunden seit Unix-Epoche](https://currentmillis.com/) . * `MISSING_FIELD` — z. B. fehlt ein erforderliches Feld wie *Nutzer-ID* oder *Konto-ID* ist leer.
2. **Fehlerhinweis:** Diese erscheinen anstelle der Validierungsvorschau-Tabelle als rote Warnmeldungen: * `MISSING_HEADER` — z. B. fehlt eine erforderliche Spaltenüberschrift wie *Konto-ID* oder *Belohnungswert* ist leer. * `CSV_PARSING` — z. B. enthält die CSV-Datei Sonderzeichen, die nicht korrekt 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 im *Reporting* Abschnitt, wenn der Importtyp keine Validierungsvorschau-Tabelle hat. Zeilenfehler und Dateifehler werden zusammen angezeigt:
#### den Support Sie müssen die Migration nicht allein bewältigen. Unser Advocate-Onboarding-Team hilft Ihnen gerne bei: * Unterstützung bei der Feldzuordnung * Anleitung zur Datenformatierung * Strategie für die Belohnungsmigration * Testen 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 by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` 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 what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. 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.