CAPI-Events

Diese Anleitung erklärt, wie du die Conversions API-Events konfigurierst, die AdTarget an Meta sendet, wenn Nutzer deinem Telegram-Kanal beitreten.

Wann werden CAPI-Events gesendet?

AdTarget sendet ein CAPI-Event an Meta nur für zugeordnete Beitritte — also Beitritte, bei denen AdTarget den Telegram-Beitritt einem bestimmten Anzeigenklick auf deiner Landingpage zuordnen kann. Dafür muss der invite_link in Telegrams Webhook vorhanden sein.

CAPI-Events werden gesendet, wenn ein Nutzer deinen nachverfolgten Einladungslink anklickt und Telegram ihn im Webhook meldet (zuverlässig für private Kanäle).

CAPI-Events werden NICHT gesendet für organische Beitritte — Nutzer, die deinen Kanal über die Suche, direkte Links oder weitergeleitete Nachrichten finden. Diese Beitritte erscheinen trotzdem in deinem AdTarget-Dashboard, sind aber als “organisch” markiert.

Einschränkung bei öffentlichen Kanälen: Aufgrund einer Telegram-API-Einschränkung können selbst Nutzer, die deinen nachverfolgten Link anklicken, bei öffentlichen Kanälen als organische Beitritte behandelt werden. Telegrams App (insbesondere Android) wandelt Einladungslink-Beitritte bei öffentlichen Kanälen oft in “direkte Beitritte” um und entfernt dabei die Attributionsdaten. Mehr erfahren →

Verfügbare Event-Typen

AdTarget kann diese Standard-Meta-Events senden:

Event	Am besten für	Meta-Optimierung
Lead	Leadgenerierungs-Kampagnen	Optimiert auf Lead-Absicht
Purchase	Kauforientierte Kampagnen	Optimiert auf Kaufaktionen
CompleteRegistration	Anmelde-Kampagnen	Optimiert auf Registrierungsaktionen
Subscribe	Abonnement-Kampagnen	Optimiert auf Abonnement-Absicht
Custom	Benutzerdefinierter Event-Name	Für spezialisierte Tracking-Anforderungen

Das richtige Event wählen

Schaltest du Leadgenerierungs-Anzeigen? Verwende Lead — Das sagt Meta “Diese Person wurde ein Lead.”

Verkaufst du ein Produkt oder eine Dienstleistung? Verwende Purchase — Am besten, wenn Meta für Käufer optimieren soll. Kombiniere es mit einem value und currency in deiner Kanal-Conversion-Konfiguration für wertbasierte Optimierung.

Schaltest du Anmelde-Kampagnen? Verwende CompleteRegistration — Signalisiert eine abgeschlossene Anmeldeaktion.

Bewirbst du ein Kanal-Abonnement? Verwende Subscribe — Passt zur Nutzeraktion (Beitreten = Abonnieren).

Brauchst du ein nicht-standardmäßiges Event? Verwende Custom — Ermöglicht dir, einen eigenen customEventName für spezialisierte Tracking-Szenarien zu definieren, die nicht in die Standardtypen passen.

Tipp: Passe deinen Event-Typ an dein Kampagnenziel im Werbeanzeigenmanager an, um die besten Ergebnisse zu erzielen.

Events konfigurieren

Event-Typen werden pro Kanal konfiguriert. Jeder Kanal hat standardmäßig Lead, wenn er erstmals erkannt wird.

Um den Event-Typ eines Kanals zu ändern:

Gehe zu den Einstellungen deiner Website → Tab Kanäle
Klicke auf Einrichten (oder Bearbeiten) in der Kanalzeile
Wähle deinen Event-Typ im Dialog
Klicke auf Speichern

Event-Parameter

Jedes Event, das AdTarget sendet, enthält diese Parameter:

Erforderliche Parameter

Parameter	Beschreibung
`event_name`	Der Event-Typ (Lead usw.)
`event_time`	Unix-Zeitstempel des Beitritts
`action_source`	Immer “website”

Attribution-Parameter

Parameter	Beschreibung
`fbc`	Klick-Tracking-Cookie (enthält die `fbclid` aus dem Anzeigenklick, formatiert als `fb.1.{timestamp}.{fbclid}`)
`fbp`	Browser-Tracking-Cookie-Wert (Meta Browser-ID)

Nutzerdaten

Falls verfügbar, sendet AdTarget Nutzerdaten für den Abgleich:

Parameter	Quelle	Gehasht?
`external_id`	Telegram-Nutzer-ID	Ja (SHA-256)
`client_ip_address`	IP vom Landingpage-Besuch	Nein (wird unverschlüsselt gesendet)
`client_user_agent`	Browser vom Landingpage-Besuch	Nein (wird unverschlüsselt gesendet)

Die external_id (Telegram-Nutzer-ID) wird vor dem Senden SHA-256 gehasht, wie von Meta empfohlen. Andere Parameter wie IP-Adresse und User-Agent werden unverschlüsselt gesendet, was den CAPI-Spezifikationen von Meta für diese Felder entspricht.

Benutzerdefinierte Daten

AdTarget sendet außerdem diese Felder im custom_data-Objekt jedes CAPI-Events:

Parameter	Beschreibung
`event_source_url`	Landingpage-URL (zusammengesetzt aus Website-Domain + Besuchspfad)
`value`	Event-Wert (falls pro Kanal konfiguriert)
`currency`	Währungscode (Standard ist `"USD"`)
`content_name`	Kanaltitel oder benutzerdefinierter Name aus der Kanalkonfiguration

Event-Deduplizierung

AdTarget fügt jedem Event eine eindeutige event_id hinzu, um Duplikate zu verhindern:


event_id: "adtarget_{conversion_id}"

Das stellt sicher, dass dieselbe Conversion nicht doppelt gezählt wird, selbst bei Wiederholungen.

Events testen

Validierungs-Test-Event

Wenn du dein Pixel während der Einrichtung speicherst, sendet AdTarget automatisch ein PageView-Test-Event mit dem Code ADTARGET_TEST. Du kannst dies im Meta Events Manager unter dem Tab Test-Events sehen — es bestätigt, dass deine Pixel-ID und dein Zugriffstoken funktionieren.

In der Produktion testen

Der zuverlässigste Weg für einen End-to-End-Test:

Klicke auf deine eigene Anzeige (oder verwende eine Test-Anzeige)
Besuche deine Landingpage
Tritt deinem Telegram-Kanal über den nachverfolgten Einladungslink bei
Prüfe den Events Manager innerhalb von 5 Minuten

Event-Abgleich

Meta gleicht deine Events mit Nutzern für die Attribution ab. Höhere Abgleichqualität = bessere Optimierung.

Faktoren für die Abgleichqualität

Faktor	Auswirkung
fbc vorhanden (enthält fbclid)	Hoch - Direkte Klick-Attribution
User-Agent + IP	Mittel - Probabilistischer Abgleich
External ID	Mittel - Geräteübergreifender Abgleich

Abgleichqualität verbessern

fbclid erfassen: Stelle sicher, dass die URL deiner Landingpage den fbclid-Parameter beibehält
Events zeitnah senden: Kürzere Zeit zwischen Klick und Conversion verbessert den Abgleich
Konsistente Nutzerreise: Halte Nutzer auf deiner Domain, bevor du sie zu Telegram weiterleitest

Gängige Event-Konfigurationen

Leadgenerierung


Event Type: Lead
When: User joins channel
Use Case: "Get subscribers" campaigns

Purchase-Tracking


Event Type: Purchase
When: User joins channel
Use Case: "Buy now" campaigns with value-based optimization

Content-Abonnement


Event Type: Subscribe
When: User joins channel
Use Case: "Subscribe to channel" campaigns

Multi-Kanal-Setup


Channel A (free content): Lead
Channel B (premium): Purchase
Channel C (subscription): Subscribe

Fehlerbehebung

Events werden nicht abgeglichen?

Prüfe, ob fbclid in der Landingpage-URL vorhanden ist
Stelle sicher, dass Meta Pixel auch auf der Landingpage ist
Stelle sicher, dass Cookies nicht blockiert werden

Event-Qualitätsbewertung ist schlecht?

Erhöhe die gesendeten Daten (IP, User-Agent)
Verringere die Zeit zwischen Klick und Conversion
Stelle sicher, dass fbclid erfasst wird

Doppelte Events?

AdTarget übernimmt die Deduplizierung automatisch
Falls du trotzdem Duplikate siehst, kontaktiere den Support

Best Practices

Passe den Event-Typ an dein Kampagnenziel an für bessere Optimierung
Verwende denselben Event-Typ konsistent innerhalb einer Kampagne
Überwache die Event-Qualität wöchentlich im Events Manager
Teste vor dem Skalieren der Werbeausgaben

Nächste Schritte

Deine Meta-Integration ist abgeschlossen! Starte Anzeigen und beobachte, wie deine Conversions in Meta einfließen.

Brauchst du Hilfe bei der Optimierung? Kontaktiere unser Support-Team.