Docs

Externe PWA und Telegram-Kanäle

Zwei Wege, den Funnel über Orbitras eigenen PWA-Builder hinaus zu weiten: PWA-Dienste von Drittanbietern als Stream-Ziele und Telegram-Kanäle als Offer-Ziele mit zuordenbaren Abonnenten.

Externe PWA-Builder

Ein Drittanbieter-Dienst (PWA.Group, TSL.app oder jeder andere) kann ein Stream-Ziel sein, genau wie eine Landingpage:

  1. Lege den Builder an — ⚙ → Integrations → External PWA. Wähle einen Dienst aus dem Katalog (data/external_pwa_services.json: Redirect-URL-Template, Postback-Template, Status-Map) oder fülle einen eigenen aus; deine Werte schlagen die des Katalogs. Die mitgelieferten Katalog-Einträge sind Templates — prüfe jeden Parameter gegen die aktuelle Doku des Dienstes, bevor du live gehst.
  2. Richte den Dienst zurück: Setze in seinen Einstellungen den Redirect nach der Installation auf

https://<tracker-domain>/eflow/<campaign-alias>?subid={subid}&eid={eid} (die Seite zeigt die exakte Form zum Copy-pasten).

  1. Häng ihn in einen Stream — im Landings-Block des Kampagnen-Editors, Add external PWA. Externe Builder fahren im selben gewichteten Pool wie Landings, der Split gibt dir also das "eigene PWA vs. deren"-A/B in einem Funnel.

Was bei Traffic passiert: Der Klick geht mit subid = Click-ID zum Dienst (clicks.external_pwa_id merkt sich, welcher Dienst). Kehrt der Besucher zu /eflow/<alias> zurück, stempelt der Tracker die Installation (external_install_at), speichert den eid des Dienstes (7 Tage aufbewahrt) und geht über die eigene Auswahl der Kampagne weiter zum Offer — genau wie „eigenes" PWA nach der Installation.

Conversions auf diesen Klicks werden über dieselbe verlässliche S2S-Queue wie Partner-Postbacks zurück an den Dienst geschickt, mit subid + eid + dem Status-Wort des Dienstes (pro Dienst gemappt) + Payout. Kampagnen-Reports bekommen external installs.

Telegram-Kanäle als Offers

Ein Telegram-Kanal-Offer schickt Ad-Besucher durch einen Funnel-Bot in einen Telegram-Kanal und bucht den Beitritt als Conversion. Funnel-Bots sind getrennt vom Admin-Bot (Integrations → Telegram): Der Admin-Bot antwortet nur den Chats, die du verbunden hast, und liest deine Statistik — Fremde aus einer Anzeige dürfen ihn nie erreichen. Das Panel lehnt den Token des Admin-Bots als Funnel-Bot ab.

Einrichtung:

  1. Lege einen neuen Bot in @BotFather an und hinterlege seinen Token unter ⚙ → Integrations → Telegram funnel bots.
  2. Füge diesen Bot deinem Kanal als Admin mit dem Recht Invite users via link hinzu. Der Kanal erscheint von selbst auf der Karte des Bots (oder füge ihn dort per @name, t.me/… oder -100… hinzu).
  3. Lege einen Offer vom Typ Telegram an, wähle Bot und Kanal, setze das Join-Fenster (1–7 Tage) und optional einen Willkommenstext.
  4. Häng den Offer in einen Kampagnen-Stream und fahre Traffic über den Kampagnen-Link. Gib nie einen direkten Kanal-Link heraus — diese Beitritte lassen sich nicht zuordnen.

Der Funnel:

  1. Klick → https://t.me/<funnel bot>?start=<subid> — /start bindet den Telegram-Nutzer an den Klick (tg_start).
  2. Der Bot antwortet mit dem Willkommenstext und einer Join-Request-Einladung (creates_join_request=true, ablaufend mit dem Fenster des Offers).
  3. chat_join_request → Der Bot nimmt nur Nutzer an, die er selbst innerhalb des Fensters eingeladen hat, und schreibt eine tg_join-Conversion (mit Kampagne und Offer) auf den gebundenen Klick. Requests von allen anderen überlässt er den Moderatoren des Kanals.
  4. Ein Netzwerk, das nur den Abonnenten kennt, postet an die normale Postback-URL mit tg_user_id und channel_id statt subid:

https://<domain>/<postback key>/postback?tg_user_id={tg_user_id}&channel_id=-100…&status=deposit&payout=50 — aufgelöst zum Klick des letzten Beitritts dieses Nutzers zum Kanal innerhalb von 30 Tagen. Der Integrations-Reiter des Offer-Editors zeigt die exakte URL.

Funnel-Bots werden von cli/tg_funnel_poll_cron.php gepollt (jede Minute, alle Bots parallel, kein Webhook — funktioniert ohne Domain). install.sh plant ihn ein; die Bots-Seite zeigt die Crontab-Zeile, wenn der Poller nicht läuft.

← Zurück
Creatives-Bibliothek
Weiter →
Postbacks und Conversions
Quelle auf GitHub ansehen: github.com/fenjo26/Orbitra.link/wiki
Alle Guides
Docs

Schnellstart

Von einem nackten Server zur ersten Conversion in neun Schritten: Installation, erster Login, Domain, Netzwerk und Offer, Traffic-Quelle, Kampagne, Prüfung, Kosten.

Guide lesen →
Docs

Installation und Updates

Systemvoraussetzungen, der Ein-Befehl-Installer, PHP-Updates inklusive Sicherheits-Hinweisen, Panel-Zugriff per IP und die lokale Entwicklungsumgebung.

Guide lesen →
Docs

Migration von Keitaro

Einstellungen per SQL-Dump von Keitaro zu Orbitra übertragen: was mitkommt, das Dump-Script, der Import und was du danach prüfen solltest.

Guide lesen →
Docs

Migration von Binom

Kampagnen, Offers, Streams und mehr direkt über die Binom-v2-Public-API importieren — ohne Dump-Datei, inklusive Mapping-Hinweisen.

Guide lesen →
Docs

Funktionen im Überblick

Alle Orbitra-Funktionen auf einen Blick: Traffic und Schemas, Postbacks und Kosten, Analytics, Infrastruktur und Verwaltung — mit Links auf die Detailseiten.

Guide lesen →
Docs

Kampagnen und Streams

Der Kampagnen-Editor im Detail: Reiter, Kostenmodelle, Stream-Typen, alle Filter, Schemas, Rotation mit Auto-Optimierung, Test-Link und Duplikat-Schutz.

Guide lesen →
Docs

Cloaking (Referenz)

Die vollständige Cloaking-Referenz: Detection layers, Sensitivity, Targeting filters, JavaScript-Verifizierung, Verdicts, Gründe und Diagnostik.

Guide lesen →
Docs

Browser check

Bots, Moderator-VMs, Emulatoren und Anti-Detect-Browser an Widersprüchen im Browser selbst erkennen — Modi, Anzeichen und der sichere Einstieg.

Guide lesen →
Docs

Landingpages (Referenz)

Die vollständige Landingpage-Referenz: lokale, Redirect-, Preload- und Action-Landingpages, das {offer}-Makro, SubID-Weitergabe, JS-Adapter und PHP-Landings.

Guide lesen →
Docs

PWA und Web Push

PWA-Landingpages und eigenes Web Push: Builder, Domain-Bindung, VAPID-Keys, Abonnenten, Messages, der Versand-Cron, Attribution und Fehlerbehebung.

Guide lesen →
Docs

PWA Funnel

Der PWA-Besuch als konfigurierbarer Funnel: Screens in fester Reihenfolge, Event-Tracking pro Screen und Re-Engagement-Benachrichtigungen.

Guide lesen →
Docs

Conversion-Popups

Echte Conversion-Events als Popup auf der Landing zeigen: Einrichtung pro Kampagne, Trigger und Platzierung.

Guide lesen →
Docs

Session-Aufzeichnungen und Heatmaps

Echte Besuche wie ein Video abspielen, dazu Klick-Heatmap und Scroll-Map. Speicher-Limits und Datenschutz-Hinweise.

Guide lesen →
Docs

Content Gallery

Die zentrale Mediathek des Trackers für Icons, Screenshots und Creatives, genutzt in PWAs und Landings: Ordner, Uploads, MediaPicker.

Guide lesen →
Docs

Creatives-Bibliothek

Creatives mit SubID-Tracking speichern und über Kampagnen hinweg testen.

Guide lesen →
Docs

Externe PWA und Telegram-Kanäle

PWAs auf externen Domains veröffentlichen und Telegram-Kanäle als Traffic-Quelle mit zuordenbaren Abonnenten fahren.

Guide lesen →
Docs

Postbacks und Conversions

Eingehende Postbacks, Conversion-Statuswerte und -Typen sowie ausgehende S2S-Postbacks an die Traffic-Quelle.

Guide lesen →
Docs

Kosten

Spend aus Facebook, TikTok und Google Ads importieren oder per API und Cron pflegen — und wie der Revenue Aggregator arbeitet.

Guide lesen →
Docs

Push- und Pop-Netzwerke

Arbeit mit Push- und Pop-Traffic-Quellen: Feeds, Zonen-Optimierung und der Zone Killer.

Guide lesen →
Docs

Facebook / Meta

Kosten-Import aus Meta Ads und die Conversions API: serverseitige Events mit Deduplizierung.

Guide lesen →
Docs

Dolphin / Fbtool

Facebook-Kosten über den Keitaro-kompatiblen Admin-API-Endpunkt empfangen: API-Key, Dolphin- und Fbtool-Setup und wie der Spend auf die Klicks verteilt wird.

Guide lesen →
Docs

FB-Kommentar-Cleaner

Spam-Kommentare unter Meta-Ads nach Zeitplan verstecken oder löschen: Regelwerke, Presets, Ausnahmen, Dry-run und Auto-Pause.

Guide lesen →
Docs

Traffic-Quellen und Affiliate-Netzwerke

Die beiden Verzeichnisse am Funnel-Rand: Templates für rund 200 Quellen und 440 Netzwerke, Parameter, Makros und Postback-URLs.

Guide lesen →
Docs

Reports, Logs und Metriken

Der Report-Builder, Traffic-Log, Klick-Karte und jede Metrik erklärt — von Clicks und Visits über ROI bis zur Scroll-Tiefe.

Guide lesen →
Docs

Domains und SSL

Domains hinzufügen, DNS und A-Records, kostenlose Let's-Encrypt-Zertifikate, Cloudflare-Proxy und alle Schalter der Domain-Einstellungen.

Guide lesen →
Docs

Cloudflare

Kampagnen-Domains über Cloudflare fahren: API-Token, Accounts, automatische A-Records, SSL-Modi und der orange Cloud-Proxy.

Guide lesen →
Docs

Administration

Users, Rollen und Rechte, Settings, Geo-Datenbanken, Updates und Systemstatus — die Verwaltung des Trackers über das ⚙-Menü.

Guide lesen →
Docs

Telegram-Bot

Den Tracker aus Telegram steuern: Statistiken, Kampagnen und Conversions per Befehl, dazu Benachrichtigungen und tägliches Digest.

Guide lesen →
Docs

MCP: ein KI-Assistent im Tracker

Claude oder einen anderen MCP-Client an Orbitra anbinden und Kampagnen, Offers und Domains in natürlicher Sprache verwalten.

Guide lesen →