Umfragen
Adverfly-Umfragen auf deiner Website einbetten
Bette Adverfly-Umfragen direkt auf deiner Website ein — für Kundenfeedback, Post-Purchase-Reviews oder NPS-Scores.
Schnellstart
Wenn der Adverfly-Pixel bereits installiert ist, füge an der gewünschten Stelle einfach folgendes Div ein:
<div data-adv-survey-id="SURVEY_ID" data-adv-workspace-id="WORKSPACE_ID"></div>
Ersetze SURVEY_ID mit deiner Survey-ID und WORKSPACE_ID mit deiner Workspace-ID (beides in den Survey-Einstellungen).
Der Pixel erkennt Survey-Embeds automatisch und rendert sie.
Parameter
| Parameter | Type | Required | Description |
|---|---|---|---|
data-adv-survey-id | string | Required | Deine Survey-ID |
data-adv-workspace-id | string | Required | Deine Workspace-ID |
data-adv-survey-version | string | Optional | Spezifische Version (Standard: aktuellste) |
data-adv-order-id | string | Optional | Bestell-/Transaktions-ID, um Antworten an einen Kauf zu binden |
data-adv-lang | string | Optional | Sprachcode wie de, fr, en oder default. Ohne Angabe greift der Legacy-Englisch-Fallback der UI. |
Customer- & Transaction-Tracking
Survey-Events enthalten automatisch customer_id und transaction_id, wenn sie über den Adverfly-Layer gesetzt werden. Damit lassen sich Antworten konkreten Kunden und Bestellungen zuordnen.
<script>
window.adverfly = window.adverfly || [];
function advPxl() { adverfly.push([!1, ...arguments]); }
advPxl("init", WORKSPACE_ID);
window.adverfly.store_currency = "EUR";
window.adverfly.store_timezone = "Europe/Berlin";
/* Customer- und Transaction-IDs setzen */
window.adverfly.customer_id = "customer_123";
window.adverfly.transaction_id = "order_456";
</script>
Adverfly-Layer-Properties
| Parameter | Type | Required | Description |
|---|---|---|---|
window.adverfly.customer_id | string | Optional | Customer-ID, die mit Survey-Antworten verknüpft wird |
window.adverfly.transaction_id | string | Optional | Transaktions-/Bestell-ID, um Antworten an einen Kauf zu binden |
window.adverfly.store_currency | string | Optional | Shop-Währung (z. B. EUR, USD) |
window.adverfly.store_timezone | string | Optional | Shop-Zeitzone (z. B. Europe/Berlin) |
Diese Properties werden automatisch in alle Survey-Events (survey_opened, survey_answer, survey_completed) übernommen.
Mehrsprachen-Support
Umfragen unterstützen mehrere Sprachen. Setze data-adv-lang, um übersetzten Inhalt anzuzeigen. Mit default erzwingst du den Survey-Basis-Inhalt mit englischer UI als Fallback:
<div
data-adv-survey-id="SURVEY_ID"
data-adv-workspace-id="WORKSPACE_ID"
data-adv-lang="de"
></div>
| Code | Description |
|---|---|
default | Survey-Basis-Inhalt mit englischer UI als Fallback |
en | Englische UI und translations.en (falls konfiguriert) |
de | Deutsch |
fr | Französisch (falls konfiguriert) |
Wird data-adv-lang weggelassen, behält der Public-Embed das Legacy-Verhalten: englische UI mit Survey-Basis-Inhalt. Übersetzungen müssen in den Survey-Einstellungen in Adverfly konfiguriert sein.
Survey-Funktionen
- Pflichtfragen: Mit rotem Sternchen (*) markiert; werden vor dem Weiterklicken validiert
- Mehrstufige Navigation: Eine Frage pro Schritt mit Zurück-/Weiter-Buttons
- Fortschritts-Anzeige: Aktueller Schritt und Progress-Bar
- Danke-Screen: Anpassbare Nachricht nach dem Absenden
Voraussetzungen
Für das Embed gilt:
- Survey muss auf live stehen
- Adverfly-v2-Pixel muss auf der Seite installiert sein (v1-Pixel unterstützt keine Surveys)
Survey-Events
Der Pixel trackt diese Events automatisch:
| Code | Description |
|---|---|
survey_opened | Wird ausgelöst, wenn die Umfrage angezeigt wird |
survey_answer | Wird für jede beantwortete Frage ausgelöst |
survey_completed | Wird beim Absenden der Umfrage ausgelöst |
Alle Events enthalten form_id, submission_id und (falls gesetzt) customer_id sowie transaction_id.