Docs

PWA externes et chaînes Telegram

Deux façons d'élargir le funnel au-delà du builder PWA d'Orbitra : les services PWA tiers comme cibles de stream, et les chaînes Telegram comme destinations d'offre avec des abonnés attribués.

Builders PWA externes

Un service tiers (PWA.Group, TSL.app, ou tout autre) peut être une cible de stream exactement comme une landing :

  1. Créez le builder — ⚙ → Integrations → External PWA. Choisissez un service du catalogue (data/external_pwa_services.json : template d'URL de redirection, template de postback, map de statuts) ou remplissez le vôtre ; vos valeurs gagnent sur celles du catalogue. Les entrées du catalogue livré sont des templates — vérifiez chaque paramètre contre la doc actuelle du service avant de passer en prod.
  2. Faites pointer le service en retour : dans ses réglages, mettez la redirection post-installation à

https://<tracker-domain>/eflow/<campaign-alias>?subid={subid}&eid={eid} (la page montre la forme exacte à copier-coller).

  1. Ajoutez-le à un stream — dans le bloc landings de l'éditeur de campagne, Add external PWA. Les builders externes tournent dans le même pool pondéré que les landings, donc le split vous donne un A/B « votre PWA vs la leur » dans un seul funnel.

Ce qui se passe sur le trafic : le clic part vers le service avec subid = id de clic (clicks.external_pwa_id retient de quel service il s'agit). Quand le visiteur revient sur /eflow/<alias>, le tracker estampe l'installation (external_install_at), stocke l'eid du service (gardé 7 jours) et continue vers l'offre à travers la sélection propre de la campagne — exactement comme une PWA « maison » après l'installation.

Les conversions sur ces clics se postent en retour vers le service par la même file s2s fiable que les postbacks partenaires, avec subid + eid + le mot de statut du service (mappé par service) + le payout. Les rapports de campagne gagnent les installs externes.

Les chaînes Telegram comme offres

Une offre chaîne Telegram envoie les visiteurs de la pub dans une chaîne Telegram via un funnel bot et crédite l'adhésion comme une conversion. Les funnel bots sont séparés du bot admin (Integrations → Telegram) : le bot admin ne répond qu'aux chats que vous avez connectés et lit vos statistiques, donc des inconnus venus d'une pub ne doivent jamais l'atteindre. Le panel refuse le token du bot admin comme funnel bot.

Configuration :

  1. Créez un nouveau bot dans @BotFather et ajoutez son token dans ⚙ → Integrations → Telegram funnel bots.
  2. Ajoutez ce bot à votre chaîne comme admin avec le droit Invite users via link. La chaîne apparaît toute seule sur la carte du bot (ou ajoutez-la là par @name, t.me/… ou -100…).
  3. Créez une offre de type Telegram, choisissez le bot et la chaîne, réglez la fenêtre d'adhésion (1–7 jours) et, optionnellement, un texte de bienvenue.
  4. Mettez l'offre dans un stream de campagne et faites tourner le trafic via le lien de la campagne. Ne distribuez jamais un lien direct de chaîne — ces adhésions ne peuvent pas être attribuées.

Le funnel :

  1. Clic → https://t.me/<funnel bot>?start=<subid> — /start lie l'utilisateur Telegram au clic (tg_start).
  2. Le bot répond avec le texte de bienvenue et une invitation sur demande d'adhésion (creates_join_request=true, expirant avec la fenêtre de l'offre).
  3. chat_join_request → le bot n'approuve que les utilisateurs qu'il a invités dans la fenêtre et écrit une conversion tg_join (avec campagne et offre) sur le clic lié. Les demandes de quiconque d'autre sont laissées aux modérateurs de la chaîne.
  4. Un réseau qui ne connaît que l'abonné poste vers l'URL de postback régulière avec tg_user_id et channel_id au lieu de subid :

https://<domain>/<postback key>/postback?tg_user_id={tg_user_id}&channel_id=-100…&status=deposit&payout=50 — résolu vers le clic de la dernière adhésion de cet utilisateur à la chaîne dans les 30 jours. L'onglet Integration de l'éditeur d'offre montre l'URL exacte.

Les funnel bots sont interrogés par cli/tg_funnel_poll_cron.php (chaque minute, tous les bots en parallèle, pas de webhook — fonctionne sans domaine). install.sh le planifie ; la page des bots affiche la ligne crontab quand le poller ne tourne pas.

← Précédent
Bibliothèque de créas
Suivant →
Postbacks et conversions
Voir la source sur GitHub: github.com/fenjo26/Orbitra.link/wiki
Tous les guides
Docs

Démarrage rapide : votre première campagne

Le chemin court : installez le tracker, créez une campagne et obtenez vos premiers clics et conversions en moins d'une heure.

Lire le guide →
Docs

Installation et mises à jour

Installez Orbitra sur un serveur Ubuntu ou Debian tout neuf en une commande, et passez aux nouvelles versions sans risque.

Lire le guide →
Docs

Migrer depuis Keitaro

Déplacez campagnes, offres, sources et domaines de Keitaro vers Orbitra : ce qui est transféré et quoi vérifier après l'import.

Lire le guide →
Docs

Migrer depuis Binom

Déplacez campagnes et streams de Binom vers Orbitra via l'API publique v2 : ce qui est transféré automatiquement et quoi régler à la main.

Lire le guide →
Docs

Aperçu des fonctionnalités

Tout ce qu'Orbitra sait faire : campaigns et streams, cloaking, landings, PWA, postbacks, coûts, rapports et intégrations.

Lire le guide →
Docs

Campaigns et streams

La référence complète : réglages de campagne, types de streams, schémas, rotation, filtres, test links et chaque option expliquée.

Lire le guide →
Docs

Cloaking

La référence complète du cloaking : couches de détection, réglages globaux, filtres par stream, verdicts et rapports.

Lire le guide →
Docs

Browser check

Comment la vérification JS attrape bots, VM et émulateurs à travers les contradictions de l'environnement du navigateur.

Lire le guide →
Docs

Landing pages

Types de landings, la macro {offer}, l'adaptateur JS, LeadForge et les landings multi-offres — la référence complète.

Lire le guide →
Docs

PWA et Web Push

Construisez des apps PWA installables et collectez des abonnés push : réglages, icônes, événements et notifications.

Lire le guide →
Docs

Funnel de visite PWA

Le funnel configurable des landings PWA : étapes ordonnées, store, instructions et carte push, tracking par écran, statistiques de transitions et éditeur.

Lire le guide →
Docs

Popups de conversion

Un popup avec bouton d'offre sur vos landings : templates par vertical, déclencheurs, designs, une vraie étape du funnel et les métriques Popup CTR.

Lire le guide →
Docs

Enregistrements de session

Replay des visites façon vidéo, heatmap de clics et carte de scroll : activation, sites entiers, consentement cookies, stockage et dépannage.

Lire le guide →
Docs

Content Gallery : référence complète

La médiathèque partagée du tracker : dossiers, uploads, limites de formats, MediaPicker et contrat de taille dans les éditeurs PWA, landing et offre.

Lire le guide →
Docs

Bibliothèque de créas

L'onglet Creatives de la galerie : sync Facebook/TikTok, dépense et ROI par créa, rattachement des brouillons, alertes burnout et rapports.

Lire le guide →
Docs

PWA externes et chaînes Telegram

Builders PWA tiers comme cibles de stream avec installs et postbacks attribués, et offres chaîne Telegram via funnel bots avec conversions tg_join.

Lire le guide →
Docs

Postbacks et conversions

Postbacks entrants, types de conversion et devises, postbacks S2S sortants, macros, file de livraison, testeur, import et Conversions API.

Lire le guide →
Docs

Coûts : import de la dépense

Import de la dépense Facebook, TikTok, Google Ads et réseaux push/pop : matching par IDs, diagnostics, agences, métriques plateforme et agrégateur de revenus.

Lire le guide →
Docs

Réseaux push et pop

Import de dépense AdMaven, PropellerAds, Kadam et autres, et le Zone Killer : règles dry-run/auto pour bloquer les zones qui brûlent de l'argent.

Lire le guide →
Docs

Facebook / Meta

Les deux intégrations Facebook : import de coûts avec mapping des paramètres, et Conversions API avec matching navigateur, consentement et dépannage.

Lire le guide →
Docs

Dolphin / Fbtool

Recevoir les coûts Facebook de Dolphin et Fbtool.pro sur l'endpoint compatible Keitaro : clé API, matching par adset/ad et répartition de la dépense sur les clics.

Lire le guide →
Docs

Nettoyage des commentaires FB

Modération planifiée des commentaires spam sous vos pubs Facebook : dry-run, stop words, regexes admin, whitelist, journal et restauration en un clic.

Lire le guide →
Docs

Sources de trafic et réseaux d'affiliation

Les deux annuaires du funnel : templates de sources avec paramètres et macros, postback vers la source, réseaux d'affiliation et paramètres d'offre.

Lire le guide →
Docs

Rapports, logs et métriques

Dashboard, liste des campagnes, rapport à dimensions, tendances et cohortes, journal du trafic, carte du clic et le détail du calcul de chaque métrique.

Lire le guide →
Docs

Domaines et SSL

Ajouter des domaines, réglages par domaine, certificats Let's Encrypt et Cloudflare, registrars connectés et surveillance Backorder.

Lire le guide →
Docs

Cloudflare

Connecter Cloudflare via l'API : parking DNS automatique, proxy orange, modes SSL de zone, import des zones et réécriture des enregistrements A.

Lire le guide →
Docs

Administration

Utilisateurs, rôles et permissions, clés API, réglages du tracker, bases geo, mises à jour et menu ⚙ : archive, statuts, logs et extension Ads Manager.

Lire le guide →
Docs

Bot Telegram

Statistiques, conversions et digest quotidien dans Telegram : connexion par token, webhook ou polling, commandes, notifications et alertes vers les chaînes.

Lire le guide →
Docs

MCP : un assistant IA dans le tracker

Connecter Claude Desktop ou tout client MCP à Orbitra via le serveur MCP : clés API, options de connexion et les 41 tools disponibles.

Lire le guide →