Datenexport nach Google Sheets
Wir zeigen Ihnen, wie Sie den automatischen Datenexport von Kwiga nach Google Sheets einrichten.
Sie können den Datenexport für verschiedene Ereignisse mithilfe von Automatisierungen einrichten (als Ereignis können Sie z. B. „Kontakt hinzugefügt“, „Tag hinzugefügt“, „erfolgreicher oder fehlgeschlagener Kauf“ usw. angeben; die vollständige Liste der Ereignisse finden Sie im Artikel).
Zusätzlich können Sie bei der Verwendung von Widgets die Option zum Senden eines Webhooks nutzen; der Ablauf bleibt derselbe.
Wichtigste Schritte:
-
Erstellen Sie eine Datei und fügen Sie das Skript hinzu
-
Erstellen Sie eine Web-App und erhalten Sie den Link zum Senden des Webhooks
-
Richten Sie das Senden des Webhooks über eine Automatisierung in Kwiga oder über das Absenden eines Formulars im Widget ein.
Der gesamte Vorgang wird im Video gezeigt und erfordert keine Programmierkenntnisse. Folgen Sie einfach den angegebenen Schritten, und falls etwas nicht funktioniert, wenden Sie sich an den Support.
Schritt 1: Erstellen Sie eine Datei, an die die Daten aus Kwiga gesendet werden
Öffnen Sie Google Sheets und erstellen Sie eine neue Datei, öffnen Sie dann den Skripteditor.

Es öffnet sich ein neues Fenster, in dessen Editor Sie das Skript einfügen müssen. Sie können das Skript über den Link herunterladen (oder den Text am Ende des Artikels kopieren). Löschen Sie den gesamten Text, der sich bereits im Editor befindet.

Endergebnis:

Schritt 2: Erstellen Sie eine Web-App und erhalten Sie den Link zum Senden des Webhooks
Suchen Sie im selben Skripteditor die Schaltfläche „Bereitstellen“ und wählen Sie „Neue Bereitstellung“

Wählen Sie als Typ „Web-App“, stellen Sie im Dropdown „Wer hat Zugriff“ die Option „Jeder“ ein und klicken Sie dann auf „Bereitstellen“.
Als Ergebnis erhalten Sie die Web-App-URL, die Sie anschließend in Kwiga hinzufügen müssen.

Schritt 3: Datenversand in Kwiga einrichten
Klicken Sie im oberen Menü auf „Marketing“ und wählen Sie „Automatisierungen“. Klicken Sie auf „Automatisierung erstellen“ und wählen Sie im Block „Start“ das Ereignis, das die Automatisierung auslöst. Das kann „Kontakt hinzugefügt“, „Tag hinzugefügt“, eine Zahlung oder ein anderes Ereignis sein.
Scrollen Sie anschließend nach unten und fügen Sie die Aktion „Webhook senden“ aus der Gruppe „System“ → „Allgemein“ hinzu. Geben Sie im Linkfeld die Web-App-URL an, wählen Sie den Anfragetyp POST und die Felder, die in die Tabelle exportiert werden sollen.

Speichern Sie – damit sind alle Schritte abgeschlossen.
Alternativ können Sie das Senden eines Webhooks über das Widget einrichten; dies ist bei Verwendung des Elements „Formular“ verfügbar. Aktivieren Sie den Schalter „Zusätzlich an einen Drittanbieterdienst senden“, klicken Sie auf die darunter erscheinende Schaltfläche „Webhook-Parameter konfigurieren →“ und fügen Sie im Fenster „Webhook“ den Link hinzu, wählen Sie den Anfragetyp POST und die zu sendenden Parameter. In dieser Liste stehen nur die Parameter zur Verfügung, die im Formular (in diesem Widget) vorhanden sind.


Wie funktioniert das Google Sheets-Skript für Webhooks
- Beim ersten Aufruf des Webhooks werden die Tabellenüberschriften automatisch basierend auf den Schlüsseln der eingehenden Daten erstellt
- Wenn die Tabelle bereits Überschriften hat und neue Datenfelder empfangen werden sollen, fügen Sie diese Überschriften manuell zur Tabelle hinzu
- Die Überschriften können in der Tabelle verschoben werden - das Skript erkennt ihre Positionen automatisch
- Standardmäßig fügt das Skript bei jedem Empfang eines Webhooks neue Einträge hinzu
- Wenn Sie Felder in keyColumns angeben, aktualisiert das Skript bestehende Datensätze oder fügt neue hinzu, wenn keine Übereinstimmung gefunden wird
- ⚠️ Wichtig: Nach einer Änderung des Skripts muss eine neue Bereitstellung in Google Apps Script erfolgen und der Webhook-Link aktualisiert werden
Auswahl des Tabellenblatts:
- Standardmäßig wird das aktive Blatt verwendet
- Kann über Webhook-Parameter überschrieben werden:
- "sheet_name": "Name des Blattes" - zur Auswahl des Blattes nach Name
- "sheet_index": 2 - zur Auswahl des Blattes nach Nummer (beginnend mit 1)
// ============================================================
// SKRIPT-EINSTELLUNGEN
// ============================================================
// Duplikatprüfung - geben Sie die Felder zur Suche nach vorhandenen Einträgen an
// Beispiele für die Verwendung:
// var keyColumns = ["email"]; - Prüfung nach E-Mail
// var keyColumns = ["order_id"]; - Prüfung nach Bestell-ID
// var keyColumns = ["email", "order_id"]; - Prüfung nach mehreren Feldern
var keyColumns = []; // Duplikatprüfung deaktiviert
// ============================================================
// Funktion zum Senden der Antwort
function sendResponse(success, message) {
var response = {
"status": success ? "success" : "error",
"message": message
};
return ContentService.createTextOutput(JSON.stringify(response))
.setMimeType(ContentService.MimeType.JSON);
}
// Abrufen des Zielblatts zum Schreiben von Daten
function getTargetSheet(hook_data) {
var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
// Überprüfen, ob der Seitenname angegeben ist
if (hook_data && hook_data.sheet_name) {
try {
var sheet = spreadsheet.getSheetByName(hook_data.sheet_name);
if (sheet) {
return sheet;
}
} catch (error) {
// Seite nicht gefunden
}
}
// Überprüfen, ob die Seitennummer angegeben ist
if (hook_data && hook_data.sheet_index && !isNaN(hook_data.sheet_index)) {
try {
var sheets = spreadsheet.getSheets();
var index = parseInt(hook_data.sheet_index) - 1; // In Index ab 0 konvertieren
if (index >= 0 && index < sheets.length) {
return sheets[index];
}
} catch (error) {
// Ungültiger Seitenindex
}
}
// Standardmäßig aktive Seite verwenden
return SpreadsheetApp.getActiveSheet();
}
// Erstellt Tabellenüberschriften basierend auf den übergebenen Daten
function populateHeaders(hook_data, sheet) {
if (!hook_data || typeof hook_data !== 'object') {
return false;
}
if (!sheet) {
sheet = getTargetSheet(hook_data);
}
var last_row = Math.max(sheet.getLastRow(), 1);
sheet.insertRowAfter(last_row);
var headers_row = ['timestamp'];
var hook_data_keys = Object.keys(hook_data);
for (var i = 0; i < hook_data_keys.length; i++) {
headers_row.push(hook_data_keys[i]);
}
sheet.appendRow(headers_row);
SpreadsheetApp.flush();
return true;
}
// Verarbeitung des eingehenden Webhooks
function doPost(e) {
var hook_load = null;
// Überprüfen auf Vorhandensein von POST-Daten
if (!e || !e.postData || !e.postData.contents) {
return sendResponse(false, "Keine Daten zur Verarbeitung");
}
// JSON-Daten parsen
try {
hook_load = JSON.parse(e.postData.contents);
} catch (error) {
return sendResponse(false, "Fehler beim Parsen der JSON-Daten");
}
// Validierung der empfangenen Daten
if (!hook_load || typeof hook_load !== 'object' || Object.keys(hook_load).length === 0) {
return sendResponse(false, "Ungültige oder leere Daten empfangen");
}
try {
// Zielseite abrufen
var sheet = getTargetSheet(hook_load);
if (!sheet) {
return sendResponse(false, "Angegebene Seite konnte nicht gefunden werden");
}
// Erstellung von Überschriften, wenn die Tabelle leer ist
if (sheet.getLastColumn() === 0) {
populateHeaders(hook_load, sheet);
}
var headers = sheet.getRange(1, 1, 1, sheet.getLastColumn()).getValues()[0];
if (headers.length === 0 || headers[0] === "") {
populateHeaders(hook_load, sheet);
headers = sheet.getRange(1, 1, 1, sheet.getLastColumn()).getValues()[0];
}
// Duplikatprüfung
var data = [];
var targetRow = -1;
var numRows = sheet.getLastRow() - 1;
if (keyColumns.length > 0 && numRows > 0) {
data = sheet.getRange(2, 1, numRows, sheet.getLastColumn()).getValues();
for (var r = 0; r < data.length; r++) {
var row = data[r];
var match = true;
for (var k = 0; k < keyColumns.length; k++) {
var key = keyColumns[k];
var idx = headers.indexOf(key);
if (idx === -1 || row[idx] != hook_load[key]) {
match = false;
break;
}
}
if (match) {
targetRow = r + 2; // Berücksichtigung der Überschriften
break;
}
}
}
// Datenvorbereitung zum Speichern
var new_sheet_row = new Array(headers.length).fill('');
for (var h = 0; h < headers.length; h++) {
var key = headers[h];
if (key === 'timestamp') {
new_sheet_row[h] = new Date();
} else if (hook_load.hasOwnProperty(key)) {
new_sheet_row[h] = hook_load[key];
}
}
// Daten in Tabelle speichern
if (targetRow > -1) {
sheet.getRange(targetRow, 1, 1, new_sheet_row.length).setValues([new_sheet_row]);
} else {
sheet.appendRow(new_sheet_row);
}
SpreadsheetApp.flush();
return sendResponse(true, "Daten erfolgreich gespeichert");
} catch (error) {
return sendResponse(false, "Fehler beim Speichern der Daten: " + error.message);
}
}
Häufige Fragen
Muss ich programmieren können, um Daten in Google Sheets zu exportieren?
Nein. Sie können das fertige Skript über den Link herunterladen oder aus dem Artikel kopieren. Der gesamte Ablauf wird im Video gezeigt – wiederholen Sie einfach die Schritte, und falls etwas nicht funktioniert, wenden Sie sich an den Support.
Was soll ich mit dem Text tun, der sich bereits im Google Apps Script-Editor befindet?
Löschen Sie es vollständig und fügen Sie an seiner Stelle das Kwiga-Skript ein.
Welche Zugriffsebene sollten Sie beim Bereitstellen der Web-App wählen?
Legen Sie als Bereitstellungstyp „Web-App“ fest und setzen Sie „Wer hat Zugriff“ auf „Jeder“. Klicken Sie anschließend auf „Bereitstellen“. Die daraus resultierende Web-App-URL müssen Sie anschließend auf Kwiga eingeben.
Welchen Anfragetyp sollte ich wählen, wenn ich Daten an eine Tabelle sende?
POST – sowohl in der Automatisierung als auch im Widget-Formular.
Kann ich die Daten des Widget-Formulars in eine Tabelle exportieren?
Ja, wenn das Widget das Element „Formular“ verwendet: Aktivieren Sie „Auch an einen Drittanbieterdienst senden“, geben Sie die Web-App-URL ein und wählen Sie den Anfragetyp POST aus. Sie können nur die Parameter senden, die in diesem Formular enthalten sind.
Für welche Ereignisse können Sie Daten exportieren?
Bei jedem Ereignis, das Sie im Block „Start“ einer Automatisierung auswählen können – zum Beispiel, wenn ein Kontakt oder Tag hinzugefügt wird, oder bei einem erfolgreichen oder fehlgeschlagenen Kauf bzw. einer erfolgreichen oder fehlgeschlagenen Zahlung.
Vielen Dank für Ihr Feedback!
Danke! Wir werden den Artikel überarbeiten. Brauchen Sie sofort eine Antwort? Support kontaktieren