Коротко
- Section Pulse → Advertising (/advertising) : on y connecte Google Ads, Yandex Direct et Facebook Ads (Meta).
- Le sens de l'intégration est d'exporter les données antifraude vers les comptes, pas d'y tirer spend et clics vers ClikBy.
- Google et Yandex : listes de blocage IP sur les campagnes choisies. Meta : signaux négatifs sur les fbclid de bots (Conversions API) ; le blocage IP n'est pas disponible.
- Il faut des smart links avec du vrai trafic bot dans les données — sinon il n'y a rien à synchroniser. L'application OAuth est configurée par l'administrateur de la plateforme.
Où c'est dans le compte
Ouvrez le menu Pulse → Advertising. Vous y trouvez la liste des comptes pub : créer, modifier, connecter via OAuth, lancer la synchronisation.
Les clés d'application Google / Yandex / Meta sont définies par l'administrateur ClikBy dans les réglages de la plateforme. Vous n'avez pas à coller l'App Secret dans la fiche du compte — seulement l'Account ID de votre pub et (pour Meta) le Pixel ID.
Le compte doit être verified. Si le bouton Connect indique que les identifiants de la plateforme ne sont pas configurés — écrivez au support ClikBy.
Ce que la connexion apporte — et ce qu'elle n'apporte pas
Делает
- Google Ads — ajoute les IP de fraude aux negative criteria des campagnes (jusqu'à 500 IP par campagne) ; la liste tourne selon le threat score.
- Yandex Direct — bloque IP/sous-réseaux dans les campagnes (jusqu'à 25 emplacements par campagne ; avec ≥3 bots d'un /24, tout le sous-réseau peut partir).
- Meta / Facebook Ads — envoie des signaux négatifs via Conversions API (événement FraudDetected avec fbclid des visites bot). Les IP ne sont pas bloquées dans Meta par cette section — la plateforme a un autre mécanisme.
Ne fait pas
- N'importe pas les dépenses, le CPC, le ROAS ni un « joli Dashboard de compte » dans ClikBy.
- Ne connecte pas TikTok ou LinkedIn comme compte pub dans cette section (les pixels sur les liens sont une autre histoire).
- Ne remplace pas le pixel sur le smart link et n'annule pas le réglage Smart Traffic.
La source de données pour le sync, ce sont les décisions bot et les visites sur vos liens (blocked / bot_server / bot_filter). Le mode Smart Filter safe écrit would_block et n'entre pas dans cet export.
Étapes communes
Créez un compte
Advertising → Nouveau : nom, plateforme, Account ID.
Connectez OAuth
Sur la page d'édition, cliquez sur Connect (pour Yandex — un parcours séparé avec code).
Réglez le sync
Période de collecte des données de fraude 7/14/30 jours, autosync toutes les 6 heures si vous le souhaitez.
Choisissez les campagnes (Google / Yandex)
Load campaigns → cochez les campagnes pour le blocage IP → enregistrez.
Pour Meta, indiquez le Pixel ID
Et activez l'envoi des negative signals via Conversions API.
Sync now
Vérifiez le journal de synchronisation. Ensuite, l'autosync planifié peut tourner.
Google Ads
Dans Account ID, indiquez un Customer ID du type XXX-XXX-XXXX (Google Ads → réglages du compte). Si le compte est sous MCC — renseignez le Manager Customer ID (MCC) quand l'API l'exige.
- Créez un enregistrement de type Google Ads et enregistrez.
- Cliquez sur Connect — Google OAuth s'ouvre avec accès à Google Ads.
- Après le statut Connected, chargez les campagnes et choisissez où écrire les exclusions IP.
- Activez l'autosync ou cliquez sur Sync now.
- Côté ClikBy, l'administrateur doit avoir Client ID/Secret et un Developer Token Google Ads API — sans developer token, la connexion n'est pas considérée comme complète.
- Limite : jusqu'à 500 IP par campagne ; la liste se met à jour, les anciennes IP peuvent être retirées à la rotation.
Sans campaign_ids sélectionnés, le sync IP vers Google ne s'exécute pas — d'abord Load campaigns et enregistrement du choix.
Yandex Direct
Dans Account ID — le login du compte ou le Client ID (comme dans l'interface agence). Dans l'API, cela part comme Client-Login.
- Créez un enregistrement de type Yandex Direct.
- Cliquez sur obtention du code d'autorisation — oauth.yandex.ru s'ouvre (verification code).
- Copiez le code et collez-le dans le formulaire « Connecter par code ».
- Chargez les campagnes, choisissez celles qu'il faut, enregistrez, synchronisez.
- Jusqu'à 25 enregistrements BlockedIps par campagne.
- Agrégation intelligente : si ≥3 IP bot viennent d'un sous-réseau /24, le système peut bloquer tout le sous-réseau (un emplacement ≈ 256 adresses).
Si la validation échoue après le code — vérifiez que l'utilisateur OAuth a accès à ce login Yandex Direct.
Meta (Facebook Ads)
Dans l'interface, la plateforme s'appelle Facebook Ads. Indiquez l'Ad Account ID (act_… ou un nombre). L'utilisateur Facebook avec lequel vous vous connectez en OAuth doit avoir accès à ce ad account.
- Créez l'enregistrement → Connect → autorisation Meta avec les droits nécessaires (ads, business et scopes liés).
- Saisissez le Facebook Pixel / Dataset ID — sans lui, les signaux négatifs ne partiront pas.
- Activez l'option d'envoi des negative signals via Conversions API.
- Sync now ou autosync toutes les 6 heures.
Comment ça marche : ClikBy prend le fbclid des visites bot sur vos liens et envoie au pixel l'événement FraudDetected (par lots). Cela aide l'optimisation Meta — à ne pas confondre avec une IP-blacklist, que Facebook n'a pas dans cette intégration.
Pour que des fbclid apparaissent, les gens doivent cliquer la pub Meta via des liens ClikBy (l'URL contient en général un fbclid). Sans visites bot avec fbclid, il n'y a rien à envoyer.
Synchronisation
| Configuration | Ce que ça fait |
|---|---|
| Autosynchronisation toutes les 6 heures | La commande ad:sync-fraud pour les comptes avec auto_sync et un jeton actif |
| Période de collecte des données de fraude | 7 / 14 / 30 jours — la fenêtre d'où sont pris les IP bot et les fbclid |
| Sync now | Recalcul manuel des scores + export d'IP ou de signaux fbclid |
| Journal de synchronisation | Logs oauth_connect, ip_exclusion, fbclid_exclusion, token_refresh |
Les jetons se rafraîchissent en arrière-plan (s'ils expirent dans les prochains jours). Statuts du compte : Connected / Disconnected / Error.
Problèmes typiques
- « Identifiants de la plateforme non configurés » — l'admin n'a pas encore saisi App ID/Secret (et Developer Token pour Google).
- Google Connected, mais le sync est vide — aucune campagne choisie ou pas d'IP bot sur la période.
- Yandex : code accepté, accès non confirmé — Client-Login incorrect ou pas de droits.
- Meta : erreur sans pixel_id — indiquez le Pixel/Dataset ID et activez les negative signals.
- Safe mode Smart Filter — les décisions would_block n'entrent pas dans le collecteur d'IP de fraude pour le sync.
- Pas de smart links / pas de bots dans les données — connecter un compte ne soigne pas à lui seul le « silence ».
D'abord, vérifiez que la détection sur les liens fonctionne : guide de détection. Explication de la fraude en langage simple — здесь.