Anzeigen-Klick-Attribution für WhatsApp #

Wenn Sie Meta- oder Google-Anzeigen auf eine Seite Ihrer eigenen Website schalten und diese Seite einen WhatsApp-Button enthält, kann DM Champ Ihnen mitteilen, von welchem Anzeigenklick die jeweilige WhatsApp-Konversation stammt. Sie fügen ein kleines Skript auf Ihrer Website ein. Wenn ein Besucher auf Ihren WhatsApp-Button tippt, wird der Klick gespeichert und der ersten Nachricht zugeordnet, die er Ihnen sendet. Der Kontakt zeigt dann die Kampagne an, aus der er stammt, und die Klickdaten werden mit dem Kontakt in Webhooks, die API und, falls gewünscht, zurück an Meta übertragen.

Dies funktioniert für jede Seite mit einem WhatsApp-Button: eine Landingpage, eine Buchungsseite, eine Preisseite oder ein Quiz, das mit „Meine Antworten per WhatsApp senden“ endet.

Diese Seite befasst sich mit Anzeigen, die Nutzer zuerst auf Ihre Website leiten. Wenn Ihre Anzeigen WhatsApp direkt öffnen (Metas „Click-to-WhatsApp“-Anzeigen), wird dies automatisch und ohne Skript unter Click-to-WhatsApp-Anzeigenattribution abgedeckt.

Einrichtung #

1. Gehen Sie zu Einstellungen → Anzeigen-Klick-Tracking (Gruppe Integrationen).
2. Klicken Sie auf Einschalten und mein Skript abrufen. Ihr Konto erhält einen eigenen Site-Key und ein einzeiliges Skript.
3. Kopieren Sie das Skript und fügen Sie es direkt vor dem schließenden </body>-Tag auf jeder Seite ein, die einen WhatsApp-Button enthält:

<script src="https://api.dmchamp.com/v1/ad-visit/YOUR_SITE_KEY.js" async></script>

4. Optional: Geben Sie unter WhatsApp-Nummer die Nummer ein, auf die Ihre Buttons verlinken. Nur Links zu dieser Nummer werden dann getrackt. Lassen Sie das Feld leer, um jeden WhatsApp-Link auf der Website zu tracken.
5. Wählen Sie den Wortlaut für die Anfragenummer (siehe unten) und klicken Sie auf Speichern. Sie müssen das Skript auf Ihrer Website nach einer Einstellungsänderung nicht mehr ändern.
6. Testen Sie es: Öffnen Sie Ihre Seite über einen Link mit einem Kampagnen-Tag, zum Beispiel https://yoursite.com/?utm_source=test&utm_campaign=setup-check, tippen Sie auf Ihren eigenen WhatsApp-Button und senden Sie die Nachricht. Öffnen Sie diesen Kontakt in Chats: Das Kontakt-Panel zeigt Stammt von einem Anzeigenklick mit der Kampagne an.

Der Site-Key ist bereits im Skript enthalten. Es ist kein Passwort, daher ist es auf einer öffentlichen Seite unbedenklich.

Was das Skript tut #

• Beim Laden der Seite speichert es die Anzeigen-Klick-IDs und Kampagnen-Tags (die utm_-Parameter) aus der Seitenadresse im Sitzungsspeicher des Browser-Tabs, sodass sie weiterhin vorhanden sind, falls der Besucher zuerst eine andere Seite ansieht. Es setzt kein Cookie, lädt nichts anderes und sendet nichts.
• Wenn der Besucher auf einen WhatsApp-Link tippt (wa.me, api.whatsapp.com/send oder whatsapp://send), fügt es die Anfragenummer zur Nachricht hinzu, zeichnet den Besuch auf und lässt den Klick wie gewohnt zu WhatsApp weiterlaufen.

Vor dem Tippen wird nichts an DM Champ gesendet.

Die Anfragenummer #

Eine kurze Nummer, ähnlich der Referenz, die Ihnen ein Geschäft oder eine Klinik gibt, wird der WhatsApp-Nachricht des Besuchers hinzugefügt. So weiß DM Champ genau, welcher Anzeigenklick zu welcher Konversation gehört. Eine Nachricht sieht dann so aus:

Hi, I would like to know more.
Enquiry no. 4827

• Wortlaut: „Anfragenr.“ ist die Standardeinstellung. Sie können jede einzeilige Textzeile verwenden, die für Ihr Unternehmen natürlich klingt, wie z. B. „Buchungsref.“ oder „Ref.“. Keine Ziffern.
• Wo: In einer eigenen letzten Zeile (Standard) oder Am Ende des Textes. Die Einstellungsseite zeigt eine Live-Vorschau.
• Länge: 4 Ziffern, oder 5, wenn Ihre Website sehr stark frequentiert ist.
• Ihr KI-Agent sieht sie nie und wiederholt sie nie. Der Posteingang zeigt die vollständige Nachricht inklusive Nummer an.

Sie können die Anfragenummer deaktivieren. Die Zuordnung erfolgt dann nur noch über den Text der Nachricht. Das bedeutet, dass zwei Besucher, die exakt denselben Text senden (zum Beispiel dieselben Quizantworten), nicht unterschieden werden können und einige Klicks nicht zugeordnet werden.

Ihr eigener Quiz- oder Button-Code #

Wenn Ihre Seite die WhatsApp-Nachricht selbst erstellt (ein Quiz, das die Antworten in den Text einfügt, oder Ihr eigener Button-Code), fügen Sie dem Skript-Tag data-manual hinzu:

<script src="https://api.dmchamp.com/v1/ad-visit/YOUR_SITE_KEY.js" data-manual async></script>

Mit data-manual ändert das Skript WhatsApp-Links nicht mehr von selbst. Ihr eigener Code ruft es direkt vor dem Öffnen von WhatsApp auf, sodass jeder Besuch einmal erfasst wird:

• window.ChatAttribution.text(finalText, number) gibt Ihren Text mit der hinzugefügten Anfragenummer zurück und zeichnet den Besuch auf. Verwenden Sie den zurückgegebenen Text in Ihrem WhatsApp-Link.
• window.ChatAttribution.link(finalText, number) macht dasselbe und gibt einen fertigen wa.me-Link mit diesem Text zurück. Lassen Sie die Nummer weg, um diejenige zu verwenden, die unter WhatsApp-Nummer in den Einstellungen hinterlegt ist.

<script>
  function sendAnswers(answers) {
    var text = "Hi, my answers: " + answers.join(", ");
    if (window.ChatAttribution) {
      window.location.href = window.ChatAttribution.link(text, "+15551234567");
    } else {
      window.location.href = "https://wa.me/15551234567?text=" + encodeURIComponent(text);
    }
  }
</script>

Der else-Zweig sorgt dafür, dass der Button auch dann funktioniert, wenn das Skript nicht geladen wurde, zum Beispiel wenn eine Browser-Erweiterung es blockiert. Ein Text, der bereits eine vom Skript vergebene Nummer enthält, wird nie ein zweites Mal geändert.

Was aufgezeichnet wird #

Beim Antippen speichert der Besuchseintrag:

• die Anzeigen-Klick-IDs in der Seitenadresse, wie fbclid (Meta) und gclid (Google)
• die _fbc- und _fbp-Cookies, falls Ihr eigenes Meta-Pixel diese auf Ihrer Website gesetzt hat (das Skript liest sie nur aus, es setzt sie niemals selbst)
• die Kampagnen-Tags (utm_source, utm_medium, utm_campaign, utm_content, utm_term)
• die Landingpage, die Seite, von der der Besucher kam, den Browser und den Nachrichtentext
• die IP-Adresse und die Uhrzeit, die von DM Champ hinzugefügt werden, wenn der Besuch eingeht

Besuchsdatensätze werden 90 Tage lang aufbewahrt. Wenn ein Besuch zugeordnet wird, wird eine Kopie seiner Klickdaten beim Kontakt gespeichert und bleibt dort, bis Sie sie löschen.

Ihr Datenschutzhinweis: Das Skript läuft auf Ihrer Website, daher sollte der Datenschutzhinweis Ihrer Website es erwähnen: was es aufzeichnet (die Liste oben) und dass dies geschieht, wenn ein Besucher einen WhatsApp-Button antippt.

Wie die Zuordnung funktioniert #

Wenn die erste Nachricht eines Kontakts eingeht, sucht DM Champ nach einem Besuch aus den 15 Minuten davor:

1. Zuerst nach Anfragenummer. Eine Nachricht, die eine vom Skript vergebene Nummer enthält, wird diesem Besuch zugeordnet.
2. Ansonsten nach identischem Text. Eine Nachricht mit exakt demselben Text wie ein Besuch wird diesem zugeordnet. Wenn zwei verschiedene Besucher innerhalb des Zeitfensters denselben Text gesendet haben, wird absichtlich keiner von beiden zugeordnet, damit ein Kontakt niemals der falschen Anzeige zugerechnet wird.

Eine spätere Nachricht, die die Anfragenummer enthält, wird ebenfalls zugeordnet, solange der Kontakt noch keine Zuordnung hat.

Einschränkungen:

• Der erste Treffer gewinnt. Sobald ein Kontakt einen Treffer hat, wird dieser nie überschrieben.
• Nur WhatsApp: die Kanäle WhatsApp Business API und WhatsApp Web.
• 15 Minuten: Ein Besucher, der auf die Schaltfläche tippt, die Nachricht aber erst viel später sendet, wird nicht zugeordnet.
• Nur zukünftig: Kontakte von vor der Installation des Skripts haben keinen Treffer.

Wo Sie es sehen #

• Kontakt-Panel: Kam über einen Anzeigenklick mit der Kampagne oder Quelle und dem Datum. Bewegen Sie den Mauszeiger darüber, um die Details zu sehen.
• Webhooks: contact.ad_attribution in Agent-Tag-Webhooks und in jedem Webhook-Abonnement-Ereignis, das einen Kontakt enthält.
• API: ad_attribution in der Kontaktliste und adAttribution bei einem einzelnen Kontakt, im Bereich Kontakte der API-Referenz.
• MCP-Tools: dasselbe Objekt bei jedem Kontakt, den sie zurückgeben.

Der Wert ist null, wenn der Kontakt keinen Treffer hat.

Ergebnisse an Meta senden (optional) #

Sie können DM Champ Ergebnisse an Ihr Meta-Anzeigenkonto zurückmelden lassen, damit Meta lernt, welche Anzeigen echte Leads und Verkäufe bringen, und diese optimiert. Dies verwendet Ihre eigenen Meta Conversions API-Details.

1. Suchen Sie im Meta Events Manager unter Datenquellen Ihre Pixel-ID (auch Datensatz-ID genannt) und erstellen Sie unter Einstellungen, Conversions API, Zugriffstoken generieren ein Zugriffstoken.
2. Geben Sie unter Einstellungen → Anzeigenklick-Tracking im Bereich Ergebnisse an Meta senden (optional) die Pixel- / Datensatz-ID und das Zugriffstoken ein. Zum Testen können Sie den Test-Event-Code aus dem Tab „Test-Events“ von Meta hinzufügen; löschen Sie ihn, wenn Sie fertig sind. Klicken Sie auf Meta-Details speichern.
3. Öffnen Sie den Agent-Editor, gehen Sie zum Tab Tags und öffnen Sie ein Tag. Wählen Sie unter An Meta senden das Ereignis aus: Lead, Kontakt, Termin, Kauf oder einen benutzerdefinierten Namen. Fügen Sie optional einen Wert und eine Währung hinzu.

Von da an sendet DM Champ jedes Mal, wenn dieses Tag auf einen Kontakt angewendet wird (durch die KI, manuell, über die API oder durch eine Automatisierung), das Ereignis mit den gespeicherten Klickdaten des Kontakts (fbc, fbp, IP-Adresse, Browser, Landingpage) sowie dessen Telefonnummer, E-Mail und Name (gehasht) an Meta, damit Meta es der Anzeige zuordnen kann. Ein Kontakt ohne Treffer sendet das Ereignis weiterhin, jedoch nur mit der gehashten Telefonnummer, E-Mail und dem Namen.

• Keine Doppelzählung: Jedes Ereignis hat eine feste ID, die aus der Kontakt-ID und dem Tag-Namen besteht. Wenn Ihr CRM dasselbe Ereignis mit derselben ID an Meta sendet, behält Meta nur eines.
• Metas Attributionsfenster: Meta rechnet ein Ereignis nur innerhalb seines Attributionsfensters einer Anzeige an, das standardmäßig 7 Tage nach dem Klick liegt. Ein Abschluss, der erst Wochen später erfolgt, zählt nicht von selbst. Senden Sie daher auch ein früheres Ereignis, zum Beispiel ein Tag für das gebuchte oder bezahlte Beratungsgespräch.

FAQ #

Funktioniert das, wenn meine Anzeige WhatsApp direkt öffnet? Diese Anzeigen führen nicht über Ihre Website, daher wird das Skript nie ausgeführt. Meta sendet die Anzeigendetails stattdessen mit der ersten Nachricht, siehe Click-to-WhatsApp-Anzeigenattribution.

Verlangsamt das Skript meine Website oder setzt es Cookies? Es wird im Hintergrund geladen (async), setzt keine Cookies und lädt nichts anderes. Es sendet nur dann Daten, wenn ein Besucher auf einen WhatsApp-Button tippt.

Kann ich neben Meta-Anzeigen auch Google Ads verfolgen? Ja. Google-Klick-IDs (gclid, gbraid, wbraid) und alle Kampagnen-Tags werden aufgezeichnet und beim Kontakt angezeigt. Das Zurücksenden von Ergebnissen ist nur für Meta verfügbar.

Warum hat ein Kontakt keinen Treffer erhalten? Die häufigsten Gründe: Die Nachricht kam mehr als 15 Minuten nach dem Tippen an, die Anfragenummer wurde aus der Nachricht entfernt, die Anfragenummer ist deaktiviert und ein anderer Besucher hat denselben Text gesendet, oder die Seite enthält das Skript nicht.

Meine Website verlinkt auf zwei WhatsApp-Nummern. Kann ich nur eine verfolgen? Ja. Geben Sie diese Nummer in den Einstellungen unter WhatsApp-Nummer ein. Lassen Sie das Feld leer, um jeden WhatsApp-Link zu verfolgen.

Kann ich den Wortlaut später ändern? Ja. Änderungen werden sofort auf Ihrer Website übernommen; Sie müssen das Skript nicht erneut einfügen.