Meta CAPI in Telegram-Bots: So erhalten Sie korrekte Werbeattribution

In vielen Marketing-Funneln führt der Weg von einer Meta-Anzeige über eine Landingpage zu einem Telegram-Bot. Dort werden Leads qualifiziert oder Bestellungen entgegengenommen. Da die Conversion im Bot stattfindet, wird das Ereignis über die Meta Conversions API (CAPI) gemeldet – statt über den Pixel. Doch genau hier entsteht ein häufiges Problem: die Attribution geht verloren.

Warum die Meta CAPI auf den fbc-Parameter angewiesen ist

Meta muss Server-Ereignisse wie Conversions einem bestimmten Anzeigenklick zuordnen können. Dafür nutzt die Plattform den Parameter fbc, der sich aus dem fbclid ableitet. Dieser wird der Landingpage-URL als Query-Parameter angehängt, z. B. ?fbclid=123456789.... Fehlt dieser Parameter, landet das CAPI-Ereignis zwar im System, aber die Zuordnung zum ursprünglichen Klick ist nicht mehr möglich. Die Folge: Die Attributionsqualität sinkt, und Meta kann die Conversion nicht korrekt dem Werbemittel zuordnen.

Die Lösung liegt also darin, den fbclid von der Landingpage in den Telegram-Bot zu übertragen und dort in den fbc-Parameter umzuwandeln. Doch genau hier scheitern viele Implementierungen.

Telegram-Bots und die 64-Zeichen-Grenze

Viele Entwickler versuchen, den fbclid als Payload in einem Deep-Link zum Bot zu übermitteln, z. B.:

Doch Telegram beschränkt die Länge des start-Payloads auf 64 Zeichen. Zudem sind nur bestimmte Zeichen (Buchstaben, Zahlen, Unterstriche, Bindestriche) erlaubt. Ein realer fbclid ist jedoch oft 170 oder mehr Zeichen lang – zu lang für den Deep-Link. Selbst eine URL-Kodierung würde die Zeichenkette weiter verlängern und das Problem nicht lösen. Wer hier eine abgeschnittene oder gekürzte Version des fbclid verwendet, riskiert eine fehlerhafte Attribution.

Der Workaround: Ein Token als Stellvertreter für den fbclid

Statt den fbclid direkt zu übertragen, sollte ein kurzer Token verwendet werden, der auf den ursprünglichen Klick verweist. Der Prozess sieht wie folgt aus:

1. Auf der Landingpage:

• Sobald ein Nutzer über eine Meta-Anzeige auf die Seite gelangt, wird ein zufälliger Token (z. B. 12 URL-sichere Zeichen) generiert.
• Der fbclid, der Zeitpunkt des Klicks sowie ggf. UTM-Parameter werden serverseitig in einer Datenbank (z. B. Redis oder einer einfachen Tabelle) mit diesem Token verknüpft.

1. Im Telegram-Bot:

• Der Deep-Link zum Bot enthält nur den Token, z. B.:

1. Im Bot-Code (Beispiel mit Node.js und der Bibliothek `telegraf`):

   bot.start(async (ctx) => {
     const token = ctx.startPayload; // z. B. "ab12cd34ef"
     const clickData = await store.get(token); // { fbclid, timestamp, utm }
     
     if (clickData) {
       const fbc = `fb.1.${clickData.timestamp}.${clickData.fbclid}`;
       await sendCapiEvent({
         event_name: "Lead",
         action_source: "chat", // da die Conversion im Chat stattfand
         user_data: {
           fbc, // für die korrekte Attribution
           // weitere Nutzerdaten...
         },
       });
     }
   });

Der Token ist kurz genug, um die 64-Zeichen-Grenze von Telegram zu passieren. Der eigentliche fbclid wird nie direkt im Deep-Link übertragen, sondern nur serverseitig referenziert.

Wichtige Details, die oft übersehen werden

• Nutzung des Klick-Zeitpunkts: Der fbc-Parameter sollte mit dem Zeitpunkt des ursprünglichen Klicks (also dem Aufruf der Landingpage) gebildet werden – nicht mit dem Zeitpunkt, an dem der Nutzer den Bot öffnet. Viele Entwickler verwenden versehentlich die Zeitstempel des Bot-Zugriffs, was zu inkonsistenten Daten führt.

• Richtige Angabe von `action_source`: Meta erwartet für Chat-basierte Conversions den Wert chat. Der Wert business_messaging ist dagegen für offizielle Meta-Kanäle wie WhatsApp reserviert. Eine falsche Angabe führt zu ungenauen Daten im Meta Ads Manager.

• Token mit Ablaufdatum: Tokens sollten nach ein bis zwei Tagen automatisch gelöscht werden, um „tote“ Einträge zu vermeiden. Ein Nutzer, der den Deep-Link nie öffnet, sollte keine dauerhaften Ressourcen belegen.

Fazit: Kleine Änderungen, große Wirkung

Die Lösung mag simpel wirken – ein Token ersetzt einen langen Identifier. Doch genau diese Indirektion ist entscheidend, um die Attribution intakt zu halten. Ohne sie bleiben die Conversions im Dunkeln, selbst wenn die Ereignisse in der Meta CAPI ankommen. Wer also bezahlte Werbung in Chat-Funnel nutzt, sollte dringend prüfen, ob die Klick-IDs tatsächlich den gesamten Weg durchhalten. Ein kurzer Check kann verhindern, dass wertvolle Werbebudgets in einer undurchsichtigen Attributionslücke verschwinden.

Wer Unterstützung bei der Implementierung oder Optimierung solcher Tracking-Lösungen benötigt, kann sich an Experten wenden – die Integration ist zwar nicht trivial, aber mit den richtigen Schritten machbar.