> For the complete documentation index, see [llms.txt](https://one-loop.gitbook.io/help/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://one-loop.gitbook.io/help/plattform/one-loop-plattform/websites-und-leadgewinnung/formulare-und-umfragen/quiz-ergebnisse-in-kontaktfelder-ubernehmen.md).

# Quiz-Ergebnisse in Kontaktfelder übernehmen

Speichere ausgewählte Quiz-Ergebnisse als Kontaktfelder, nutze sie für Listen und Automatisierungen und prüfe Aktualisierungen bei erneuter Teilnahme.

Ein Quiz kann ausgewählte Auswertungsergebnisse automatisch im Kontaktprofil speichern. So wird aus einem einmaligen Ergebnis eine Information, mit der du später gezielt arbeiten kannst: Du kannst Kontakte filtern, unterschiedliche Abläufe starten oder Nachrichten passend zum Ergebnis formulieren.

Die Funktion speichert nur die Felder, die du in der Ergebnisvorlage aktivierst. Sie arbeitet mit **Kontaktfeldern** – nicht mit Unternehmens- oder Chancenfeldern. Plane deshalb zuerst, welche Auswertung für deinen weiteren Prozess tatsächlich relevant ist.

## Was wird gespeichert?

Nach dem ersten Abschluss eines entsprechend eingerichteten Quiz legt die App die aktivierten Kontaktfelder an und schreibt die Werte in das Kontaktprofil. Je nach Quiz und aktivierter Auswahl können dazugehören:

| Ergebnisfeld                           | Inhalt                                                    | Gespeicherter Feldtyp |
| -------------------------------------- | --------------------------------------------------------- | --------------------- |
| **Gesamtpunktzahl**                    | Der Gesamtwert des Quiz.                                  | Zahl                  |
| **Gesamtergebnisstufe**                | Die Stufe, die zur Gesamtpunktzahl gehört.                | Text                  |
| **Kategoriepunktzahl**                 | Der Wert einer einzelnen Kategorie.                       | Zahl                  |
| **Kategorienergebnisstufe**            | Die Stufe einer einzelnen Kategorie.                      | Text                  |
| **Stärkste oder schwächste Kategorie** | Die Kategorie mit dem höchsten oder niedrigsten Ergebnis. | Text                  |

Für jedes aktivierte Feld erstellt die App einen **Feldnamen** und einen **eindeutigen Schlüssel**. Die Namen folgen einer erkennbaren Struktur aus Quizname, Kategorie und Ergebnisart. Du kannst die Felder später umbenennen oder in Gruppen verschieben. Prüfe danach jedoch alle Listen, Bedingungen und Nachrichten, die darauf zugreifen.

## Voraussetzungen und Planung

Bevor du die Übernahme aktivierst, solltest du Folgendes vorbereitet haben:

* Ein vorhandenes oder neues Quiz mit einer eingerichteten **Ergebnisvorlage**.
* Klar definierte Punkte, Stufen oder Kategorien, deren Bedeutung im Alltag verständlich ist.
* Einen Testkontakt, dessen Profil du nach der Teilnahme kontrollieren kannst.
* Einen klaren Verwendungszweck, zum Beispiel eine Kontaktliste oder einen automatischen Folgeablauf.

> **Wichtig:** Die Primärdokumentation beschreibt die Speicherung in Kontaktfeldern. Sie beschreibt keine Zuordnung zu anderen Objekten. Verwende die Werte daher nur dort, wo Kontaktfelder unterstützt werden.

## Kontaktfelder in der Ergebnisvorlage aktivieren

1. Öffne **Websites** und wähle **Quizze**.
2. Öffne ein vorhandenes Quiz oder wähle **Quiz hinzufügen**, um ein neues Quiz anzulegen.
3. Scrolle im Quiz bis zum Ende zur **Ergebnisvorlage**.
4. Wähle **Vorlage bearbeiten**.
5. Öffne oben rechts die **Einstellungen**.
6. Klappe den Bereich **Kontaktfelder** auf.
7. Aktiviere per Schalter nur die Werte, die du synchronisieren möchtest, zum Beispiel Gesamtpunktzahl, Gesamtstufe, Kategoriepunktzahl, Kategorienergebnisstufe sowie stärkste oder schwächste Kategorie.
8. Kontrolliere bei jedem aktivierten Wert den vorgeschlagenen **Feldnamen** und den **eindeutigen Schlüssel**.
9. Speichere die Ergebnisvorlage.

Die Schalter legen nicht sofort für alle bestehenden Kontakte Werte an. Die Felder werden angelegt und befüllt, sobald ein Kontakt das eingerichtete Quiz abschließt.

## Sichtbare Einstellungen und ihre Wirkung

| Einstellung                  | Bedeutung                                                                     | Praktische Auswirkung                                                         |
| ---------------------------- | ----------------------------------------------------------------------------- | ----------------------------------------------------------------------------- |
| **Ergebnisvorlage**          | Der Bereich am Ende des Quiz, in dem die Ergebnisdarstellung bearbeitet wird. | Hier findest du die Einstellungen für die Übernahme.                          |
| **Einstellungen**            | Öffnet die Konfiguration der Ergebnisvorlage.                                 | Von hier aus erreichst du die Kontaktfelder.                                  |
| **Kontaktfelder**            | Listet automatisch vorbereitete Ergebnisfelder auf.                           | Nur eingeschaltete Felder werden nach einer Teilnahme geschrieben.            |
| **Schalter je Ergebnisfeld** | Aktiviert oder deaktiviert eine einzelne Übernahme.                           | Wähle gezielt, damit Kontaktprofile übersichtlich bleiben.                    |
| **Feldname**                 | Die sichtbare Bezeichnung des Kontaktfelds.                                   | Erleichtert das Finden in Listen, Filtern und Nachrichten.                    |
| **Eindeutiger Schlüssel**    | Die technische, eindeutige Kennung des Felds.                                 | Prüfe ihn vor dem Speichern; er wird für die verlässliche Zuordnung angelegt. |
| **Speichern**                | Übernimmt deine Auswahl in die Ergebnisvorlage.                               | Erst danach greifen die Einstellungen bei neuen Abschlüssen.                  |

## Was nach einer Teilnahme passiert

Wenn ein Kontakt das Quiz abschließt, schreibt die App die aktivierten Ergebniswerte in das Kontaktprofil. Die erste passende Teilnahme legt die gewählten Felder an. Danach kannst du das Profil öffnen und die Werte prüfen.

Nimmt derselbe Kontakt dasselbe Quiz später erneut wahr, werden die vorhandenen Werte mit dem neuesten Ergebnis überschrieben. Es entstehen dadurch keine zusätzlichen, gleichartigen Ergebnisfelder. Plane Folgeabläufe deshalb so, dass sie immer mit dem aktuellen Stand arbeiten.

Bei einem bereits bestehenden Quiz funktioniert die Übernahme ebenfalls. Aktiviere dazu die gewünschten Kontaktfelder in der Ergebnisvorlage und führe anschließend eine neue Testteilnahme durch. Erst ein späterer Abschluss erstellt beziehungsweise aktualisiert die Werte.

## Ergebnisse sicher weiterverwenden

### Kontakte filtern und Listen erstellen

Du kannst Kontaktlisten anhand von Punktzahl, Stufe oder Kategorie zusammenstellen. Lege eine Bedingung nur mit einem Feld an, dessen Bedeutung im Quiz klar festgelegt ist. Beispiel: Eine Liste enthält Kontakte mit einer bestimmten Ergebnisstufe.

### Abläufe passend verzweigen

In einem Workflow kann eine Bedingung den gespeicherten Wert prüfen. So kann ein anderer Folgeweg beginnen, wenn eine Stufe oder ein Kategorienwert eine festgelegte Grenze erreicht. Teste jede Bedingung zunächst mit einem Testkontakt.

### Persönliche Inhalte einsetzen

Verwende Ergebnisfelder in einer Nachricht oder auf einer Seite, wenn der gespeicherte Wert für die Person verständlich und passend ist. Prüfe vor der Aktivierung, wie der Platzhalter mit einem echten Testwert angezeigt wird.

### Werte exportieren

Beim Export von Kontakten werden auch Kontaktfelder ausgegeben. Dadurch können die aktivierten Ergebniswerte zusammen mit den übrigen Kontaktinformationen in einer CSV-Datei erscheinen.

## So prüfst du die Einrichtung

Führe immer einen vollständigen Test durch, bevor du Listen oder Abläufe für viele Kontakte aktivierst.

1. Aktiviere zunächst nur ein bis zwei Ergebnisfelder und speichere die Ergebnisvorlage.
2. Nimm mit einem Testkontakt am Quiz teil.
3. Öffne danach die Quiz-Einsendungen und prüfe, ob die Teilnahme erfasst wurde.
4. Öffne das zugehörige Kontaktprofil.
5. Kontrolliere Feldname, Wert und Feldtyp: Punktzahlen müssen als Zahl, Stufen und Kategorien als Text erscheinen.
6. Öffne eine gespeicherte Liste oder einen Test-Workflow und prüfe, ob das Feld dort auswählbar ist.
7. Nimm mit demselben Testkontakt erneut teil, diesmal mit einem anderen Ergebnis.
8. Prüfe, ob der vorhandene Wert aktualisiert wurde und kein zusätzliches gleichartiges Feld entstanden ist.

## Grenzen und typische Fehler

### Das Ergebnisfeld erscheint nicht im Kontaktprofil

Prüfe, ob du die richtige Ergebnisvorlage bearbeitet, das Feld eingeschaltet und anschließend gespeichert hast. Schließe danach das Quiz erneut mit einem Testkontakt ab. Die Felder werden erst bei einer neuen Teilnahme angelegt oder aktualisiert.

### Eine Liste oder Bedingung findet den Wert nicht

Kontrolliere, ob du ein **Kontaktfeld** auswählst und nicht nach einem ähnlich benannten Feld in einem anderen Bereich suchst. Prüfe außerdem Feldname und eindeutigen Schlüssel in der Ergebnisvorlage.

### Nach einer erneuten Teilnahme fehlt ein früherer Wert

Für dasselbe Quiz aktualisiert eine neue Teilnahme die vorhandenen Werte. Das ist beabsichtigt: Die Felder bilden den aktuellen Stand ab. Wenn du Ergebnisse über längere Zeit vergleichen musst, plane dafür einen getrennten, belegbaren Prozess; diese Einstellung erstellt keine Historie mehrerer Ergebnisstände.

### Ein automatisch erstelltes Feld wurde gelöscht

Das Löschen eines Felds entfernt auch die darin gespeicherten Quizwerte aus allen Kontaktprofilen. Benenne Felder oder Gruppen daher lieber erst testweise um. Lösche sie nur, wenn die Daten wirklich nicht mehr benötigt werden.

## Praxisbeispiel: passender Erstkontakt nach einem Selbstcheck

Ein Beratungsunternehmen erstellt einen kurzen Selbstcheck mit mehreren Kategorien. Es aktiviert die Gesamtergebnisstufe, die Kategoriepunktzahl und die stärkste Kategorie als Kontaktfelder.

Nach einer Testteilnahme kontrolliert das Team die neuen Werte im Kontaktprofil. Anschließend richtet es eine Kontaktliste für eine bestimmte Ergebnisstufe ein und testet einen Workflow: Kontakte mit dieser Stufe erhalten eine passende Einführung, andere Kontakte erhalten einen anderen Einstieg.

Eine Person nimmt den Selbstcheck später erneut wahr und erzielt ein anderes Ergebnis. Das Team prüft ihr Kontaktprofil und sieht den aktualisierten Wert. Weil der Workflow das Kontaktfeld verwendet, arbeitet der nächste Ablauf mit dem aktuellen Ergebnis.

## Kurz-Check vor der Aktivierung

* Sind Punkte, Stufen und Kategorien im Quiz fachlich eindeutig?
* Habe ich nur die Ergebnisfelder aktiviert, die ich wirklich weiterverwende?
* Stimmen Feldname und eindeutiger Schlüssel?
* Wurde eine Testteilnahme bis zum Kontaktprofil geprüft?
* Ist klar, dass eine erneute Teilnahme den bisherigen Wert ersetzt?
* Wurden Listen und Workflows mit einem Testkontakt geprüft?
