Attribution-Integrationen
Eigener Webhook-Integration
Senden Sie JSON aus Ihrem eigenen Backend, Checkout oder Formular-Handler an die Webhook-URL Ihres Projekts. Nutzen Sie direkt das AutoSEO-Schema oder senden Sie eine beliebige Struktur und ordnen Sie sie einmal zu – spätere Payloads werden automatisch gelesen.
Überblick
Das bekommen Sie mit dem eigenen Webhook
- Ein HTTPS-Endpoint pro Projekt, mit dem Token in der URL oder im Header
- JSON-, form-encoded- und Multipart-Bodys bis 256 KB
- Das AutoSEO-Schema für Antworten (channelId) und Bestellungen (transactionId und dealValue)
- Unbekannte Strukturen legen bei der ersten Zustellung einen Field-Mapping-Workflow an
- Payloads, die auf ein Mapping warten, werden sieben Tage verschlüsselt aufbewahrt und danach verarbeitet
- Bis zu 120 Requests pro Minute und Projekt, jeder unter Webhook Logs
Anwendungsfälle
Das können Sie tun mit dem eigenen Webhook
Aus dem eigenen Backend melden
Senden Sie die Antwort aus Ihrem Anmelde- oder Checkout-Handler zusammen mit Bestell-ID und Wert.
Jede Payload-Struktur annehmen
Richten Sie einen vorhandenen Webhook eines anderen Tools auf AutoSEO und ordnen Sie seine Felder einmalig unter Field Mapping zu.
Zuordnen, ohne E-Mails zu teilen
Hashen Sie E-Mails selbst und senden Sie respondentEmailHash; AutoSEO ordnet über den Hash zu und sieht die Adresse nie.
Den Assistenten nennen
Senden Sie channelDetail wie chatgpt oder perplexity oder Freitext – AutoSEO ordnet beides dem richtigen Assistenten zu.
Einrichtung
Den Webhook in vier Schritten einrichten – in jeder Sprache und jedem Tool.
- 1 Schritt 1
Webhook-URL erzeugen
Öffnen Sie in Ihrem Projekt Attribution → Integrations → Custom Webhook und klicken Sie auf Connect. Kopieren Sie die URL – sie wird nur einmal angezeigt.
- 2 Schritt 2
Token-Übergabe wählen
Lassen Sie es in der URL oder senden Sie es als Header X-Attribution-Token bzw. als Authorization: Bearer.
- 3 Schritt 3
Daten per POST senden
Senden Sie channelId für eine Antwort oder transactionId mit dealValue und dealCurrency für eine Bestellung. Mit respondentEmail oder respondentEmailHash verknüpfen Sie beides.
- 4 Schritt 4
Andere Strukturen einmal zuordnen
Nutzt Ihre Payload eine andere Struktur, öffnen Sie den neuen Workflow unter Field Mapping, wählen Sie Antwort, E-Mail, Wert und Bestellfelder und speichern Sie. Wartende Payloads werden sofort verarbeitet.
FAQ
Häufige Fragen
Wie sende ich Attribution-Daten aus meinem eigenen System an AutoSEO?
Senden Sie JSON per POST an die Webhook-URL Ihres Projekts, mit mindestens channelId, der Antwort auf „Wie sind Sie auf uns aufmerksam geworden?“. AutoSEO ordnet die Antwort einem Kanal zu – KI-Suche, Suche, Social, Werbung, Empfehlung, Content oder Sonstiges – und verknüpft sie per Bestell-ID oder E-Mail-Hash mit Bestellungen.
Wie sieht das JSON-Schema aus?
Eine Antwort braucht channelId, zum Beispiel ai_search oder Freitext wie „ChatGPT“. Optional sind channelDetail, freetextResponse, respondentEmail oder respondentEmailHash, respondentExternalId, respondentName, dealValue, dealCurrency, transactionId, formId, formName, pageUrl, occurredAt und bis zu 8 KB metadata.
Kann ich Bestellungen ohne Antwort senden?
Ja. Eine Payload mit transactionId oder mit dealValue und E-Mail wird als Conversion gespeichert. AutoSEO verknüpft sie per Bestell-ID oder E-Mail-Hash mit der Antwort des Kunden und schaut dabei bis zu 90 Tage zurück.
Was, wenn meine Payload anders aufgebaut ist?
Die erste Zustellung legt unter Field Mapping einen Workflow mit vorgeschlagenen Feldern an. Pfade reichen in verschachtelte Objekte und Arrays, etwa answers[field.ref=hdyhau].choice.label, und nach dem Speichern werden künftige Payloads dieser Struktur automatisch gelesen.
Webhook oder REST API – was soll ich nutzen?
Nutzen Sie den Webhook für Events aus anderen Systemen; er braucht nur das Token der URL. Die REST API benötigt einen API-Key mit dem Scope write und bietet zusätzlich einen Bulk-Endpoint für bis zu 1.000 Antworten pro Request.
Wie ist der eigene Webhook abgesichert?
Das Token wird nur als Hash gespeichert und lässt sich jederzeit neu erzeugen. Requests ohne gültiges Token werden abgelehnt und pro IP begrenzt, und E-Mails werden beim Eingang gehasht.
Ist der eigene Webhook im Preis enthalten?
Ja. Attribution und alle Integrationen sind Teil der Open-Source-App: kostenlos beim Self-Hosting oder in einem AutoSEO-Cloud-Workspace für 50 $ im Monat enthalten, inklusive 10 $ KI- und Datennutzung.
Attribution-Integrationen
Weitere Integrationen dieser Kategorie
- HubSpotKontakte und Deals samt Deal-Wert aus einem HubSpot-Workflow senden.
- SalesforceLeads und Opportunities aus einem Salesforce Flow senden.
- ShopifyEin Custom Pixel ordnet Shopify-Bestellungen und Umsatz der KI-Suche zu.
- StripeSignierte Webhooks machen Checkouts und Rechnungen zu Conversions.
- WooCommerceNative Bestell-Webhooks von WooCommerce, geprüft mit einem gemeinsamen Secret.
- ShopwareNeue Bestellungen aus dem Shopware Flow Builder senden.
- TypeformTypeform-Webhooks; die Frage nach der Herkunft wird automatisch erkannt.
- TallyTally-Webhooks mit automatisch aufgelösten Antwortoptionen.
- JotformJotform-Einsendungen per Webhook erfassen.
- Gravity FormsWordPress-Formulare über das Webhooks Add-On erfassen.
- FormstackFormstack-Einsendungen per Webhook erfassen.
- SurveyMonkeyAntworten einer SurveyMonkey-Umfrage über die API importieren.
- FairingPost-Purchase-Antworten mit Bestellnummer und Summe importieren.
- KnoCommercePost-Purchase-Umfragen aus KnoCommerce importieren.
- ZigpollOnsite- und Post-Purchase-Umfragen aus Zigpoll importieren.
- PipedrivePipedrive-Deal-Webhooks mit Wert und Währung.
- AttioDatensätze und Deals aus einem Attio-Workflow senden.
- CloseClose-Webhooks für Leads und Opportunities.
- IntercomKontakt-Webhooks mit der Antwort in einem Custom Attribute.
- CalendlyAntworten auf Buchungsfragen aus Calendly-Webhooks.
- Zapier / MakeAntworten aus jeder App über Zapier oder Make senden.
- n8nAntworten aus jedem n8n-Workflow senden.
Ordnen Sie jedes System der KI-Suche zu
Starten Sie mit einem AutoSEO-Cloud-Workspace für 50 $/Monat – oder hosten Sie die Open-Source-Edition kostenlos selbst.