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

# Google Tag Manager einrichten

> Ihren Funnel mit einem eigenen GTM-Container verbinden und die automatisch gesendeten Events nutzen.

## Überblick

Verbinden Sie Ihren Google Tag Manager Container unter **Funnel Editor → Einstellungen → Integrationen → Tracking → Google Tag Manager** über „Verbinden" mit Ihrer **Tag Manager ID** (optional zusätzlich mit einer **Tag Manager Script URL**).

<img src="https://mintcdn.com/osiro/0twm5PN7smzbwm0U/images/convert/funnel-editor/gtm/configuration.png?fit=max&auto=format&n=0twm5PN7smzbwm0U&q=85&s=f736b1779a3e6d53f65872c0ab574e7a" width="2940" height="1846" data-path="images/convert/funnel-editor/gtm/configuration.png" />

<Tip>
  Damit Ihre Tags in Google Tag Manager erst nach Zustimmung im Cookie-Banner feuern, siehe [Tracking mit Consent Mode absichern](/convert/funnel-editor/consent-mode).
</Tip>

***

## Events im Data Layer

Sobald die Tag Manager ID gespeichert ist, lädt osiro `gtm.js` automatisch auf jeder Funnel-Seite und initialisiert `window.dataLayer` – ein manuelles Einbinden des GTM-Snippets in den Seiten-Code ist nicht nötig. Ab diesem Zeitpunkt pusht osiro automatisch die unten aufgeführten Events. Sie müssen in Google Tag Manager nur noch einen Trigger vom Typ **Custom Event** (Event-Name = jeweiliger Event-Name) sowie Data-Layer-Variablen für die benötigten Felder anlegen.

<Note>
  Diese Events feuern nur, wenn der Besucher der Kategorie **Analyse** zugestimmt hat – Details dazu unter [Tracking mit Consent Mode absichern](/convert/funnel-editor/consent-mode).
</Note>

Jedes Event enthält zusätzlich automatisch die Kampagnenparameter aus der URL:

| Feld                                                                  | Beschreibung           |
| --------------------------------------------------------------------- | ---------------------- |
| `utm_source`, `utm_medium`, `utm_campaign`, `utm_term`, `utm_content` | Standard-UTM-Parameter |
| `gclid`, `gbraid`, `wbraid`                                           | Google-Ads-Click-IDs   |
| `fbclid`                                                              | Meta-Click-ID          |

<Card title="funnel_started" icon="flag">
  Feuert einmalig, sobald ein Besucher den ersten Schritt des Funnels sieht.

  | Feld                   | Beschreibung            |
  | ---------------------- | ----------------------- |
  | `funnel_id`            | ID des Funnels          |
  | `step_id`, `step_name` | Erster Schritt          |
  | `step_index`           | `0`                     |
  | `total_steps`          | Gesamtzahl der Schritte |
</Card>

<Card title="step_viewed" icon="eye">
  Feuert bei jedem Schrittwechsel – inklusive des ersten Schritts (gemeinsam mit `funnel_started`).

  | Feld                                                             | Beschreibung                                                 |
  | ---------------------------------------------------------------- | ------------------------------------------------------------ |
  | `funnel_id`, `step_id`, `step_name`, `step_index`, `total_steps` | wie oben                                                     |
  | `block_internal_names`                                           | Interne Namen der Blöcke auf diesem Schritt (falls vergeben) |
</Card>

<Card title="step_completed" icon="check">
  Feuert, wenn ein Besucher einen Schritt verlässt und zum nächsten wechselt.

  | Feld                                                             | Beschreibung                             |
  | ---------------------------------------------------------------- | ---------------------------------------- |
  | `funnel_id`, `step_id`, `step_name`, `step_index`, `total_steps` | Bezieht sich auf den verlassenen Schritt |

  Enthält keine Antwortwerte – nur, dass der Schritt abgeschlossen wurde.
</Card>

<Card title="funnel_success" icon="circle-check">
  Feuert, wenn der Funnel erfolgreich abgesendet wurde – das ist Ihr Conversion-Event.

  | Feld                                | Beschreibung                                                                                                       |
  | ----------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
  | `funnel_id`, `step_id`, `step_name` | Letzter Schritt                                                                                                    |
  | `lead_id`                           | ID des erzeugten Leads                                                                                             |
  | `leadUserData`                      | Kontaktdaten des Leads (E-Mail, Telefon, Name), nutzbar für Google Enhanced Conversions und Meta Advanced Matching |

  Kontaktdaten werden nicht im Klartext an GTM übergeben, sondern verschlüsselt. `leadUserData` kann in seltenen Fällen fehlen (z. B. älterer Browser) – das Event feuert trotzdem.
</Card>

<Card title="form_error" icon="triangle-exclamation">
  Feuert, wenn ein Absende-Versuch fehlschlägt (Validierung oder Server-Fehler) und der Besucher auf dem Schritt bleibt.

  | Feld                                | Beschreibung            |
  | ----------------------------------- | ----------------------- |
  | `funnel_id`, `step_id`, `step_name` | Betroffener Schritt     |
  | `errors`                            | Fehlermeldungen je Feld |
</Card>

### Was nicht übertragen wird

Einzelne Frage-/Antwort-Paare (z. B. „Nutzer hat ‚Flachdach' ausgewählt") werden nicht an GTM gesendet – diese Daten laufen ausschließlich über osiros eigene Funnel-Analytics.

***

## Empfohlene Verknüpfung mit Google Ads, GA4 & Meta

| osiro-Event                      | Google Ads                                                                            | GA4                                                       | Meta Ads                                                      |
| -------------------------------- | ------------------------------------------------------------------------------------- | --------------------------------------------------------- | ------------------------------------------------------------- |
| `funnel_started`                 | –                                                                                     | Als Custom Event, für Funnel-Explorer                     | –                                                             |
| `step_viewed` / `step_completed` | –                                                                                     | Als Custom Event, für Drop-off-Analyse zwischen Schritten | –                                                             |
| `funnel_success`                 | Als Conversion-Aktion anlegen; mit `leadUserData` für Enhanced Conversions verknüpfen | Als Conversion markieren (z. B. `generate_lead`)          | Über Conversions API mit `leadUserData` für Advanced Matching |
| `form_error`                     | –                                                                                     | Für Fehler-Überwachung, nicht als Conversion              | –                                                             |

<Tip>
  Damit diese Tags erst nach Zustimmung im Cookie-Banner feuern, siehe [Tracking mit Consent Mode absichern](/convert/funnel-editor/consent-mode).
</Tip>

***

## Häufige Fragen

<AccordionGroup>
  <Accordion title="Muss ich das GTM-Snippet selbst in den Seiten-Code einbauen?">
    Nein. Sobald Sie die Tag Manager ID gespeichert haben, lädt osiro `gtm.js` automatisch auf jeder Funnel-Seite – ein manuelles Einbinden ist nicht nötig.
  </Accordion>

  <Accordion title="Werden auch einzelne Antworten aus dem Funnel an GTM übertragen?">
    Nein. Einzelne Frage-/Antwort-Paare laufen ausschließlich über osiros eigene Funnel-Analytics und werden nicht an den Data Layer gesendet.
  </Accordion>

  <Accordion title="Feuern die Events auch ohne aktiven Cookie-Banner?">
    Ist gar kein Consent-Tool auf der Seite aktiv, gelten die Events standardmäßig als erlaubt und feuern normal. Ist der osiro Cookie-Banner aktiv, feuern sie nur nach Zustimmung zur Kategorie Analyse – Details dazu unter [Tracking mit Consent Mode absichern](/convert/funnel-editor/consent-mode).
  </Accordion>
</AccordionGroup>