# Evalanche (https://webmetic.de/docs/integrationen/evalanche)

Webmetic schreibt in Profile, die in Ihrem Evalanche-Pool schon vorhanden sind. Am Ende haben Sie:

- Evalanche-Profile, die nach jedem neuen Besuch eines Unternehmens dessen Daten, Besuche, Aktivität und Segmente enthalten
- auf Wunsch Tags in Webmetic, die zeigen, welche Unternehmen ein Profil in Evalanche haben und welche nicht
- ein Protokoll in Webmetic, das jede Übertragung mit ihrem Ergebnis zeigt

## Bevor Sie beginnen [#bevor-sie-beginnen]

- **Dauer**: Das Verbinden in Webmetic dauert wenige Minuten. Für die 52 Felder mit dem Präfix `WM_` in Evalanche planen Sie mehr Zeit ein.
- **Konto**: Sie brauchen ein Webmetic-Konto, dessen Tracking-Code auf Ihrer Website läuft. Webmetic überträgt ein Unternehmen erst nach einem neuen Besuch.
- **Zugang**: Sie brauchen Zugangsdaten für die Evalanche-API mit Benutzername und Passwort, dazu die Mandator ID und die Pool ID. Die Mandator ID heißt in Evalanche Mandanten-ID und steht im Mandanten unter **Einstellungen** > **Account** > **Interne ID**. Evalanche zeigt die Pool ID als Objekt-ID des Pools. Der API-Zugang braucht das Systemrecht **Webservices 2.0**, das Recht **Pool anzeigen** und die Profilrechte **Profilliste ansehen** und **Profile exportieren**. Evalanche empfiehlt dafür einen eigenen globalen Benutzer, mit dem sich niemand in der Oberfläche anmeldet.
- **Rechte**: Nur Admins sehen den Menüpunkt **Integrationen**. Wenn ein Partner Ihr Konto unter seinem eigenen Namen betreut, ist diese Integration derzeit nicht verfügbar.
- **Plan**: Integrationen stehen in jedem Plan bereit, auch im Free-Plan. Im Free-Plan überträgt Webmetic nur die Unternehmen, die Sie mit Namen sehen. Mehr dazu unter [Free-Plan](https://webmetic.de/docs/visitor-intelligence/unternehmensliste#unternehmen-im-free-plan-erkennen).
- **Kosten**: Die Integration kostet keine Credits.

## 1. Felder in Evalanche anlegen [#1-felder-in-evalanche-anlegen]

Webmetic legt in Evalanche keine Felder an und schreibt nur in Felder, die in Ihrem Pool schon vorhanden sind.

1. Legen Sie in Ihrem Pool alle 52 Felder mit dem Präfix `WM_` aus der Liste [Evalanche-Felder](https://webmetic.de/docs/integrationen/evalanche/felder) an. Übernehmen Sie die Bezeichnungen genau so, wie sie in der Liste stehen.
2. Legen Sie das Feld `WM_Webmetic Segmente` als **Mehrfach-Selektion** ohne Optionen an. Webmetic ergänzt die Optionen selbst, sobald es Segmentnamen überträgt.
3. Prüfen Sie, ob Ihr Pool das Feld `EMAIL` hat. Wenn das Feld fehlt, legen Sie es ebenfalls an.

Jeder Pool hat das Feld **Externe ID** (`EXTERNAL_ID`). Für Webmetic zählt der technische Name, den Evalanche aus der Bezeichnung bildet, zum Beispiel `WMCOOKIESAKTIVIERT` für `WM_Cookies aktiviert`. Wenn das Feld `WM_Webmetic Segmente` fehlt, überträgt Webmetic keine Segmentnamen.

## 2. Evalanche verbinden [#2-evalanche-verbinden]

1. Klicken Sie auf [**Menü** > **Integrationen** > **Evalanche**](https://app.webmetic.de/?menu=evalanche). Webmetic zeigt, was es überträgt und wann.
2. Klicken Sie auf **Mit Evalanche verbinden**. Das Formular zum Verbinden öffnet sich.
3. Prüfen Sie im Feld **URL** die vorgegebene Adresse `https://scnem4.com`. Wenn Sie sich bei Evalanche unter einer anderen Adresse anmelden, geben Sie diese ein.
4. Geben Sie unter **Benutzername** und **Passwort** die Zugangsdaten für die API ein.
5. Geben Sie die **Mandator ID** und die **Pool ID** Ihres Pools ein.
6. Klicken Sie auf **Verbinden**. Webmetic meldet sich bei Evalanche an und liest die Felder Ihres Pools.

Wenn die Anmeldung funktioniert, wechselt das Fenster zu **Evalanche-Einstellung** und zeigt den Status **Verbunden mit Evalanche**.

![Das Formular Mit Evalanche verbinden mit den Feldern URL, Benutzername, Passwort, Mandator ID und Pool ID](https://webmetic.de/docs/media/de/light/evalanche-verbinden.webp)

## 3. Übertragung einschalten [#3-übertragung-einschalten]

Solange der Schalter **Nur bestehende Profile aktualisieren** aus ist, überträgt Webmetic nichts an Evalanche.

1. Aktivieren Sie im Fenster **Evalanche-Einstellung** den Schalter **Nur bestehende Profile aktualisieren**. Webmetic speichert die Einstellung sofort.
2. Optional: Aktivieren Sie die Option **Synchronisierte Unternehmen kennzeichnen**. Jedes Unternehmen, das Webmetic in mindestens ein Profil schreibt oder schon geschrieben hat, erhält dann das Tag „Evalanche“.
3. Optional: Aktivieren Sie die Option **Unternehmen ohne Evalanche-Profil kennzeichnen**. Unternehmen ohne passendes Profil erhalten dann das Tag „Prospect“.

Sie ändern Namen und Farbe der Tags direkt im Fenster. Wenn ein Unternehmen später ein Profil erhält, tauscht Webmetic das eine Tag gegen das andere.

Sie nutzen beide Tags wie jedes andere Tag, zum Beispiel als Filter in einem [Segment](https://webmetic.de/docs/segmente/segment-builder). Für die Einrichtung brauchen Sie den grauen Schalter **Automatische Synchronisierung** nicht.

![Das Fenster Evalanche-Einstellung mit eingeschaltetem Schalter Nur bestehende Profile aktualisieren und den Tags Evalanche und Prospect](https://webmetic.de/docs/media/de/light/evalanche-einstellungen.webp)

## Was übertragen wird [#was-übertragen-wird]

Webmetic überträgt Unternehmen, keine Personen, und schreibt diese Daten in die Profile:

- **Unternehmensdaten**: Name, Adresse, Telefon, E-Mail, Geschäftsführung, Beschreibungen, NACE-Codes, Mitarbeitende und Umsatz.
- **Besuche**: den Verlauf der Besuche, die Seitenaufrufe, den letzten Besuch mit seinen UTM-Werten und die zuletzt aufgerufene Seite.
- **Aktivität**: die [Aktivität](https://webmetic.de/docs/visitor-intelligence/relevanz-aktivitaet-und-fit) von 0 bis 100 im Feld `WM_lead_score`.
- **Segmente**: die Namen der Segmente, zu denen das Unternehmen bei der Übertragung gehört. Mehr dazu unter [Segmente in anderen Werkzeugen](https://webmetic.de/docs/segmente/benachrichtigung-und-export#segmente-in-anderen-werkzeugen).

Webmetic schreibt Unternehmensdaten nur in leere Felder. Besuche, Aktivität und Segmente überschreibt es dagegen bei jeder Übertragung. Alle Felder mit Typ und Regel finden Sie unter [Evalanche-Felder](https://webmetic.de/docs/integrationen/evalanche/felder).

## Passende Profile [#passende-profile]

Webmetic sucht bei jeder Übertragung neu nach passenden Profilen in Ihrem Pool. Passend ist jedes Profil, auf das eine dieser Regeln zutrifft:

- Im Feld `WM_Website` erkennt Webmetic die üblichen Schreibweisen der Domain: mit oder ohne `www.`, mit oder ohne `https://` und Schrägstrich am Ende, zum Beispiel `bergquell.example` oder `https://www.bergquell.example/`. Schreiben Sie die Domain dabei klein.
- Die E-Mail-Adresse gehört zur Domain der Website, zum Beispiel `einkauf@bergquell.example`. Groß- und Kleinschreibung spielen dabei keine Rolle.

Webmetic vergleicht nicht über Domains von E-Mail-Anbietern wie gmail.com oder web.de.

Alle passenden Profile erhalten dieselben Werte. Wenn drei Ansprechpartner von Bergquell Mineralbrunnen in Ihrem Pool stehen, enthalten alle drei Profile die Daten des Unternehmens. Wenn Webmetic kein passendes Profil findet, überspringt es das Unternehmen und legt kein neues Profil an.

Webmetic schreibt seine Unternehmens-ID in das Feld **Externe ID** (`EXTERNAL_ID`), aber nur, wenn das Feld leer ist. Einen vorhandenen Wert überschreibt Webmetic nie.

<Callout type="warn" title="Webmetic überschreibt Besuchsfelder in allen passenden Profilen">
Webmetic ersetzt Besuche, Aktivität und Segmente bei jeder Übertragung in jedem passenden Profil. Tragen Sie in diese Felder keine eigenen Werte ein. Webmetic löscht keine Profile.
</Callout>

## Wann Webmetic sendet [#wann-webmetic-sendet]

Alle 15 Minuten überträgt Webmetic die Unternehmen, die Ihre Website neu besucht haben. Das gilt für alle Websites Ihres Kontos. Das Protokoll zeigt aber nur die Läufe der ersten Website Ihres Kontos.

Webmetic überträgt Unternehmen, die vor dem Verbinden zu Besuch waren, erst nach ihrem nächsten Besuch. Ohne neuen Besuch bleiben die Werte im Profil, wie sie sind.

Das gilt auch für Segmente. Wenn ein Unternehmen ohne Besuch neu zu einem Segment gehört oder nicht mehr dazugehört, ändert sich das Feld `WM_Webmetic Segmente` erst beim nächsten Besuch.

Im Unternehmensprofil gibt es für Evalanche keine Schaltfläche zum Senden, denn Webmetic überträgt nur über den Schalter **Nur bestehende Profile aktualisieren**. Webmetic übernimmt keine Daten aus Evalanche.

## Übertragung prüfen [#übertragung-prüfen]

1. Klicken Sie auf [**Menü** > **Integrationen** > **Evalanche**](https://app.webmetic.de/?menu=evalanche).
2. Scrollen Sie im selben Fenster zum **Synchronisierungs-Protokoll**. Jeder Eintrag zeigt, wie viele Unternehmen synchronisiert, fehlgeschlagen oder übersprungen sind.
3. Klicken Sie auf einen Eintrag. Webmetic zeigt jedes Unternehmen mit seinem Ergebnis und bei Erfolg die Nummer eines passenden Profils.
4. Öffnen Sie dieses Profil in Evalanche und prüfen Sie die Felder mit dem Präfix `WM_`.

Das Protokoll zeigt die letzten 50 Läufe, in denen Unternehmen zu Besuch waren. Vor dem ersten Lauf steht dort der Hinweis **Noch keine Synchronisierungen aufgezeichnet.**

![Das Synchronisierungs-Protokoll mit einem aufgeklappten Eintrag und den Ergebnissen je Unternehmen](https://webmetic.de/docs/media/de/light/evalanche-protokoll.webp)

## Verbindung trennen [#verbindung-trennen]

1. Klicken Sie auf [**Menü** > **Integrationen** > **Evalanche**](https://app.webmetic.de/?menu=evalanche).
2. Klicken Sie auf **Trennen**. Webmetic trennt die Verbindung sofort und ohne Rückfrage.

Alles, was Webmetic schon geschrieben hat, bleibt in Evalanche, und die Tags bleiben in Webmetic.

## Fehlerbehebung [#fehlerbehebung]

### Warum kommt in Evalanche nichts an? [#warum-kommt-in-evalanche-nichts-an]

Prüfen Sie diese Punkte der Reihe nach:

1. Der Schalter **Nur bestehende Profile aktualisieren** ist eingeschaltet.
2. Das Unternehmen hat Ihre Website besucht, seit Sie den Schalter eingeschaltet haben.
3. Ihr Pool hat ein passendes Profil. Sonst beginnt der Eintrag des Unternehmens im Protokoll mit „No existing profile found in Evalanche“. Wenn passende Profile im Pool stehen und trotzdem diese Meldung erscheint, fehlt dem API-Zugang meist das Recht **Profile exportieren**.
4. Der API-Zugang hat alle Rechte aus [Bevor Sie beginnen](#bevor-sie-beginnen). Wenn das Recht **Profilliste ansehen** fehlt, beginnt der Eintrag im Protokoll mit „Error updating profile“ und enthält „Viewing or editing profiles is not permitted“.

Im Free-Plan überträgt Webmetic nur die Unternehmen, die Sie mit Namen sehen.

### Warum fehlen die Segmente im Profil? [#warum-fehlen-die-segmente-im-profil]

Die häufigste Ursache ist, dass das Feld `WM_Webmetic Segmente` im Pool fehlt oder anders heißt. Legen Sie es als **Mehrfach-Selektion** ohne Optionen an und warten Sie den nächsten Besuch des Unternehmens ab. Wenn ein Unternehmen zu keinem Segment mehr gehört, leert Webmetic das Feld.

### Warum klappt das Verbinden nicht? [#warum-klappt-das-verbinden-nicht]

Wenn die Meldung mit „Could not connect to Evalanche“ beginnt, konnte Webmetic Ihren Pool nicht lesen. Prüfen Sie diese Ursachen:

- **Benutzername** oder **Passwort** stimmen nicht.
- Die **Pool ID** gehört zu keinem Pool, den der API-Zugang sieht.
- Dem API-Zugang fehlt das Recht **Pool anzeigen**.
- Unter der Adresse im Feld **URL** ist Evalanche nicht erreichbar.

Bei der Meldung **Bitte füllen Sie alle Pflichtfelder aus.** ist ein Feld leer.

## Häufige Fragen [#häufige-fragen]

### Legt Webmetic neue Profile an? [#legt-webmetic-neue-profile-an]

Nein. Webmetic schreibt nur in Profile, die in Ihrem Pool schon vorhanden sind, und überspringt Unternehmen ohne passendes Profil.

### Kann ich einzelne Unternehmen oder ein Segment senden? [#kann-ich-einzelne-unternehmen-oder-ein-segment-senden]

Nein. Webmetic überträgt jedes Unternehmen nach seinem nächsten Besuch, solange der Schalter **Nur bestehende Profile aktualisieren** eingeschaltet ist. Die Namen seiner Segmente stehen dann in `WM_Webmetic Segmente`.

## Nächste Schritte [#nächste-schritte]

- [Evalanche-Felder](https://webmetic.de/docs/integrationen/evalanche/felder): Alle Felder mit Typ und Regel für Ihren Pool.
- [Segment anlegen](https://webmetic.de/docs/segmente/segment-builder): Die Segmente bauen, deren Namen Webmetic an Evalanche überträgt.
- [Tags vergeben](https://webmetic.de/docs/visitor-intelligence/tags): Die Tags Evalanche und Prospect in der Unternehmensliste nutzen.
