Hinzufügen von Verzeichniskontakten

Informationen zum Hinzufügen von Verzeichniskontakten

Die Registerkarte Verzeichniskontakte enthält alle Kontakte, die dem Verzeichnis Ihrer Organisation hinzugefügt wurden. Alle Kontakte, die einer Mailingliste hinzugefügt werden, werden automatisch zu diesem Verzeichnis hinzugefügt. Sie können jedoch auch direkt Personen zum Verzeichnis hinzufügen, indem Sie die Drucktaste Verzeichniskontakte hinzufügen wählen.

Projekte, die XM Directory-Kontakte verwenden können

Sie können XM Directory verwenden, um Kontaktlisten zu erstellen und Einladungen für verschiedene Arten von Qualtrics-Projekten zu senden. Allerdings ist nicht jeder Qualtrics-Projekttyp mit XM Directory kompatibel.

XM Directory kann verwendet werden, um Folgendes zu senden:

• Umfrageprojekte
• Conjoin / MaxDiff
• Bestimmte Nicht-EX-XM-Lösungen

XM Directory-Kontaktdaten sind jedoch vollständig von den im Mitarbeiterverzeichnis gespeicherten Mitarbeiter-/Teilnehmerinformationen getrennt. Das bedeutet, dass Daten, die in einem Verzeichnis bearbeitet werden, niemals Auswirkungen auf das andere Verzeichnis haben. XM Directory kann nicht verwendet werden, um Employee Experience-Projekte (EX-Projekte) zu verteilen, einschließlich Engagement, Pulse, 360 und mehr.

Verfügbare Kontaktfelder

Unabhängig davon, ob Sie eine CSV- oder TSV-Datei mit Kontakten hochladen oder diese manuell eingeben, müssen Sie bestimmte Informationen für Ihre Kontakte angeben.

• FirstName: Vorname des Kontakts.
• LastName: Nachname des Kontakts.
• E-Mail: Die E-Mail-Adresse des Kontakts. Es wird empfohlen, Duplikate aus diesem Feld zusammenzuführen.
• ExternalDataReference: Zusätzliche Informationen zum Kontakt. Dieses Feld wird meist verwendet, um Daten wie eine Mitarbeiter- oder Studenten-ID zu hinterlegen. Sie kann verwendet werden, um sich bei Authentifizierern anzumelden und zu konfigurieren, wie das Verzeichnis Duplikate zusammenführt.
• Eingebettete Daten: Eingebettete Daten sind zusätzliche Felder, die das gewünschte Feld enthalten. Sie müssen keine bestimmte Namenskonvention befolgen. Im obigen Screenshot sind Abteilung, Ort und Land alle eingebetteten Daten.
  Tipp: Eingebettete Datennamen haben maximal 200 Zeichen. Die Werte dürfen maximal 1024 Zeichen lang sein.
  Warnung: Bei allen eingebetteten Datenfeldern wurde bisher zwischen Groß- und Kleinschreibung unterschieden. Für die überwiegende Mehrheit der Benutzer wird bei eingebetteten Daten nicht mehr zwischen Groß- und Kleinschreibung unterschieden, d.h. „Test“ und „Test“ würden wie dasselbe Feld behandelt. Wir empfehlen jedoch, die Groß- und Kleinschreibung als Best Practice weiterhin beizubehalten, da diese Änderung in einem kleinen Teil der Benutzerkonten nicht vorgenommen wurde.
  Warnung: Verwenden Sie Punkte nicht als eingebettetes Datenfeld, da es sich um ein reserviertes Feld im XM Directory handelt. Verwenden Sie außerdem keines der anderen Qualtrics-Standardfelder.
• Sprache: Eine optionale Spalte, die die Sprache des Kontakts mithilfe von Sprachcodes identifiziert.
• Telefon: Eine optionale Spalte, die die Telefonnummer des Kontakts angibt. Informationen zu akzeptierten Telefonnummernformaten finden Sie auf der Supportseite für SMS-Verteilungen.

Datums- und Zeitdaten

Wenn Sie Daten eingebettet haben, die in einem Datumsformat gespeichert sind, können Sie einen Filter verwenden, um nach Datumsangaben in der Zukunft oder kürzlich aufgetretenen Daten zu suchen. Um nach Datum zu suchen, muss das Datumsfeld im ISO-8601-Format mit Uhrzeiten in UTC vorliegen. (d.h. JJJJ-MM-DDT-HH:mm:ss+ZZZZ .) Weitere Informationen zu diesen Symbolen finden Sie auf der Supportseite Datumsformatsyntax).

Datei hochladen

1. Klicken Sie auf Verzeichniskontakte hinzufügen.
   
2. Klicken Sie auf Datei hochladen.
   
3. Legen Sie in Excel ein Dokument mit den erforderlichen Feldern an, und sichern Sie es als CSV oder TSV. Oder klicken Sie auf Beispielvorlage herunterladen, füllen Sie die entsprechenden Spalten aus, fügen Sie beliebige eingebettete Daten hinzu, und sichern Sie die Datei.
   
4. Wenn die Datei fertig ist, ziehen Sie sie per Drag&Drop in den dafür vorgesehenen Bereich, oder klicken Sie auf Datei auswählen, und wählen Sie die Datei aus Ihrem Ordner aus.
5. Klicken Sie auf Weiter.
6. Überprüfen Sie die Kontaktimportbedingungen. Hier werden alle verzeichnisweiten Regeln zum Zusammenführen doppelter Kontakte angezeigt. Diese Regeln werden in den Verzeichniseinstellungen eingerichtet und gelten für die Kontakte in Ihrer Datei.
   
   Tipp: Für den Zugriff auf die Registerkarte „Verzeichniseinstellungen“ ist die Berechtigung „Verzeichnis verwalten“ erforderlich. Sprechen Sie mit Ihrem Administrator, wenn Sie Zugriff auf diese Einstellung haben möchten.
7. Überprüfen Sie die Felder in Ihrer Datei, um sicherzustellen, dass die Informationen korrekt sind. Wenn ein Feld nicht korrekt erkannt wurde, klicken Sie auf den Feldnamen, um ein Dropdown-Menü mit Optionen anzuzeigen, und wählen Sie das richtige Feld aus.
   Tipp: Wenn die Daten in der Vorschau nicht korrekt formatiert sind (z. B. gebündelt statt in Spalten aufgeteilt), werden Ihre Daten möglicherweise nicht korrekt getrennt (oder abgegrenzt). Um dies zu beheben, wählen Sie den blauen Link Optionen anzeigen, und wählen Sie ein anderes Trennzeichen und/oder Umschließen.
   Tipp: Wenn ein Kontakt mit einem leeren eingebetteten Feld hochgeladen wird, in dem bereits ein Wert in diesem Feld gespeichert ist, wird das Feld nicht überschrieben, und der aktuelle Wert bleibt bestehen.
8. Klicken Sie auf Datei hochladen, um die Kontakte in Ihr Verzeichnis hochzuladen.

Fehlerbehebung bei Dateiimporten

Mit Qualtrics können Sie auf einfache Weise den Status Ihrer Kontaktimporte überprüfen und eventuell aufgetretene Fehler beheben. Wir stellen eine zeilenweise Datei für jeden Kontakt und Informationen darüber bereit, ob er korrekt importiert wurde. Dies dient als Referenz, sodass Sie, wenn Ihre Kontakte nicht importiert werden können, das Problem identifizieren, die Datei beheben und es erneut versuchen können.

So erhalten Sie einen detaillierten Status Ihres Imports:

1. Nachdem Sie Ihre Datei hochgeladen haben, klicken Sie auf das Toolbox-Symbol oben rechts auf der Registerkarte Verzeichniskontakte.
   
   Tipp: Wenn Sie Kontakte in eine bestimmte Mailingliste importieren, können Sie auch in der Mailingliste auf die Toolbox klicken.
2. Klicken Sie auf Importdetails anzeigen.
3. Überprüfen Sie die Zusammenfassung des Imports. Dazu gehört, wie viele Kontakte angelegt, wie viele Kontakte aktualisiert wurden und wie viele Kontakte nicht importiert werden konnten. Darüber hinaus wird Ihrem Import eine Fortschritts-ID zugewiesen, die hilfreich ist, wenn Sie sich an den Qualtrics-Support wenden müssen.
   
4. Um Ihre Fehlerberichtsdatei herunterzuladen, klicken Sie auf Laden Sie einen Bericht herunter.
   
   Tipp: Je nach Größe Ihres Uploads kann es einige Minuten dauern, bis der Bericht generiert wird.
5. Öffnen Sie die Datei in einem Tabellenkalkulationseditor auf Ihrem Computer, und überprüfen Sie die Datei auf fehlgeschlagene Kontakte. Die Spalte, die für die Identifizierung fehlgeschlagener Kontakte am nützlichsten ist, ist die Spalte ImportStatus. Weitere Informationen zu den einzelnen Spalten finden Sie unten.

Fehlerberichtfelder

Im Folgenden finden Sie eine Beschreibung der einzelnen Felder im Fehlerbericht:

• SourceIndexId: Der Index oder die Zeilen-ID des Kontakts in der Importdatei.
• E-Mail: Die mit dem Kontakt verknüpfte E-Mail-Adresse.
• ContactId: Die ID des Kontakts in Ihrem Verzeichnis.
• ImportStatus: Der Importstatus für den Kontakt. Folgende Werte sind möglich: Hinzugefügt, Aktualisiert und Fehlgeschlagen.
• ImportStatusCode: Der Statuscode für den Import. Eine Liste der Codes und ihrer Bedeutungen finden Sie im nächsten Abschnitt.
• TransactionId: ggf. die Transaktions-ID des Kontakts, der hochgeladen oder aktualisiert wird.
  Tipp: Sie können Transaktionen einrichten, wenn Sie eine Kontaktimportautomatisierung verwenden oder Kontakte über API hinzufügen.
• TransactionStatus: Ggf. der Status des Vorgangs. Folgende Werte sind möglich: Hinzugefügt, Aktualisiert und Fehlgeschlagen.
• TransactionStatusCode: Der Statuscode für die Transaktion. Eine Liste der Codes und ihrer Bedeutungen finden Sie im nächsten Abschnitt.
• ContactListContactId: Wenn Kontakte zu einer Mailingliste hinzugefügt oder eine neue Liste angelegt wird, die ID des Kontakts in der spezifischen Mailingliste.
• ContactListContactStatus: Wenn Kontakte zu einer Mailingliste hinzugefügt oder eine neue Liste angelegt wird, der Status des Hinzufügens oder Aktualisierens. Folgende Werte sind möglich: Hinzugefügt, Aktualisiert und Fehlgeschlagen.
• ContactListContactStatusCode: Der Statuscode für den Kontakt in der Mailingliste. Eine Liste der Codes und ihrer Bedeutungen finden Sie im nächsten Abschnitt.

Statuscodes

Nachfolgend finden Sie eine Liste der möglichen Statuscodes und deren Beschreibungen.

Fehlerbehebung bei anderen Fehlern

• Ihre Datei enthält ein Feld oder mehrere Felder, die die Zeichenbeschränkung überschreiten. Überprüfen Sie die folgenden Zeichenbeschränkungen:
  • Sprache: 20
  • Vorname: 100
  • Nachname: 100
  • E-Mail-Adresse: 254
  • Telefonnummer: 20
  • Externe Referenz: 100
  • Eingebettetes Datenfeld: 200
  • Eingebetteter Datenwert: 1.024

Manuelle Eingabe

1. Klicken Sie auf Verzeichniskontakte hinzufügen.
   
2. Wählen Sie Manuelle Eingabe.
   
3. Überprüfen Sie die Kontaktimportbedingungen. Hier werden alle verzeichnisweiten Regeln zum Zusammenführen doppelter Kontakte angezeigt. Diese Regeln werden in den Verzeichniseinstellungen eingerichtet und gelten für die von Ihnen eingegebenen Kontakte.
   
4. Füllen Sie die verfügbaren Felder aus. Sie können Kontaktinformationen eingeben oder kopieren und einfügen.
5. Klicken Sie auf das Pluszeichen (+), um eine zusätzliche Spalte für eingebettete Daten hinzuzufügen. Denken Sie daran, dass Sie dabei freie Wahl haben.
6. Wählen Sie Weiter, um Ihre Kontakte hochzuladen.

Hinzufügen von Kontakten aus digitalen Intercepts

Sie können Kontakte automatisch aus allen digitalen Intercepts, die Sie angelegt haben, zu Ihrem XM Directory hinzufügen. Weitere Informationen zum Einrichten der automatischen Kontakterstellung in Website-/App-Feedback-Projekten finden Sie auf der Supportseite XM Directory-Integration mit digitalen Intercepts.

FAQs