Voraussetzungen
Worum es geht
Sie können ein GATEWatch-Formular direkt in Ihre bestehende Website einbetten. Besucher öffnen Ihre Website und bearbeiten das Formular dort. GATEWatch stellt das Formular innerhalb eines IFrames bereit – eines eingebetteten Fensters in Ihrer Seite.
Die Einbindung besteht aus zwei Teilen: einem Platzhalter an der gewünschten Stelle der Website und einem Skript, das dort das passende Formular lädt. Sie müssen den IFrame nicht selbst anlegen.
Was Sie vorab benötigen
Stimmen Sie die Einbindung mit Ihrer Event-Administration und der Person ab, die Ihre Website betreut.
| Voraussetzung | Was ist zu klären? |
|---|---|
| Zielseite auf Ihrer Website | Auf welcher vollständigen URL soll das Formular erscheinen, beispielsweise https://www.example.com/anmeldung? Teilen Sie diese Adresse Ihrer Event-Administration mit. |
| Zugriff auf den HTML-Code | Die Website muss ein HTML-Element und ein externes Skript zulassen. In einem Redaktionssystem benötigen Sie dafür meist einen HTML- oder Codeblock. Ein gewöhnliches Textfeld genügt nicht. |
| Skript-URL | Von welcher GATEWatch-Installation wird das Einbindungsskript geladen? Häufig lautet die Adresse https://gwatch.events/iframe.js. Verwenden Sie die von Ihrer Event-Administration genannte URL. |
| Event-Key | Welche Veranstaltung soll geladen werden? Übernehmen Sie den bereitgestellten Event-Key exakt. |
| Formulartyp | Welches Formular soll beim direkten Aufruf der Zielseite zunächst erscheinen? Wählen Sie einen der unten aufgeführten Werte. |
| Eingerichtetes Formular | Das gewünschte Formular muss in der betreffenden Veranstaltung eingerichtet und für den vorgesehenen Ablauf nutzbar sein. |
Skript-URL und Event-Key gehören zusammen: Das Skript lädt die Formulare von derselben GATEWatch-Adresse, von der es selbst stammt. Verwenden Sie daher die Angaben für dieselbe Installation und Veranstaltung.
Den passenden Formulartyp wählen
Der Wert wird später im Code unter data-url-partial eingetragen. Schreiben Sie ihn genau wie in der Tabelle, einschließlich der Kleinschreibung.
| Wert | Verwendung |
|---|---|
registration |
Online-Registrierung: Besucher melden sich für die Veranstaltung an. |
tbc |
Teilnahmebestätigung eingeladener Gäste: Gäste bestätigen ihre Teilnahme. Persönliche Einladungslinks können die Zugangsinformationen bereits enthalten. |
onl |
Login zum Teilnahmeformular: Gäste, die sich zuvor online registriert haben und ihre Angaben ändern möchten, melden sich hier mit den erhaltenen Zugangsdaten an. |
fbk |
Feedback: Gäste gelangen zum Login für das Feedback-Formular. |
sso |
Single Sign-on: Einstieg in den dafür eingerichteten SSO-Ablauf, beispielsweise für eine Videoübertragung. |
Der eingetragene Formulartyp ist die Vorgabe für einen direkten Seitenaufruf. Ein von GATEWatch erzeugter Link kann über seine URL-Parameter einen anderen Formularaufruf vorgeben. Lassen Sie diese Parameter beim Einbinden und Weiterleiten der Links erhalten.
Einladungslinks auf Ihre Website führen
Das Einbetten allein ändert noch nicht die Links, die GATEWatch erzeugt. Wenn auch Links aus Einladungen oder anderen Platzhaltern auf Ihre Website führen sollen, hinterlegt die Event-Administration in den allgemeinen Veranstaltungseinstellungen die Alternative URL für Formulare.
Teilen Sie Ihrer Event-Administration die vollständige Adresse der Seite mit, auf der das Formular eingebettet ist, zum Beispiel:
https://www.example.com/anmeldung
Die Event-Administration trägt diese Adresse in GATEWatch ein und übernimmt spätere Änderungen. Als verantwortliche Person für die Website müssen Sie diese Veranstaltungseinstellung nicht selbst bearbeiten. Die Adresse darf keine URL-Parameter enthalten, also keinen Zusatz wie ?formular=anmeldung. GATEWatch ergänzt die für den jeweiligen Aufruf erforderlichen Parameter selbst.
Ab diesem Zeitpunkt verwenden die entsprechend erzeugten Formularlinks diese Zieladresse. Bereits verschickte Nachrichten ändern sich dadurch nicht. Prüfen Sie vor dem Versand einen neu erzeugten Link aus dem tatsächlich vorgesehenen Ablauf.
Vor dem Einbau bereitlegen
- Die genaue Zieladresse Ihrer Website.
- Die von der Event-Administration bestätigte Skript-URL.
- Den Event-Key und den gewünschten Formulartyp.
- Eine Möglichkeit, HTML und Skripte auf der Zielseite einzufügen.
- Einen passenden Formular- beziehungsweise Einladungslink für die abschließende Funktionskontrolle.
Weiter: Das Formular einbinden und prüfen.