> 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 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: * Unterbrechungen Ihres Empfehlungserlebnisses minimieren * Historische Daten bewahren und die Kontinuität der Prämien 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 Schnitt 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 Prämien hängt davon ab, dass Sie Daten aus Ihrem aktuellen System exportieren können. Ihr Advocate-Team kann Ihnen auf Grundlage der von Ihnen bereitgestellten Exportdaten sagen, was möglich ist. Ihr Advocate-Team arbeitet mit Ihnen zusammen, prüft Ihre Exportdateien, identifiziert, was umsetzbar ist, und erstellt einen Plan, der zu den Anforderungen und Zielen Ihres Programms passt. #### Was Sie tun müssen * Exportieren Sie die *Benutzerdaten*, *Empfehlungsdaten*, und *Prämiendaten*. Wenden Sie sich entweder an Ihren CSM auf Ihrer alten Empfehlungsplattform, um Unterstützung zu erhalten, oder verwenden Sie ein Exporttool 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 dafür, wie der Inhalt jeder .csv-Datei aussehen könnte, oder sehen Sie die vollständige Referenz für das Zielfeld. 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 Doppelbelohnungen 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 Benutzerdaten enthält ausführliche Informationen zu jedem Teilnehmer Ihres Programms. Exportieren Sie eine Liste aller Teilnehmer, damit Ihr Programm mit ihren Freigabelinks 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 sein als [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 Beispiel unten in `.csv` Format gespeichert wird. ```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 Referrer-/Empfohlenen-Beziehungen. Es unterstützt die Zuordnung der historischen Empfehlungsleistung. Die Datei mit den Empfehlungsdaten enthält einen Datensatz über den Status jeder in Ihrem Empfehlungsprogramm erstellten Empfehlungsverknüpfung. Die folgenden Felder sind **erforderlich**: * Advocate-Benutzer-ID * Advocate-Konto-ID * Benutzer-ID des Empfohlenen * Konto-ID des Empfohlenen Verwenden Sie die E-Mail-Adresse des Nutzers als seine *Benutzer-ID* und *Konto-ID*. Datumsangaben sollten formatiert sein als [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 Beispiel unten in `.csv` Format gespeichert wird. ```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, Prämienarten und Status. So lassen sich Glaubwürdigkeit und Fairness gegenüber den Nutzern bewahren. Die Datei mit den Prämiendaten enthält einen Datensatz über die Prämienhistorie der Teilnehmer, einschließlich ihres Werts und des eingelösten Betrags, die über Ihr Empfehlungsprogramm erzeugt wurden. Die folgenden Felder sind **erforderlich**: * Advocate-Benutzer-ID * Advocate-Konto-ID * Prämienname * Prämieneinheit * Belohnungswert * Erstellungsdatum * Vergebungsdatum * Einlösedatum * Eingelöster Betrag Verwenden Sie die E-Mail-Adresse des Nutzers als seine *Benutzer-ID* und *Konto-ID*. Datumsangaben sollten formatiert sein als [Millisekunden seit Unix-Epoche](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. Bargeld/USD). {% hint style="warning" %} **Wichtig**: Wenn die *Einlösedatum* und *Eingelöster Betrag* Felder nicht korrekt festgelegt sind – das heißt, sie sind entweder leer gelassen oder enthalten falsche Werte (z. B. ein zukünftiges Datum oder einen ungenauen eingelösten Betrag) – kann die Prämie dem Nutzer erneut zur Einlösung zur Verfügung stehen. {% 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 Beispiel unten in `.csv` Format gespeichert wird. ```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, fasst der Import sie zu einem einzigen Programm zusammen. {% endhint %}
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 eine nahtlose Erfahrung für Ihr Team und Ihre Fürsprecher sicherstellt. Zeitpläne und Phasen können je nach Ihrer Programmkfiguration variieren. **Phase 1: Planung und Vorbereitung (1–2 Wochen)** Dies ist die Phase, in der Sie das Fundament legen und die Voraussetzungen für einen reibungslosen Übergang schaffen. | | | | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Ziele |

• Stakeholder abstimmen.

• Technische Einrichtung.

• Migrationsumfang bestätigen.

• Benutzerkommunikation planen.

| | Aufgaben |

• Einen Stichprobensatz Ihrer historischen Daten (Benutzer, Empfehlungen, Prämien) sichern und dem Advocate-Team zur Prüfung und Feldzuordnung übermitteln .

• Vollständige Datensätze exportieren, sobald die Stichprobe validiert wurde. Die Exportdaten müssen höchstwahrscheinlich angepasst werden (z. B. Überschriften, 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 verlinkte Seiten).

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

• Die Programmkonfiguration in Advocate abschließen (z. B. Prämieneinrichtung, Programmregeln, E-Mail-Vorlagen, Segmentierung).

• Die Programmfunktionalität End-to-End testen — bestätigen, dass Freigaben, Konversionen und Prämien in einer Testumgebung korrekt erfasst werden, bevor Sie live gehen.

• Die Kommunikation entwerfen, um Fürsprecher über den Übergang zu informieren.

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

| | Tipps |

• Wenn Sie Plattformen parallel betreiben, stellen Sie sicher, dass nur eine davon Prämien vergibt.

• 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 Unterbrechung des Trackings zwischen den Systemen ein und legen Sie nach Möglichkeit Zeiten mit geringem Traffic fest. | | | | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Ziele |

• Nahtlos von Ihrer Altplattform zu Advocate wechseln.

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

• Den Verlust von Empfehlungsdaten oder Prämien vermeiden.

| | Aufgaben |

• Alte Plattform-Skripte/Widgets von Ihrer Website entfernen.

• Advocate-Widgets live schalten.

• Finale Benutzer-, Empfehlungs- und Prämiendaten importieren.

• Alle Konversionen zwischen Abschaltung des alten Systems und Start manuell erfassen/kennzeichnen.

• Das Advocate-Dashboard auf Aktivität überwachen.

• Eine Startkommunikation an Ihre Fürsprecher versenden. Teilen Sie den Nutzern mit, dass ihre Empfehlungslinks aktualisiert wurden, und fügen Sie die neuen Links idealerweise direkt in die E-Mail ein, damit sie sofort mit dem Teilen beginnen können.

| | Tipps |

• Falls nötig, einen kurzen Sperrzeitpuffer für Prämien einplanen (z. B. „Empfehlungen, die am 15. Mai abgegeben wurden, werden geprüft und nach dem Start hinzugefügt.“).

• Kommunizieren Sie an die Fürsprecher, um Begeisterung zu erzeugen (z. B. „Wir haben Ihr Empfehlungserlebnis 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 alle offenen Punkte. | | | | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Ziele |

• Datenintegrität und Prämien-Tracking überprüfen.

• Alle verpassten Konversionen erfassen.

• Nutzer unterstützen und schulen.

| | Aufgaben |

• Validieren, dass die Beziehungen zwischen Empfehlendem und Empfohlenem 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.

• Den Support-Posteingang auf Probleme im Zusammenhang mit Altnutzern überwachen.

| | Tipps |

• Wenn Sie ein Altsystem-Konto zur Finanzierung von Prämien aus dem Betrieb nehmen, geben Sie den Nutzern eine Kulanzfrist zum Einlösen.

• Nutzen Sie E-Mail- oder In-App-Erinnerungen, um frühe Empfehlungsaktivität 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] → Berichte → Importe & Exporte**. 2. Wählen Sie oben rechts ![](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ä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-Prämienguthaben aktualisieren | Wählen Sie diese Option, um Benutzer-Prämienguthaben 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 Benutzerbehandlung deaktivieren und sich entscheiden:

• Leere Konten beibehalten

• Verhindern, dass gelöschte Benutzer erneut erstellt werden

| | Prämienhistorie | Wählen Sie diese Option, um einen Datensatz aller Prämieninformationen 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 Empfehlungsverknüpfungen 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 Benutzer in großen Mengen löschen, wählen Sie **Massenlöschung**. #### Referenz zu Validierungsfehlern Sie können 3 Arten von Validierungsfehlern erhalten: 1. **Fehlermeldung inline:** 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 formatiert in [Millisekunden seit Unix-Epoche](https://currentmillis.com/) . * `MISSING_FIELD` — z. B. fehlt ein erforderliches Feld wie *Benutzer-ID* oder *Konto-ID* .
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* . * `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 der Fehleranzahlen auf dem *Importe & Exporte* Bildschirm im *Berichte* Abschnitt, wenn der Importtyp keine Validierungstabelle in der Vorschau hat. Zeilenfehler und Dateifehler werden zusammen angezeigt:
#### Support Sie müssen die Migration nicht allein bewältigen. Unser Advocate-Onboarding-Team ist bereit zu helfen bei: * Unterstützung bei der Feldzuordnung * Anleitung zur Datenformatierung * Strategie für die Prämienmigration * Tests und QA Wenden Sie sich an Ihren [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.