Bibliothèque de créas
L'onglet Creatives de la Content Gallery répond à une seule question : quelles créas rapportent vraiment. Il prolonge la galerie existante — les fichiers synchronisés depuis les plateformes (images et vidéos Facebook, couvertures TikTok) vivent aux côtés de vos propres uploads, chaque créa porte spend/revenus/ROI, et un brouillon téléversé manuellement récupère ses métriques dès qu'une pub commence à le diffuser.
Comment les données arrivent
Rien n'est configuré à la main. La chaîne est :
- Cost sync (cron de l'agrégateur ou Sync now) tire les lignes de dépense de Facebook/TikTok. Chaque ligne porte désormais aussi les noms ad/adset/campaign et les compteurs d'impressions/clics propres à la plateforme (
cost_records.impressions,cost_records.platform_clicks), et les upsert dansad_entities. - Creative metadata pass (
core/CreativeSync.php, limité à un passage toutes les 3 heures par connexion) demande à la plateforme ce que contiennent ces pubs : le hash d'image de la créa / l'id vidéo / le texte de la pub. Les bindings atterrissent danscreative_usages, les tâches de téléchargement danscreative_fetch_queue. - File worker (
cli/creative_fetch_cron.php, planifié par install.sh toutes les 5 minutes) télécharge les vrais fichiers : les originaux depuis Facebook (/act_X/adimagespar hash, source vidéo + couverture), couvertures et aperçus depuis TikTok (/file/video/ad/info/,/file/image/ad/info/). La dédup est exacte par sha256 ; les quasi-doublons se matchent par un dHash 64 bits avec un seuil de Hamming ≤6 — c'est le lien « brouillon passé en ligne » : votre brouillon téléversé à la main est lié à la copie de la plateforme au lieu de créer un doublon. - Agrégat quotidien (
core/CreativeStats.php::rebuildWindow) reconstruitcreative_dailyaprès chaque cost sync : dépense (avec les frais d'agence), impressions, clics plateforme, clics/visiteurs du tracker, installs, registrations, FTD et revenus — les métriques du tracker bucketisées dans les jours au fuseau du compte pub via la colonne indexéeclicks.ad_ref.
Le worker valide les téléchargements par signature (mp4 ftyp / webm EBML pour la vidéo, getimagesize pour les images), fait respecter les plafonds de taille (10 Mo images, 100 Mo vidéo) en interrompant le transfert en plein flux, et passe par le proxy de la connexion. Un bandeau dans l'onglet vous signale quand des fichiers attendent que le worker tourne.
L'onglet
- Filters : période (7 derniers jours par défaut), plateforme, format, tag, recherche, actifs uniquement (créas dont les pubs tournent encore), tri par dépense/revenus/ROI/clics.
- Cartes KPI sur les assets uniques — un carrousel de 3 images est une créa, sa dépense du jour répartie à parts égales sur les trois fichiers.
- ROI sans revenus = un tiret, jamais −100 % : une créa qui n'a simplement pas encore converti n'est pas une créa grillée. Couleurs : vert ≥ 30 %, ambre 0–30 %, rouge sous zéro.
- Carte créa : séries par jour (barres de dépense, marques de ROI), les pubs qui l'ont diffusée avec statuts et dépense (le drill Cabinet › Campaign › Adset), le texte de la pub, la famille de quasi-doublons, vos tags, le téléchargement.
- Les tags sont libres (
offer, geo, approach, creator) — le rapport par tag répond à « quelle approche marche mieux ».
Où les créas apparaissent ailleurs
- Campaign reports gagnent un groupement Creative (le nom du fichier au lieu d'un id d'ad nu) et une vignette d'aperçu sur les lignes d'ads.
- Campaign editor a un onglet Creatives : ce qui a porté le trafic dans cette campagne sur les 7 derniers jours, avec le ROI à l'échelle du tracker.
- Digest quotidien Telegram liste le top-3 et le pire-3 des créas du jour et déclenche une alerte burnout quand le ROI ou le CTR plateforme a chuté plus fort que le seuil (−50 % par défaut) sur les 7 derniers jours vs les 7 précédents, à dépense au-dessus du minimum (50 $ par défaut). Seuils : réglages
telegram_creative_burnout_drop_pct,telegram_creative_burnout_min_spend. - Extension Ads Manager affiche CREATIVE ROI (lifetime) à côté des colonnes quotidiennes d'une ad.
- MCP :
orbitra_creatives_top,orbitra_creative_detail. - Les assets synchronisés des plateformes sont disponibles dans le MediaPicker pour les posters PWA/landing comme n'importe quel autre fichier.
Le bandeau de santé de l'attribution
Le bandeau en haut du rapport (« Revenue linked to ads: 62% ») vient de action=revenue_attribution_health : un revenu compte comme lié quand n'importe quel paramètre de clic au niveau ad porte un vrai id de plateforme — une macro __CID__ / {{ad.id}} non remplacée compte comme manquante, même règle que les diagnostics de l'importateur de coûts. Le bouton Fix saute dans l'éditeur de la source en cause avec l'onglet des paramètres mis en évidence.
Notes
- Les fichiers vidéo TikTok ne se téléchargent pas (l'API exige des droits d'asset séparés) ; la couverture est stockée et la créa porte quand même toutes ses métriques.
- Les éléments de seconde file (extraction de texte par IA, auto-tags) ne sont volontairement pas construits pour l'instant.
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 →DocsInstallation 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 →DocsMigrer 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 →DocsMigrer 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 →DocsAperç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 →DocsCampaigns 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 →DocsCloaking
La référence complète du cloaking : couches de détection, réglages globaux, filtres par stream, verdicts et rapports.
Lire le guide →DocsBrowser check
Comment la vérification JS attrape bots, VM et émulateurs à travers les contradictions de l'environnement du navigateur.
Lire le guide →DocsLanding 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 →DocsPWA 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 →DocsFunnel 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 →DocsPopups 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 →DocsEnregistrements 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 →DocsContent 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 →DocsBibliothè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 →DocsPWA 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 →DocsPostbacks et conversions
Postbacks entrants, types de conversion et devises, postbacks S2S sortants, macros, file de livraison, testeur, import et Conversions API.
Lire le guide →DocsCoû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 →DocsRé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 →DocsFacebook / 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 →DocsDolphin / 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 →DocsNettoyage 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 →DocsSources 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 →DocsRapports, 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 →DocsDomaines et SSL
Ajouter des domaines, réglages par domaine, certificats Let's Encrypt et Cloudflare, registrars connectés et surveillance Backorder.
Lire le guide →DocsCloudflare
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 →DocsAdministration
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 →DocsBot 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 →DocsMCP : 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 →