Your AI Connector Docs

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 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-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.)

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