Artikelvorlage
Informationen zum Hinzufügen von Verzeichnis
Die Verzeichnis enthält alle Kontakte, die dem Verzeichnis Ihrer Organisation hinzugefügt wurden. Alle Kontakte, die einem hinzugefügt wurden Mailingliste werden automatisch zu diesem Verzeichnis hinzugefügt, aber Sie können Personen auch direkt zum Verzeichnis hinzufügen, indem Sie das Verzeichnis hinzufügen Drucktaste.
Projekte, die XM Directory verwenden können
Allerdings ist nicht jeder Qualtrics mit XM Directory kompatibel.
XM Directory kann verwendet werden, um Folgendes zu senden:
- Umfrageprojekte
- Conjoin / MaxDiff
- Bestimmte Nicht-EX XM
Das bedeutet, dass Daten, die in einem Verzeichnis bearbeitet werden, sich nie auf das andere Verzeichnis auswirken. XM Directory
Verfügbare Kontaktfelder
Unabhängig davon, ob Sie eine CSV von Kontakten hochladen oder sie manuell eingeben, müssen Sie bestimmte Informationen für Ihre Kontakte angeben.
- FirstName: Der Vorname des Kontakt.
- LastName: Der Nachname des Kontakt.
- E-Mail: Die E-Mail-Adresse des Kontakt. Es wird empfohlen, dass Sie Duplikate zusammenführen aus diesem Feld.
- ExternalDataReference: Zusätzliche Informationen zum Kontakt. Dieses Feld wird meist verwendet, um Daten wie eine Mitarbeiter- oder Studenten-ID zu hinterlegen. Es kann verwendet werden, um sich bei anzumelden. Authentifizierer und konfigurieren Sie, wie das Verzeichnis führt Duplikate zusammen.
- Eingebettete daten: Eingebettete daten sind zusätzliche Felder, die ein beliebiges Feld enthalten. Sie müssen keine bestimmte Namenskonvention befolgen. Im obigen Screenshot sind Abteilung, Stadt und Land eingebettete Daten.
Tipp: Namen Eingebettete daten haben maximal 200 Zeichen. Werte sollten jeweils maximal 1024 Zeichen lang sein.Warnung: Bei allen eingebettete Daten wurde bisher zwischen Groß- und Kleinschreibung unterschieden. Für die überwiegende Mehrheit der Benutzer sind eingebettete Daten nicht mehr Die Groß-/Kleinschreibung, d.h. “test” und “Test”, werden als 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 eingebettete Daten, da es sich um ein reserviertes Feld im XM Directory handelt. Verwenden Sie außerdem keines der anderen Qualtrics.
- Sprache: Eine optionale Spalte, die die Sprache des Kontakt mithilfe von identifiziert Sprachcodes.
- Telefon: Eine optionale Spalte, die die Telefonnummer des Kontakt identifiziert. Siehe SMS-Verteilungen Supportseite für akzeptierte Telefonnummernformate.
Datums- und Zeitdaten
Wenn Sie eingebettete Daten haben, können Sie einen Filter verwenden, um nach Datumsangaben in der Zukunft zu suchen, die vor Kurzem stattgefunden haben. Um nach Datum zu suchen, muss das Datumsfeld im Format ISO-8601 mit Uhrzeiten in UTC vorliegen. (d.h. YYYY-MM-DDT-HH:mm:ss+ZZZZ .) Weitere Informationen zu diesen Symbolen finden Sie auf der Syntax des Datumsformats Support-Seite).
Datei hochladen
- Klicken Sie auf Verzeichnis hinzufügen.
- Klicken Sie auf Datei hochladen.
- Erstellen Sie in Excel ein Dokument mit den erforderlichen Feldern, und speichern Sie es als CSV. Oder klicken Sie auf Stichprobe herunterladenfüllen Sie die entsprechenden Spalten aus, fügen Sie die gewünschten eingebettete Daten hinzu, und sichern Sie die Datei.
- Wenn die Datei fertig ist, ziehen Sie die Datei 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.
- Klicken Sie auf Weiter.
- Überprüfen Sie die Kontakt. Hier werden alle direktionsweiten Regeln für das Zusammenführen duplizieren Kontakte angezeigt. Diese Regeln werden in Verzeichnis, und übernehmen die Kontakte in Ihrer Datei.
Tipp: Für den Zugriff auf den Tab Verzeichnis” ist die Option “Verzeichnis Berechtigung. Sprechen Sie mit Ihrem Instanz wenn Sie Zugriff auf diese Einstellung haben möchten. - Ü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 “getrennt”). Um dies zu beheben, wählen Sie die blaue Optionen anzeigen und wählen Sie eine andere Trennzeichen und/oder Umschließung.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.
- Klicken Sie auf Datei hochladen , um die Kontakte in Ihr Verzeichnis hochzuladen.
Fehlerbehebung bei Dateiimporten
Qualtrics erleichtert es Ihnen, den Status Ihrer Kontakt zu überprüfen und eventuell aufgetretene Fehler zu beheben. Wir stellen eine zeilenweise Datei für jeden Kontakt und Informationen darüber bereit, ob er korrekt importiert wurde. Dies dient als Referenz, damit Sie, wenn der Import Ihrer Kontakte fehlschlägt, das Problem identifizieren, die Datei korrigieren und es erneut versuchen können.
So erhalten Sie einen detaillierten Status Ihres Imports:
- Nachdem Sie Ihre Datei hochgeladen haben, klicken Sie oben rechts auf der Registerkarte Verzeichnis auf das Toolbox-Symbol.
Tipp: Wenn Importieren von Kontakten in eine bestimmte Mailinglistekönnen Sie auch in der Mailingliste auf die Toolbox klicken. - Klicken Sie auf Importdetails anzeigen.
- Überprüfen Sie die Zusammenfassung des Imports. Dazu gehören die Anzahl der angelegten Kontakte, die Anzahl der aktualisierten Kontakte und die Anzahl der Kontakte, die nicht importiert werden konnten. Darüber hinaus wird Ihrem Import eine
Fortschritts-ID . Dies ist hilfreich, wenn Sie Kontakt wenden müssen.
- Um Ihre Fehlerberichtsdatei herunterzuladen, wählen Sie Laden Sie einen Bericht herunter.
Tipp: Abhängig von der Größe Ihres Uploads kann es einige Minuten dauern, bis der Bericht generiert wird. - Öffnen Sie die Datei in einem Tabellenkalkulationseditor auf Ihrem Computer, und überprüfen Sie die Datei auf alle fehlgeschlagenen Kontakte. Die Spalte, die für die Identifizierung fehlgeschlagener Kontakte am nützlichsten ist, ist die ImportStatus Spalte. Weitere Informationen zu den einzelnen Spalten finden Sie unten.
Fehlerberichtsfelder
Nachfolgend finden Sie eine Beschreibung der einzelnen Felder im Fehlerbericht:
- SourceIndexId: Der Index oder die Zeilen-ID des Kontakt in der Importdatei.
- E-Mail: Die mit dem Kontakt verknüpfte E-Mail-Adresse.
- ContactId: Die ID des Kontakt in Ihrem Verzeichnis.
- ImportStatus: Der Importstatus für den Kontakt. Zu den Werten gehören: Hinzugefügt, Aktualisiert und Fehlgeschlagen.
- ImportStatusCode: Der Statuscode für den Import. Eine Liste der Codes und ihrer Bedeutung finden Sie im weiter Abschnitt.
- TransactionId: Sofern zutreffend, die Transaktion des Kontakt oder -Updates.
Tipp: Sie können Folgendes einrichten: Transaktionen bei Verwendung eines Kontaktoder beim Hinzufügen von Kontakten über API.
- TransactionStatus: Sofern zutreffend, der Status für den Transaktion. Zu den Werten gehören: Hinzugefügt, Aktualisiert und Fehlgeschlagen.
- TransactionStatusCode: Der Statuscode für den Transaktion. Eine Liste der Codes und ihrer Bedeutung finden Sie im weiter Abschnitt.
- ContactListContactId: Wenn Sie Kontakte zu einer Mailingliste hinzufügen oder eine neue Liste anlegen, wird die ID des Kontakt in der spezifischen Mailingliste angezeigt.
- ContactListContactStatus: Wenn Sie Kontakte zu einer Mailingliste hinzufügen oder eine neue Liste anlegen, wird der Status des Hinzufügens oder Aktualisierens angezeigt. Zu den Werten gehören: Hinzugefügt, Aktualisiert und Fehlgeschlagen.
- ContactListContactStatusCode: Der Statuscode für den Kontakt in der Mailingliste. Eine Liste der Codes und ihrer Bedeutung finden Sie im weiter Abschnitt.
Statuscodes
Nachfolgend finden Sie eine Liste der möglichen Statuscodes und deren Beschreibungen.
Tipp: Wenn Sie sich an den Support wenden, bitten Sie Ihre Fehlerbehebungsdatei um Hilfe.
Statuscode | Beschreibung |
0 | Es ist ein unbekannter Fehler aufgetreten; versuchen Sie den Import erneut. |
1 | Es ist ein unbekannter Fehler aufgetreten; versuchen Sie den Import erneut. |
10 | Der Kontakt FirstNName ist leer oder ungültig; geben Sie einen gültigen Vornamen ein. |
11 | Der Kontakt LastName ist leer oder ungültig; geben Sie einen gültigen Nachnamen ein. |
12 | Der Kontakt für ExternalDataReference ist leer oder ungültig; geben Sie einen gültigen ExternalDataReference-Wert ein. |
13 | Der Kontakt Telefon ist leer oder ungültig; geben Sie eine gültige Telefonnummer ein. |
14 | Der Kontakt EE-Mail ist ungültig; geben Sie eine gültige E-Mail-Adresse ein. |
15 | Kontakt ist ungültig, da der eingebettete Daten mehr als 200 Zeichen enthält. |
16 | Kontakt ist ungültig, da der Wert des eingebettete Daten länger als 1024 Zeichen ist. |
18 | Der Kontakt hat eine ContactID die in einem anderen Verzeichnis als dem, in das importiert wird, vorhanden ist; löschen Sie den Wert. |
19 | Der Kontakt Sprache ist ungültig; geben Sie ein Sprachcode die weniger als 20 Zeichen umfasst. |
40 | Der Kontakt wurde erfolgreich angelegt. |
41 | Der Kontakt wurde erfolgreich aktualisiert. |
42 | Der Kontakt wurde nicht angelegt. Versuchen Sie den Import erneut. |
43 | Der Kontakt wurde nicht angelegt. Versuchen Sie den Import erneut. |
44 | Der Kontakt wurde nicht angelegt. Versuchen Sie den Import erneut. |
45 | Der Kontakt wurde nicht angelegt. Versuchen Sie den Import erneut. |
46 | Der Kontakt wurde nicht angelegt. Versuchen Sie den Import erneut. |
47 | Der Kontakt wurde nicht angelegt. Versuchen Sie den Import erneut. |
49 | Es ist ein interner Fehler aufgetreten; versuchen Sie es mit der fehlgeschlagenen Zeile erneut. Wenn der Fehler weiterhin auftritt, Kontakt Qualtrics, um Support zu erhalten.. |
60 | Der Kontakt wurde erfolgreich zur Mailingliste hinzugefügt. |
61 | Der Kontakt wurde erfolgreich in der Mailingliste aktualisiert. |
62 | Der Kontakt wurde nicht zur Mailingliste hinzugefügt. Versuchen Sie den Import erneut. |
63 | Kontakt wurde der Liste nicht hinzugefügt, da die Kontakt fehlgeschlagen ist |
70 | Die Transaktion wurde erfolgreich angelegt. |
71 | Der Transaktion ist fehlgeschlagen. Es war kein gültiger Kontakt mit der Transaktion verknüpft; geben Sie gültige Kontakt. |
72 | Die Transaktion wurde nicht angelegt; versuchen Sie den Import erneut. |
73 | Das Anlegen der Transaktion ist fehlgeschlagen. Grund: ContactId oder ContactListContactId wurde nicht im Verzeichnis gefunden; geben Sie eine gültige ContactId und ContactListContactId ein. |
74 | Das Anlegen des Transaktion ist aufgrund von fehlendem fehlgeschlagen. TransactionDate; Geben Sie ein gültiges Transaktion ein. |
75 | Es ist ein unbekannter Fehler aufgetreten; versuchen Sie den Import erneut. |
76 | Transaktion ist ungültig, da der Transaktion mehr als 200 Zeichen hat. |
77 | Transaktion ist ungültig, da der Wert Datenfeld länger als 1024 Zeichen ist. |
78 | Der Transaktion wurde nicht angelegt, da die zugehörige Kontakt fehlgeschlagen ist. |
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
- Eingebettete daten: 200
- Eingebettete daten: 1.024
Manuelle Eingabe
- Klicken Sie auf Verzeichnis hinzufügen.
- Auswählen Manuelle Eingabe.
- Überprüfen Sie die Kontakt. Hier werden alle direktionsweiten Regeln für das Zusammenführen duplizieren Kontakte angezeigt. Diese Regeln werden in Verzeichnis, und übernehmen die Kontakte, die Sie eingeben.
- Füllen Sie die verfügbaren Felder aus. Sie können Kontakt eingeben oder kopieren und einfügen.
- 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.
- Klicken Sie auf Weiter um Ihre Kontakte hochzuladen.
Hinzufügen von Kontakten aus digitalen Intercepts
Sie können Kontakte automatisch aus allen digitalen Intercepts, die Sie möglicherweise erstellt haben, zu Ihrem XM Directory hinzufügen. Weitere Informationen zum Einrichten der automatischen Kontakt finden Sie unter.