Web-Abläufe einbetten und UTMs übergeben

Veröffentlichen Sie einen Web-Ablauf und liefern Sie ihn dann auf Ihrer eigenen Domain oder einer SMOC-Landingpage aus. Besucher sehen eine Konversation wie diese:

Landing-URL / Flow-URL

Gehen Sie in Studio zu Einstellungen → Einbetten. Die Flow-URL ist der Direktlink (Hosts sind u. a. go.smoc.ai und go2.smoc.ai) und sieht so aus:

https://go.smoc.ai/<company_key>/<flow_key>/<variant_key>

Hängen Sie UTM-Query-Parameter an, damit Console Kampagnen zuordnen kann. Kopieren Sie die URL-Parameter aus Einstellungen → Integrationen (ohne führendes ?). Bei Meta fügen Sie diese in das Feld Tracking → URL-Parameter der Anzeige ein (gleiche Zeichenkette bei jeder Anzeige oder per Massenbearbeitung) — nicht in die Website-URL. Bei Google fügen Sie sie als Final-URL-Suffix ein und lassen die Final-URL als Flow-URL stehen; {campaignid} füllt sowohl utm_campaign als auch utm_id. Bei LinkedIn fügen Sie sie in die Account- oder Kampagnen-URL-Tracking-Parameter ein; {{AD_SET_ID}} ist die Anzeigengruppe, der die Ausgaben zugeordnet werden, nicht {{CAMPAIGN_ID}}. Bei ChatGPT ersetzen Sie <campaign name> und <campaign id> selbst (utm_source=chatgpt&utm_medium=cpc&utm_campaign=<campaign name>&utm_id=<campaign id>). ChatGPT hängt oppref an. Siehe Meta-, Google-, LinkedIn- und ChatGPT-Ads verbinden.

iframe-Einbettung

1. Veröffentlichen Sie den Web-Ablauf.
2. Öffnen Sie Einstellungen → Einbetten und kopieren Sie den Einbettungscode (<iframe …>).
3. Aktivieren Sie iframe-Modus aktivieren, wenn der Agent in einem iframe läuft (optimiert die Darstellung).

Ausführliche Anleitung: SMOC Flow mit iFrame und Tracking einrichten.

UTMs an ausgehende Links weitergeben

Eingehende UTMs auf der Flow-URL werden für Console-Analysen gespeichert. Sie werden nicht automatisch an ausgehende Link-Nachrichten-URLs angehängt, es sei denn, Sie aktivieren dies.

Aktivieren Sie bei einer Link-Nachricht (oder Open Graph-Link) die Option UTM & Klick-IDs weiterleiten. Wenn ein Besucher mit Kampagnenparametern gekommen ist, erhält die Ziel-URL:

• Alle utm_*-Keys (utm_source, utm_medium, utm_campaign, utm_term, utm_content und alle weiteren mit utm_-Präfix)
• Anzeigen-Klick-IDs: gclid, fbclid, msclkid, ttclid, wbraid, gbraid

Regeln:

• Standardmäßig deaktiviert — bestehende veröffentlichte Links ändern sich nicht
• Parameter, die bereits auf der Ziel-URL sind, bleiben erhalten (Ziel-URL hat Vorrang)
• Leere Werte werden übersprungen
• Studio-Vorschau leitet nicht weiter

Beispiel: Ein Besucher öffnet https://go.smoc.ai/acme/flow/a?utm_source=ads&gclid=abc und klickt auf einen Link zu https://shop.example/offer. Mit aktivierter Einstellung landet er auf https://shop.example/offer?utm_source=ads&gclid=abc.

Für iframe-Einbettungen fügen Sie smoc.js hinzu, damit die UTMs der Elternseite zuerst den Ablauf erreichen. Dann kann diese Einstellung sie an die nächste Seite weitergeben.

Kartenabläufe

Der öffentliche Link eines Kartenablaufs endet auf /cards. Diese Seite kann Text und Design über, neben oder unter der Karte anzeigen. Das Einbettungssnippet verwendet denselben Pfad mit iframe_mode=true, wodurch nur die Karte angezeigt wird, sodass sie in ein kurzes iframe passt. Chat-Abläufe behalten die Bubble-URL ohne /cards. Details: Kartenabläufe.

Channel-Honesty

Einbettungen und Landingpages sind Web-Ablauf-Auslieferungen. Chat und Karte sind zwei Formate dieses Web-Ablaufs. E-Mail/SMS/QR können in denselben Web-Ablauf verlinken; sie sind Verteilungswege, keine eigenen nativen Konversations-Engines.

Verwandte Themen

• Meta-, Google-, LinkedIn- und ChatGPT-Ads verbinden
• Conversions für Meta, Google Ads und LinkedIn tracken
• Integrationen Übersicht
• FAQ: Wie gebe ich UTM-Parameter an ausgehende Link-Nachrichten-URLs weiter?