# Click-to-WhatsApp Anzeigen-Attribution Wenn Sie Meta (Facebook/Instagram) „Click to WhatsApp“-Anzeigen schalten, kann Your AI Connector Ihnen sagen, von welcher Anzeige jeder WhatsApp-Lead stammt – und Ihnen die Meta-Klick-ID übermitteln, die Sie benötigen, um echte Conversions an Meta zurückzumelden. Dadurch können Ihre Werbekampagnen auf tatsächliche Verkäufe und Buchungen optimiert werden, nicht nur auf „Personen, die einen Chat gestartet haben“. --- ## Was erfasst wird Wenn jemand auf eine „Click-to-WhatsApp“-Anzeige tippt und Ihrem Unternehmen eine Nachricht sendet, fügt Meta dieser ersten Nachricht versteckte Empfehlungsinformationen hinzu. Your AI Connector liest diese automatisch aus und speichert sie beim Kontakt. Kein Setup, keine Konfiguration – es geschieht einfach. Die erfassten Informationen werden beim Kontakt als `ad_referral` gespeichert und enthalten: | Feld | Was es ist | |---|---| | `ctwa_clid` | Die Meta-Klick-ID. Dies ist der Wert, den Sie an die Conversions API von Meta senden, um eine nachgelagerte Conversion dem exakten Anzeigenklick zuzuordnen. Leer bei Empfehlungen durch organische Beiträge (siehe unten). | | `source_id` | Die ID der Anzeige (oder des Beitrags), auf die die Person geklickt hat. | | `source_type` | Entweder `ad` (eine bezahlte Click-to-WhatsApp-Anzeige) oder `post` (ein organischer Facebook/Instagram-Beitrag). | | `source_url` | Der mit dem Anzeigeninhalt verknüpfte Link. | | `headline` | Der Schlagzeilentext der Anzeige. | | `body` | Der Fließtext der Anzeige. | | `channel` | Der Kanal, über den die Empfehlung einging (derzeit immer `whatsapp`). | | `captured_at` | Wann die Empfehlung erstmals beim Kontakt erfasst wurde. | Sie können dies im [Schnellansicht-Bereich](../get-started/creating-contacts.md) eines Kontakts sehen, wenn Sie ein benutzerdefiniertes Feld dafür konfiguriert haben, oder es direkt über Webhooks und die API auslesen (siehe unten) – es wird in der Kontakte-Tabelle nicht als eigenes beschriftetes Feld aufgeführt. > **Eines verrät Ihnen die Payload nicht:** über welche Ihrer Nummern das Gespräch eingegangen ist. Sie enthält weder eine Seiten-ID noch eine WhatsApp Business Account-ID. Bei einer einzelnen Nummer spielt das keine Rolle; wenn Sie jedoch mehrere Nummern auf verschiedenen Facebook-Seiten betreiben, müssen Sie dies auf Ihrer Seite zuordnen. --- ## Für welche Verbindung dies funktioniert > Dies funktioniert **nur mit der offiziellen WhatsApp-API-Verbindung.** Meta stellt die strukturierten Empfehlungsinformationen (einschließlich `ctwa_clid`) nur über die offizielle WhatsApp Business API bereit. Die **inoffizielle WhatsApp-(Web)-Verbindung empfängt diese nicht** – aufgrund der Funktionsweise sind über diese Verbindung keine Anzeigen-Klickdaten verfügbar. Wenn Ihnen eine lückenlose Anzeigen-Attribution wichtig ist, führen Sie Ihre Click-to-WhatsApp-Kampagnen über eine Nummer durch, die mit der offiziellen WhatsApp API verbunden ist. --- ## First-Touch-Verhalten Die Empfehlung wird bei der **ersten** Nachricht erfasst, die ein Kontakt aus einer Anzeige heraus sendet. Wenn derselbe Kontakt später auf eine andere Anzeige klickt und dieser neuere Klick eine Klick-ID enthält, wird die gespeicherte `ad_referral` aktualisiert, damit die Klick-ID für das Reporting aktuell bleibt. Empfehlungen durch organische Beiträge (die keine `ctwa_clid` haben) überschreiben niemals eine zuvor erfasste Klick-ID einer bezahlten Anzeige. --- ## Übermittlung der Daten an Meta oder Google Ads Your AI Connector erfasst die Attributionsdaten und stellt sie bereit, sendet diese jedoch derzeit **nicht** nativ für Sie an Meta oder Google. Sie leiten die Daten mithilfe von Webhooks und einem Automatisierungstool weiter. Das `ad_referral`-Objekt ist im Abschnitt `contact` der ausgehenden [Webhook](webhooks.md)-Ereignisse enthalten (zum Beispiel „Neue Nachricht“, „Kontakt fortgesetzt“, „Kontakt-Tags aktualisiert“ und Analyseereignisse wie „Termin gebucht“). Ein typisches Setup für eine lückenlose Attribution: 1. Ein Lead klickt auf Ihre „Click-to-WhatsApp“-Anzeige und schreibt Ihnen. Your AI Connector speichert `ad_referral` (einschließlich `ctwa_clid`) beim Kontakt. 2. Während der Lead den Prozess durchläuft – Anruf gebucht, Kunde geworden, verloren – markieren Sie dieses Ergebnis (siehe „Den Funnel-Status übertragen“ weiter unten). 3. Ein Webhook wird an Ihr Automatisierungstool (Zapier, Make oder Pabbly) gesendet, das sowohl das Ergebnis als auch die `ctwa_clid` des Kontakts enthält. 4. Ihr Automatisierungstool ruft die Conversions API von Meta (unter Verwendung von `action_source = business_messaging` und der `ctwa_clid`) oder Google Ads (Offline Conversion Import / Enhanced Conversions for Leads) auf, um die Conversion zu melden. Auf diese Weise erfahren Meta und Google, welche Anzeigen echte Ergebnisse erzielt haben, und optimieren diese entsprechend. --- ## Funnel-Stufe übertragen Um eine Conversion zu melden, benötigen Sie normalerweise zwei Dinge: die Click-ID (wird automatisch erfasst) und das Ergebnis (das Sie festlegen). Der zuverlässigste Weg, ein Ergebnis zuzuordnen, sind **Tags**, da das Anwenden eines Tags den `contact_tags_updated`-Webhook auslöst – und diese Payload enthält die `ad_referral` des Kontakts. (Das Entfernen eines Tags löst ihn nicht aus; siehe [Kontakt-Tags aktualisiert](webhooks.md#contact-tags-updated-webhook).) Sie können Tags automatisch anwenden: - Lassen Sie Ihren KI-Agenten den Kontakt während des Gesprächs taggen – richten Sie Auto-Tagging-Regeln in der Konfiguration des Agenten ein. So funktioniert das Muster „eine Landingpage pro Anzeige → eine Einstiegsnachricht → ein Tag“, wenn Sie die Quelle selbst kennzeichnen möchten. - Oder taggen Sie manuell über „Chats“ oder die „Kontakte“-Seite. Wann immer sich ein relevanter Tag ändert, wird der Webhook mit der angehängten Click-ID ausgelöst, bereit zur Weiterleitung als Conversion. Die Webhook-URL wird direkt am Tag festgelegt, und zwar im Reiter **Tags** des Agenten (oder der Kampagne), dem der Kontakt angehört – nicht in den Einstellungen. Jeder Tag erhält seine eigene URL, und alle können auf denselben Endpunkt verweisen, falls Sie alles an einem zentralen Ort empfangen möchten. ### Lesen einer bereits verpassten Click-ID `ad_referral` wird auch von der API sowohl bei `GET /v1/contacts/{id}` (als `adReferral`) als auch beim Kontaktlisten-Endpunkt (als `ad_referral`) zurückgegeben. Wenn Ihr Empfänger also ausgefallen war oder Sie einen Abgleich im Nachhinein durchführen, können Sie die Click-ID auslesen, anstatt auf den nächsten Webhook zu warten. Kontakte, die eingegangen sind, bevor die Click-ID bei ihnen gespeichert wurde, haben hier `null` – der Wert kann nur aus der eingehenden Nachricht selbst erfasst werden, daher gibt es nichts, was nachträglich ausgefüllt werden könnte. --- ## Einschränkungen - Nur offizielle WhatsApp API-Verbindung (keine inoffizielle Web-Verbindung). - Noch keine native Meta CAPI- oder Google Ads-Integration mit einem Klick – Sie leiten die Daten über Zapier/Make/Pabbly weiter. Wenn Sie eine native Integration wünschen, lassen Sie es den Support unter hi@youraiconnector.com wissen. - Die Attribution wird ab dem Zeitpunkt der Aktivierung erfasst. Sie kann nicht rückwirkend auf Konversationen angewendet werden, die zuvor stattgefunden haben. --- ## Nächste Schritte - [Webhooks](webhooks.md) — sehen Sie sich die vollständige Payload an und welche Ereignisse `ad_referral` enthalten. - [Verwendung von Tags zur Kennzeichnung von Kontakten](../get-started/creating-tags.md) — richten Sie die Tags ein, die Ihre Funnel-Stufen abbilden.