HubSpot mit Elido verbinden

Die HubSpot-Integration leitet Elido-Konversionsereignisse als Kontakteigenschaften und Deal-Updates in HubSpot weiter. Wenn jemand auf einen verfolgten Link klickt und ein Konversionsziel erreicht, überträgt Elido die Attributionsdaten (UTM-Quelle, Kampagne, Klick-ID) an HubSpot — ohne dass Sie Code schreiben müssen.

Via OAuth verbinden#

1. Gehen Sie zu Dashboard → Konversionen → HubSpot → HubSpot verbinden.
2. Der HubSpot-OAuth-Bildschirm öffnet sich. Melden Sie sich mit einem Konto an, das Zugriff auf "CRM → Objekte" hat.
3. HubSpot zeigt die angeforderten Scopes: crm.objects.contacts.write und crm.objects.deals.write. Diese erlauben Elido, Kontakteigenschaften zu schreiben und Deals durch Phasen zu verschieben.
4. Klicken Sie auf App verbinden. HubSpot leitet Sie zurück zu Elido.

Refresh-Tokens rotieren automatisch. Wenn Sie den Zugriff von HubSpot-Seite widerrufen (Einstellungen → Verbundene Apps), stoppt Elido sofort das Senden von Ereignissen und zeigt einen "Token widerrufen"-Fehler im Lieferprotokoll.

Felder zuordnen#

Gehen Sie nach dem Verbinden zu Dashboard → Konversionen → HubSpot → Konfigurieren:

1. Kontakteigenschaften — wählen Sie aus, welche HubSpot-Kontakteigenschaften Elido beschreibt. Verfügbare Elido-Felder: utm_source, utm_medium, utm_campaign, utm_content, utm_term, click_id, link_slug.
2. Deal-Phase — wählen Sie die Pipeline und Phase, in die eine Konversion einen Deal verschiebt. Leer lassen, wenn Sie keine HubSpot-Deals verwenden.
3. Kontakt abgleichen nach — E-Mail (wenn Sie E-Mail über Ihre Landing-Page erfassen) oder HubSpot-Kontakt-ID (für serverseitige Attribution, bei der Sie hs_contact_id in der URL übergeben).

Was Elido in HubSpot schreibt#

Jede Konversion erstellt ein HubSpot-Timeline-Ereignis und (falls zugeordnet) aktualisiert die Eigenschaften des Kontakts. Die Rohdaten, die Elido sendet:

{
  "event": "conversion.recorded",
  "click_id": "clk_abc123",
  "value": 99.0,
  "currency": "EUR",
  "utm": {
    "source": "newsletter",
    "medium": "email",
    "campaign": "spring-2026"
  }
}

HubSpot zeigt dies als benutzerdefiniertes Timeline-Ereignis im Kontaktdatensatz an. Das Deal-Phasen-Update (falls konfiguriert) wird in derselben Anfrage ausgelöst.

Was nicht synchronisiert wird#

• Klickereignisse ohne Konversion — reine Klicks erstellen keine HubSpot-Datensätze. Nur Konversionen.
• Historische Daten — die Integration ist ab dem Verbindungszeitpunkt nur vorwärts gerichtet.
• HubSpot → Elido — die Integration ist nur ausgehend. HubSpot-Deal-Änderungen fließen nicht zurück zu Elido.

Fehlerbehebung#

Fehler "Unzureichende Berechtigungen" — Der HubSpot-Benutzer, der autorisiert hat, hatte keinen CRM-Schreibzugriff. Bitten Sie einen HubSpot-Superadmin, unter Dashboard → Konversionen → HubSpot → Neu verbinden erneut zu autorisieren.

Kontakt nicht gefunden — Ereignisse verworfen — Wenn Elido keinen passenden Kontakt per E-Mail oder ID findet, wird das Ereignis protokolliert, aber nicht weitergeleitet. Überprüfen Sie Dashboard → Konversionen → Lieferprotokoll auf "kein übereinstimmender Kontakt"-Einträge.

Konversionen kommen mit falscher Kampagnenzuordnung an — Überprüfen Sie, ob UTM-Parameter in der Ziel-URL vorhanden sind. Elido erfasst sie vom Klick; wenn der Link keine UTMs hat, werden die HubSpot-Felder leer sein.

OAuth läuft immer wieder ab — HubSpot widerruft Tokens für Apps, die den Refresh-Endpunkt 6+ Monate lang nicht aufrufen. Die Elido-Integration aktualisiert bei jedem Ereignis. Wenn Sie monatelang keine Konversionen erhalten haben, verbinden Sie manuell neu.