Коротко
- Sezione Pulse → Advertising (/advertising): si collegano Google Ads, Yandex Direct e Facebook Ads (Meta).
- Il senso dell'integrazione è esportare i dati antifrode negli account, non tirare da lì spend e click in ClikBy.
- Google e Yandex: block list IP sulle campagne selezionate. Meta: segnali negativi sugli fbclid dei bot (Conversions API); il blocco IP non è disponibile.
- Servono smart link con traffico bot reale nei dati — altrimenti non c'è nulla da sincronizzare. L'app OAuth la configura l'amministratore della piattaforma.
Dove si trova nell'account
Aprite il menu Pulse → Advertising. Lì c'è l'elenco degli account ads: creare, modificare, collegare via OAuth, avviare la sincronizzazione.
Le chiavi delle app Google / Yandex / Meta le imposta l'amministratore ClikBy nelle impostazioni della piattaforma. Non dovete incollare l'App Secret nella scheda dell'account — solo l'Account ID della vostra ads e (per Meta) il Pixel ID.
L'account deve essere verified. Se il pulsante Connect indica che le credenziali della piattaforma non sono configurate — scrivete al supporto ClikBy.
Cosa dà il collegamento — e cosa no
Делает
- Google Ads — aggiunge IP di frode ai negative criteria delle campagne (fino a 500 IP per campagna); l'elenco ruota in base al threat score.
- Yandex Direct — blocca IP/sottoreti nelle campagne (fino a 25 slot per campagna; con ≥3 bot da una /24 può essere bloccata l'intera sottorete).
- Meta / Facebook Ads — invia segnali negativi via Conversions API (evento FraudDetected con fbclid delle visite bot). Le IP in Meta non vengono bloccate da questa sezione — la piattaforma ha un altro meccanismo.
Non fa
- Non importa spese, CPC, ROAS né un «bel Dashboard dell'account» dentro ClikBy.
- Non collega TikTok o LinkedIn come account ads in questa sezione (i pixel sui link sono un'altra storia).
- Non sostituisce il pixel sullo smart link e non annulla la configurazione di Smart Traffic.
La fonte dati per il sync sono le decisioni bot e le visite sui vostri link (blocked / bot_server / bot_filter). La modalità Smart Filter safe scrive would_block e non entra in questo export.
Passi comuni
Create un account
Advertising → Nuovo: nome, piattaforma, Account ID.
Collegate OAuth
Nella pagina di modifica fate clic su Connect (per Yandex — uno scenario separato con codice).
Configurate il sync
Periodo di raccolta dati frode 7/14/30 giorni, autosync ogni 6 ore se volete.
Selezionate le campagne (Google / Yandex)
Load campaigns → selezionate le campagne per il blocco IP → salvate.
Per Meta indicate il Pixel ID
E attivate l'invio di negative signals via Conversions API.
Sync now
Controllate il registro di sincronizzazione. Poi può funzionare l'autosync a orario.
Google Ads
In Account ID indicate un Customer ID del tipo XXX-XXX-XXXX (Google Ads → impostazioni account). Se l'account è sotto MCC — compilate il Manager Customer ID (MCC) quando serve all'API.
- Create un record di tipo Google Ads e salvate.
- Fate clic su Connect — si apre Google OAuth con accesso a Google Ads.
- Dopo lo stato Connected caricate le campagne e scegliete dove scrivere le esclusioni IP.
- Attivate l'autosync o fate clic su Sync now.
- Sul lato ClikBy l'amministratore deve avere Client ID/Secret e Developer Token di Google Ads API — senza developer token il collegamento non si considera completo.
- Limite: fino a 500 IP per campagna; l'elenco si aggiorna e i vecchi IP possono essere rimossi in rotazione.
Senza campaign_ids selezionati il sync IP verso Google non parte — prima Load campaigns e salvataggio della scelta.
Yandex Direct
In Account ID — il login dell'account o il Client ID (come nell'interfaccia agenzia). Nell'API parte come Client-Login.
- Create un record di tipo Yandex Direct.
- Fate clic su ottieni codice di autorizzazione — si apre oauth.yandex.ru (verification code).
- Copiate il codice e incollatelo nel modulo «Collega con codice».
- Caricate le campagne, scegliete quelle necessarie, salvate, sincronizzate.
- Fino a 25 record BlockedIps per campagna.
- Aggregazione intelligente: se da una sottorete /24 arrivano ≥3 IP bot, il sistema può bloccare l'intera sottorete (uno slot ≈ 256 indirizzi).
Se la validazione dopo il codice fallisce — verificate che l'utente OAuth abbia accesso a questo login di Yandex Direct.
Meta (Facebook Ads)
Nell'interfaccia la piattaforma si chiama Facebook Ads. Indicate l'Ad Account ID (act_… o un numero). L'utente Facebook con cui fate login OAuth deve avere accesso a questo ad account.
- Create il record → Connect → autorizzazione Meta con i diritti necessari (ads, business e scopes collegati).
- Inserite il Facebook Pixel / Dataset ID — senza di esso i segnali negativi non partono.
- Attivate l'opzione di invio negative signals via Conversions API.
- Sync now o autosync ogni 6 ore.
Come funziona: ClikBy prende l'fbclid dalle visite bot sui vostri link e invia al pixel l'evento FraudDetected (a batch). Questo aiuta l'ottimizzazione Meta — non va confuso con una IP-blacklist, che Facebook non ha in questa integrazione.
Perché compaiano fbclid, le persone devono cliccare gli annunci Meta sui link ClikBy (nell'URL di solito c'è fbclid). Senza visite bot con fbclid non c'è nulla da inviare.
Sincronizzazione
| Configurazione | Cosa fa |
|---|---|
| Autosincronizzazione ogni 6 ore | Il comando ad:sync-fraud per gli account con auto_sync e token attivo |
| Periodo di raccolta dati frode | 7 / 14 / 30 giorni — la finestra da cui si prendono IP bot e fbclid |
| Sync now | Ricalcolo manuale degli score + export di IP o segnali fbclid |
| Registro di sincronizzazione | Log oauth_connect, ip_exclusion, fbclid_exclusion, token_refresh |
I token si aggiornano in background (se scadono nei giorni successivi). Stati dell'account: Connected / Disconnected / Error.
Problemi tipici
- «Credenziali della piattaforma non configurate» — l'admin non ha ancora inserito App ID/Secret (e Developer Token per Google).
- Google Connected, ma il sync è vuoto — nessuna campagna selezionata o nessun IP bot nel periodo.
- Yandex: codice accettato, accesso non confermato — Client-Login errato o senza permessi.
- Meta: errore senza pixel_id — indicate Pixel/Dataset ID e attivate negative signals.
- Safe mode Smart Filter — le decisioni would_block non finiscono nel collettore di IP frode per il sync.
- Niente smart link / niente bot nei dati — collegare l'account da solo non cura il «silenzio».
Prima assicuratevi che il detect sui link funzioni: guida al detect. Spiegazione della frode in linguaggio semplice — здесь.