> ## Documentation Index
> Fetch the complete documentation index at: https://knowledge.flowella.io/llms.txt
> Use this file to discover all available pages before exploring further.
# UTM-Tracking von WhatsApp nach HubSpot
> Ordnen Sie WhatsApp-Konversationen der auslösenden Kampagne zu – mit UTM-Parametern auf Click-to-WhatsApp-Anzeigen, Click-to-Chat-Links und CTWA-Tracking.
Wenn ein Kunde Sie über WhatsApp erreicht, ist der wertvollste Teil des Kontexts, **wo er herkommt**: welche Click-to-WhatsApp (CTWA)-Anzeige er angeklickt hat, welcher Website-Link, welche E-Mail-Kampagne. Ohne diese Zuordnung fällt Ihre Berichterstattung auf "WhatsApp" als eine einzige Quelle zusammen. Damit können Sie Kampagnen vergleichen, den Anzeigen-ROAS berechnen und die richtige Attribution in HubSpot-Geschäfte einspeisen.
Diese Seite behandelt die drei Muster, die Flowella für die Übertragung der Kampagnenattribution von WhatsApp in HubSpot unterstützt.
## Muster 1: Klick auf WhatsApp-Anzeigen (`ctwa_clid`)
Facebook und Instagram CTWA-Anzeigen fügen jeder Konversation, die sie auslösen, eine Klick-ID (`ctwa_clid`) hinzu. Meta gibt diese ID in den Gesprächskontext weiter, wenn der Benutzer auf die Anzeige tippt und den Chat startet, und Flowella leitet sie an HubSpot im Kontaktdatensatz weiter.
Ablauf:
1. Der Kunde sieht eine CTWA-Anzeige auf Facebook oder Instagram.
2. Der Kunde tippt auf die Schaltfläche **Nachricht senden** in der Anzeige. WhatsApp öffnet sich mit einer vorausgefüllten Nachricht und Meta nimmt das `ctwa_clid` auf.
3. Der Kunde sendet die Nachricht. Flowella empfängt die eingehende Nachricht mit `ctwa_clid` in den Metadaten.
4. Flowella erstellt oder aktualisiert den Kontakt HubSpot mit dem Wert `ctwa_clid` auf einer speziellen Eigenschaft.
5. Flowella speichert auch den `ctwa_clid`-Wert für die Konversation, so dass die Analyseergebnisse mit den Werbeausgaben verknüpft werden können.
Die Conversions API-Integration von Meta, mit der Conversion-Ereignisse an den Facebook Ads Manager zurückgesendet werden, verwendet dieselbe `ctwa_clid`. Siehe [CTWA Ads](/de/campaigns/click-to-whatsapp-ads), um dies einzurichten, so dass Sie Ihre Werbeausgaben für tatsächliche Konversionen und nicht nur für Klicks optimieren können.
## Muster 2: Click-to-chat-Links von Ihren eigenen Seiten
Wenn Sie eine Schaltfläche **Chat auf WhatsApp** auf Ihrer Website oder in Ihrer E-Mail einfügen, verwenden Sie einen `wa.me`-Link. Der Link unterstützt einen `text`-Parameter, mit dem die erste Nachricht des Benutzers vorausgefüllt wird:
```text theme={null}
https://wa.me/441234567890?text=Hi%20I%27m%20interested%20in%20%5BSPRING_LAUNCH%5D
```
Flowella kann die vorausgefüllte Nachricht nach Tracking-Codes durchsuchen und diese in HubSpot schreiben. Die von uns empfohlene Konvention:
* Verwenden Sie ein **Schlüsselwort in Klammern**, das der Benutzer wahrscheinlich nicht versehentlich eintippen wird, z.B. `[SPRING_LAUNCH]` oder `[NEWSLETTER_JUL]`.
* Umschließen Sie das Schlüsselwort mit Markierungen, damit die Analyse eindeutig ist.
* Halten Sie das Schlüsselwort kurz und für den Menschen lesbar, damit die vorausgefüllte Nachricht noch natürlich aussieht.
Der extrahierte Code landet in der Eigenschaft `whatsapp_entry_source` des HubSpot-Kontakts (oder in einer benutzerdefinierten Eigenschaft, die Sie unter **Flowella → Einstellungen → HubSpot** festlegen).
### Generierung der Links pro Kampagne
Ein praktisches Muster: Erstellen Sie in Ihrem HubSpot-Kampagnentool oder in Ihrer Marketingtabelle eine kleine Suche nach Kampagne → Eingabecode und generieren Sie eine `wa.me`-URL pro Kampagne. Verwenden Sie einen URL-Verkürzer oder die Tracking-URL der Kampagne, wenn Sie einen ordentlicheren Link in E-Mails und Werbemitteln wünschen.
## Muster 3: UTMs für Formular-Eingaben
Wenn die Übermittlung eines HubSpot-Formulars einen WhatsApp-Workflow auslöst, sind die Standardeigenschaften HubSpot und UTM (`hs_analytics_first_url`, `hs_analytics_source`, `hs_analytics_source_data_1` usw.) bereits auf dem Kontakt vorhanden. Flowella liest diese über die HubSpot-Integration aus und zeigt sie im Gesprächskontext an.
Dies ist das sauberste Muster, wenn WhatsApp ein **Follow-up**-Kanal ist: Der Kunde kam ursprünglich über eine mit UTM gekennzeichnete URL, hat ein Formular eingereicht und Flowella löst ein WhatsApp Flow aus, das die Lücken füllt. Die UTM-Attribution wird durchgehend beibehalten, ohne dass WhatsApp etwas damit zu tun hat.
## Erstellen von HubSpot-Berichten anhand dieser Daten
Sobald die Attribution auf dem Kontakt gelandet ist, können Sie Standard-HubSpot-Berichte mit diesen Daten erstellen:
* **Kontakte nach `whatsapp_entry_source`** - welche Kampagnen zu WhatsApp-Leads geführt haben
* **Geschäfte → erste Quelle = WhatsApp** - der Umsatz, der auf Kontakte zurückzuführen ist, die von WhatsApp stammen
* **Workflow-Performance nach Quelle** - welche Kampagnen führten zu den höchsten Antwort-/Konversionsraten innerhalb des WhatsApp Flow
Unter [Berichte und Dashboards](/de/hubspot/reporting-and-dashboards) finden Sie die Berichtsmuster, die wir empfehlen.
## Welche Attribution schreibt Flowella an HubSpot?
Standardmäßig schreibt Flowella die folgenden Eigenschaften zu jedem Kontakt während der WhatsApp-Aktivität:
| Eigenschaft | Typ | Wann geschrieben |
| ----------------------------- | ----------- | ------------------------------------------------------------------------ |
| `whatsapp_opted_in` | Boolean | Wenn der Kontakt WhatsApp seine Zustimmung gibt |
| `whatsapp_first_message_at` | Zeitstempel | Wenn Flowella zum ersten Mal eine eingehende Nachricht sieht |
| `whatsapp_last_message_at` | Zeitstempel | Aktualisiert bei jeder eingehenden Nachricht |
| `whatsapp_entry_source` | String | Der geparste Quellcode der ersten eingehenden Nachricht oder `ctwa_clid` |
| `whatsapp_campaign_id` | String | Die Flowella Kampagnen-ID für die Konversation, falls zutreffend |
| `whatsapp_template_last_sent` | String | Die letzte Vorlage, die an den Kontakt gesendet wurde |
Sie können zusätzliche WhatsApp-Daten auf benutzerdefinierte HubSpot-Eigenschaften in **Flowella → Einstellungen → HubSpot → Feldzuordnung** zuordnen.
## Allgemeine Probleme
Nicht jeder WhatsApp-Eingang enthält ein `ctwa_clid`. Nur diejenigen, die von einer Facebook/Instagram CTWA-Anzeige stammen, tun dies. Direktnachrichten (bei denen der Kunde Ihre Nummer manuell in WhatsApp eingegeben hat) haben diesen Wert nicht, was auch richtig ist - es gibt keine Anzeige, der sie zugeordnet werden können.
Die vorausgefüllte Nachricht ist nur eine Voreinstellung. Einige Benutzer löschen sie vor dem Senden, andere bearbeiten sie. Verlassen Sie sich nicht darauf, wenn es um wichtige Routing-Logik geht.
Ziehen Sie `ctwa_clid` (das der Benutzer nicht löschen kann) der `text` Vorausfüllungsanalyse (die der Benutzer durchführen kann) vor, um eine zuverlässige Zuordnung zu gewährleisten.
Ein Kunde, der am Dienstag auf eine Facebook CTWA-Anzeige geklickt hat, ohne eine Nachricht zu senden, und dann dieselbe Anzeige am Mittwoch öffnete und eine Nachricht sendete, hat die `ctwa_clid` des Klicks vom Mittwoch in den WhatsApp-Metadaten. Die Standard-Attribution von HubSpot (First-Touch/Last-Touch) funktioniert auch dann für die zugrunde liegenden UTMs, wenn der Kunde zwischendurch auch Ihre Website besucht hat.
## Verwandte Anleitungen
* [CTWA Ads](/de/campaigns/click-to-whatsapp-ads) - vollständige Einrichtung einschließlich Conversions API
* [Reporting und Dashboards](/de/hubspot/reporting-and-dashboards) - Umwandlung von Attributionsdaten in Berichte
* [Workflow-Aktionen](/de/hubspot/workflow-actions) - die Workflow-Aktionen, die beim Eintreffen einer eingehenden Nachricht ausgelöst werden