> ## Documentation Index
> Fetch the complete documentation index at: https://www.notifuse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Attribution

> Ordnen Sie Traffic mit eigenen Regeln Kanälen zu und schreiben Sie die Historie neu, wenn Sie die Regeln ändern.

![Bereich Filter mit den Attributionsregeln nach Priorität, mit ihren Bedingungen, Operationen und Tags](https://www.notifuse.com/docs/assets/screenshots/web_analytics/filters.png)

Jeder Besuch bringt Rohsignale mit: einen Referrer, einige UTM-Parameter, vielleicht eine Anzeigen-Klick-ID. Attributionsregeln machen daraus einen **Kanal** und eine **Kanalgruppe**, nach denen Sie auswerten können.

Ihre eigene Website zählt nie zu diesen Signalen. Ein Referrer auf demselben Host wie die Seite, zu der er geführt hat, wird verworfen, und der Besuch wird als **direkt** erfasst. Eine Sitzung endet nach 30 Minuten Inaktivität. Wer danach zu einem Tab zurückkehrt oder nach langem Lesen weiterklickt, startet also eine neue Sitzung mit einer Ihrer eigenen Seiten als Referrer.

Ein anderer Host ist ein echter Verweis und bleibt erhalten: Wenn `docs.example.com` auf `www.example.com` verlinkt, erscheint das in Ihren Berichten.

## Standardregeln

Ein neuer Arbeitsbereich startet mit 40 Regeln für bezahlte Suche, bezahlte soziale Medien, bezahlte Videos, Display, organische Suche, organische soziale Medien, E-Mail und direkten Traffic. Es sind gewöhnliche Regeln: Sie können jede davon bearbeiten oder löschen.

| Priorität   | Gruppe                                                                                 |
| ----------- | -------------------------------------------------------------------------------------- |
| 900 bis 831 | Bezahlt, erkannt an der Anzeigen-Klick-ID                                              |
| 830 bis 770 | Bezahlt, erkannt an einer bekannten UTM-Quelle zusammen mit einem bezahlten UTM-Medium |
| 760         | Bezahltes Display, erkannt am Referrer                                                 |
| 750         | Direkt, angegeben durch `utm_source=direct` und `utm_medium=none`                      |
| 745         | E-Mail                                                                                 |
| 740         | Direkter Traffic: kein Referrer _und_ keine Kampagnenparameter                         |
| 705 bis 650 | Organische Suche                                                                       |
| 600 bis 510 | Organische soziale Medien                                                              |
| 10          | Auffangregel (`not-mapped`)                                                            |

> [!NOTE]
>
> E-Mail steht absichtlich über dem direkten Traffic. Viele E-Mail-Programme entfernen den Referrer, sodass ein Klick aus einer E-Mail sonst so aussähe, als hätte jemand Ihre Adresse eingetippt. Deshalb sollten Ihre Kampagnen UTM-Parameter tragen.

> [!WARNING]
>
> Für **Referral**-Traffic gibt es keine vorinstallierte Regel. Ein einfacher Linkklick von einer anderen Website trifft auf keine Regel und landet bewusst in `not-mapped`. So taucht er im Tab Filter auf, wo Sie diese Referrer einmal einordnen können, statt dass er unbemerkt irgendwo abgelegt wird. Legen Sie eine eigene Regel auf Referrer Domain an, wenn Sie einen Referral-Kanal möchten.
>
> Aus demselben Grund verlangen die bezahlten UTM-Regeln neben einem bezahlten Medium auch eine _bekannte_ Quelle. `utm_medium=cpc` von einem Netzwerk, für das Notifuse keine Regel mitliefert, fällt nach `not-mapped` durch, statt als bezahlt zu gelten.

## Wie Regeln angewendet werden

Regeln laufen nach Priorität, die höchste zuerst, und **jede passende Regel trägt bei**: Die Auswertung hört nicht beim ersten Treffer auf.

Der Vorrang gilt pro Zielfeld, nicht pro Regel:

- Für jedes Zielfeld gewinnt die Regel mit der höchsten Priorität, die es schreibt.
- Eine Regel mit niedrigerer Priorität kann trotzdem ein Zielfeld schreiben, das keine höher priorisierte Regel beansprucht hat. Eine Regel, die nur `custom_3` setzt, greift daher auch dann, wenn eine höher priorisierte Regel den Kanal bereits gesetzt hat.
- Zwei passende Regeln mit _gleicher_ Priorität laufen beide, und die spätere überschreibt: Bei Gleichstand gewinnt die letzte Regel, nicht die erste.
- `set as default` beansprucht nie ein Zielfeld, daher überschreibt ein späteres `set` mit niedrigerer Priorität einen zuvor geschriebenen Standardwert. So funktioniert die Auffangregel mit Priorität 10.

## Eine Regel schreiben

Eine Regel besteht aus Bedingungen und den Werten, die geschrieben werden, wenn alle Bedingungen zutreffen. Eine Regel ohne Bedingungen trifft immer zu, wie die vorinstallierte Regel Default Channel, und lässt sich so speichern.

![Bearbeitung der Regel iPhone General: Details, eine Regex-Bedingung auf Landing Path neben einer Operation, die Product line setzt, die Reihenfolge der Regeln, die Prüfungen, ein passender Schnelltest und die Karte Wann sie gilt](https://www.notifuse.com/docs/assets/screenshots/web_analytics/edit_rule.png)

- **Bedingungen** prüfen jedes erfasste Signal: Referrer, Referrer-Domain und Referrer-Pfad, is-direct, Landingpage, Landing-Domain und Landing-Pfad, den aktuellen Pfad, jeden UTM-Parameter und die Anzeigen-Klick-ID, außerdem Gerät, Browser, Browsertyp, Betriebssystem, User-Agent, Verbindungstyp, Sprache und Zeitzone.
- **Operatoren** sind `equals`, `not equals`, `contains`, `not contains`, `is empty`, `is not empty` und `regex`.
- **Operationen** setzen dann einen Wert mit `set`, setzen ihn mit `set` nur als _Standardwert_, wo noch nichts anderes geschrieben wurde, oder entfernen ihn mit `unset`.
- **Zielfelder** sind Channel, Channel Group, jedes der fünf UTM-Felder, Referrer Domain, Is Direct sowie `custom_1` bis `custom_10`.

Eine Regel, die eine benutzerdefinierte Dimension schreibt, ordnet Traffic ein, den Sie an der Quelle nicht markieren konnten. Der Referrer eines Partners kann so zu einem Partnernamen werden, ohne dass der Partner Parameter ergänzen muss.

### Der Regeleditor

**Hinzufügen** oder die Bearbeiten-Schaltfläche einer Regel im Tab Filter öffnet den Editor in voller Breite. Die Leiste zeigt Name und Priorität der Regel, **Nicht gespeicherte Änderungen**, sobald Sie etwas ändern, sowie **Verwerfen** und **Änderungen speichern** (**Regel erstellen** bei einer neuen Regel).

- **Details**: Name, Priorität von 0 bis 1000, aktiviert und Tags.
- **Bedingungen** und **Operationen** stehen auf einem breiten Bildschirm nebeneinander.
- **Reihenfolge der Regeln** listet die Regeln, die dieselben Dimensionen schreiben wie diese Regel, in der Reihenfolge, in der sie laufen (höchste Priorität zuerst, gleiche Prioritäten in Listenreihenfolge). Zu jeder steht, was sie liest und schreibt, mit zwei Regeln auf jeder Seite dieser Regel. **Alle Regeln anzeigen** listet alle.
- **Prüfungen** aktualisieren sich während der Eingabe:
  - ob jede Bedingung und jede „set“-Operation einen Wert hat, und **Trifft immer zu** bei einer Regel ohne Bedingungen;
  - jeden regulären Ausdruck: gültig, vom Server abgelehnt (ein Lookaround oder eine Rückreferenz), kein gültiger regulärer Ausdruck und beim Speichern möglicherweise abgelehnt, oder in einer Syntax geschrieben, die nur die RE2-Engine des Servers versteht, etwa `\A`, `\z`, `\Q…\E`, `\p{…}`, `[[:alpha:]]` oder `(?U)`. Diese letzte Art kann der Browser nicht testen; der Server prüft sie beim Speichern;
  - die aktivierten Regeln, die **zuerst laufen** und diese Regel am Schreiben einer Dimension hindern können, und die, die **später laufen** und sie überschreiben können. Bei einer deaktivierten Regel meldet die Prüfung stattdessen, dass sie nicht läuft und nichts schreibt.
- **Schnelltest** fragt nur die Felder ab, die die Regel liest, und zeigt das Ergebnis jeder Bedingung für diesen Besuch sowie die Werte, die die Regel bei einem Treffer schreibt. Nichts wird gespeichert oder gesendet. **Tester öffnen** übergibt den Besuch an den [Regeltester](#test-your-rules).
- **Wann sie gilt**: für neue Sitzungen ab dem Speichern, für vergangene Sitzungen nach einer [Nacherfassung](#changing-rules-later), dazu der Status der letzten Nacherfassung.

Die Escape-Taste schließt den Editor nicht, und wer ihn mit nicht gespeicherten Änderungen schließt, wird vor dem Verwerfen gefragt. Mitglieder ohne Schreibrecht für Web-Analyse öffnen Regeln schreibgeschützt: Das Formular ist deaktiviert, Speichern nennt den Grund, und der Schnelltest funktioniert weiterhin.

## Regeln testen

![Alle Regeln testen, ausgefüllt aus einer Landing-URL mit UTM-Parametern und einer gclid: die Felder UTM und Seiten sind ausgefüllt, darunter die passenden Regeln mit den Werten, die jede schreibt](https://www.notifuse.com/docs/assets/screenshots/web_analytics/rule_tester.png)

Der Tester schickt einen von Ihnen beschriebenen Besuch in Ihrem Browser durch die Regeln und aktualisiert die Ergebnisse während der Eingabe. Nichts wird gespeichert oder gesendet. **Testen** im Tab Filter führt alle gespeicherten Regeln aus. **Tester öffnen** im Editor führt die Regel aus, die Sie gerade bearbeiten, einschließlich nicht gespeicherter Änderungen, und übernimmt die Werte des Schnelltests.

Die Felder des Besuchs sind nach Art gruppiert, mit der Angabe, wie viele Felder jeder Gruppe Sie ausgefüllt haben. Leere Felder zählen als leere Werte. **Besuch leeren** leert sie, und beim Schließen des Testers wird der Besuch verworfen.

**Von einem Link ausgehen** füllt die Felder aus einer Landing-URL: Landing Page, Landing Domain, Landing Path und Current Path, die fünf UTM-Parameter sowie UTM ID und UTM ID From aus der ersten vorhandenen [Anzeigen-Klick-ID](#ad-click-ids). Die Referrer- und Gerätefelder bleiben so, wie Sie sie eingegeben haben.

- Ein Link ohne Schema wird als `https://` gelesen. Alles außer einer http- oder https-Adresse wird abgelehnt.
- Nur die dreizehn Standard-Klick-IDs werden erkannt. Ein Link mit einer Klick-ID, die Sie über `extraAdClickIds` ergänzt haben, lässt UTM ID hier leer. Tragen Sie sie selbst ein.
- Ein `%` im Pfad oder Fragment, auf das keine zwei Hexadezimalziffern folgen, etwa `/50%off`, macht den Link fehlerhaft. Der Server kann ihn nicht lesen und erfasst Landing-Domain und Landing-Pfad leer. Der Tester füllt sie deshalb ebenfalls leer und nennt den Grund.

Beim Testen aller Regeln werden sie auf Tabs verteilt, die höchste Priorität zuerst, jeweils mit dem Ergebnis jeder Bedingung für den Besuch:

| Tab               | Regeln                                                                                                                                                                        |
| ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Passend**       | Aktivierte Regeln, deren Bedingungen alle zutreffen, mit den Werten, die jede schreibt.                                                                                       |
| **Nicht passend** | Aktivierte Regeln mit einer Bedingung, die nicht zutrifft.                                                                                                                    |
| **Nicht testbar** | Aktivierte Regeln, die keine Bedingung ausschließt, die aber einen regulären Ausdruck enthalten, den nur der Server liest. Der Tab erscheint nur, wenn er eine Regel enthält. |
| **Deaktiviert**   | Regeln, die nie laufen, egal worauf sie zutreffen würden.                                                                                                                     |

> [!NOTE]
>
> Der Tester zeigt, was jede passende Regel für sich allein schreibt. Er wendet keinen [Vorrang](#how-rules-are-applied) an, um die endgültigen Werte für Kanal oder Dimensionen zu ermitteln. Wenn die Auffangregel „default to `not-mapped`“ neben einer Regel anzeigt, die `google-ads` setzt, endet der Besuch als `google-ads`.

## Anzeigen-Klick-IDs

Der Tracker erkennt dreizehn Anzeigen-Klick-IDs in der Landing-URL, in dieser Reihenfolge:
`gclid` (Google Ads), `fbclid` (Meta), `msclkid` (Microsoft), `dclid` (Google
Display), `twclid` (X), `ttclid` (TikTok), `li_fat_id` (LinkedIn), `wbraid` und
`gbraid` (Google Ads), `epik` (Pinterest), `ScCid` (Snapchat), `rdt_cid` (Reddit)
und `qclid` (Quora).

Die erste vorhandene ID landet in `utm_id` und der Parameter, aus dem sie stammt, in
`utm_id_from`. So lässt sich ein bezahlter Klick auch dann zuordnen, wenn die Kampagne
ihre UTMs vergessen hat. „Erste“ bezieht sich auf diese Liste, nicht auf die URL: Ein Link
mit `gclid` und `fbclid` wird Google zugeordnet.

Groß- und Kleinschreibung spielen keine Rolle: `?sccid=`, `?ScCid=` und `?SCCID=` werden alle
erkannt, und `utm_id_from` erfasst immer die kanonische Schreibweise oben, auf die die
mitgelieferten Regeln prüfen.

> [!NOTE]
>
> Um **zusätzlich** zu diesen dreizehn eine eigene Klick-ID zu erfassen, setzen Sie
> `extraAdClickIds: ['myclid']` in `NotifuseAnalyticsConfig`. `adClickIds` gibt es
> ebenfalls, es **ersetzt** die Liste aber vollständig, und `adClickIds: []` erfasst gar keine:
> Verwenden Sie es nur, wenn Sie genau das wollen. Eine Regel, die auf `utm_id_from` prüft,
> greift nur bei einem Parameter, den der Tracker erfassen soll.

## Regeln später ändern

Regeln werden angewendet, wenn ein Besuch erfasst wird. Eine Änderung wirkt sich also auf das aus, was danach passiert, nicht auf das, was schon passiert ist. Um die Regeln auf vorhandenen Traffic anzuwenden, starten Sie im Tab Filter eine **Nacherfassung**.

Eine Nacherfassung schreibt die Attributionsspalten der historischen **Sitzungs- und Zielzeilen** neu, wodurch sich „Umsatz nach Kanal“ für vergangenen Traffic aktualisiert. Sie fügt nie Traffic hinzu, entfernt keinen und ändert keine Zeitpunkte. Zeilen von Seitenaufrufen bleiben völlig unberührt.

> [!WARNING]
>
> Eine Nacherfassung **leert** Kanal und Kanalgruppe in jeder Zeile, die ihre Regeln nicht schreiben.
> Diese beiden Werte gibt es nur, weil eine Regel sie gesetzt hat. „Keine Regel trifft zu“ bedeutet also leer.
>
> Benutzerdefinierte Dimensionen bleiben unberührt, weil Ihr Tracker sie auch ohne
> Regel setzen kann. Eine Regel, die eine davon als Zielfeld hat, schreibt die Zeilen, auf die sie zutrifft,
> trotzdem neu, und eine Regel mit `unset_value` leert sie weiterhin. Eine Zeile, auf die keine Regel zutrifft,
> behält dagegen, was Ihre Website gesendet hat. Ein von einer Regel geschriebener benutzerdefinierter Wert
> übersteht deshalb das Löschen dieser Regel, da ihn danach nichts mehr von einem Wert des Trackers
> unterscheiden kann. Entfernen Sie ihn mit einer vorübergehenden Regel mit `unset_value`.

> [!WARNING]
>
> Pro Arbeitsbereich läuft jeweils nur eine Nacherfassung. Ein Abbruch stoppt sie an der aktuellen Stelle. Die bereits neu geschriebenen Partitionen behalten ihre neuen Werte, sodass ein abgebrochener Lauf Ihre Daten in einem gemischten Zustand hinterlässt, bis Sie ihn erneut ausführen.

## Woher der Traffic kommt

Kampagnen fügen ihren Links UTM-Parameter hinzu (siehe [Kampagnen → UTM-Tracking](https://www.notifuse.com/de/docs/features/broadcast-campaigns.md#utm-tracking)). Die vorinstallierte E-Mail-Regel sucht nach diesen Parametern, sodass Kampagnen-Traffic ohne weiteren Aufwand eingeordnet wird.

## Hinweise

- Die Attribution wird pro Sitzung anhand der Landingpage bestimmt. Wer über eine Suche kommt und später auf eine Ihrer E-Mails klickt, startet nach dem Ende der ersten Sitzung eine neue Sitzung mit eigener Attribution.
- Ziele übernehmen zunächst die Attribution ihrer Sitzung und durchlaufen die Regeln dann erneut mit dem _eigenen_ Seitenpfad des Ziels. Ein Ziel stimmt mit seiner Sitzung überein, es sei denn, eine Ihrer Regeln prüft den aktuellen Pfad.
- Der Regelsatz wird über einen Hash versioniert, den der Server bei jedem Speichern neu berechnet. Die Konsole vergleicht ihn mit der Version der letzten abgeschlossenen Nacherfassung und warnt Sie, wenn Ihre Historie mit einem anderen Regelsatz zugeordnet wurde. Eine Nacherfassung schreibt jede historische Zeile neu, nicht nur die veralteten.
- [API-Referenz](https://www.notifuse.com/docs/api-reference.md)
