Коротко
- Sección Pulse → Advertising (/advertising): se conectan Google Ads, Yandex Direct y Facebook Ads (Meta).
- El sentido de la integración es exportar datos antifraude a las cuentas, no traer de allí spend y clics a ClikBy.
- Google y Yandex: listas de bloqueo de IP en campañas seleccionadas. Meta: señales negativas por fbclid de bots (Conversions API); el bloqueo de IP no está disponible.
- Hacen falta smart links con tráfico bot real en los datos; si no, no hay nada que sincronizar. La aplicación OAuth la configura el administrador de la plataforma.
Dónde está en la cuenta
Abra el menú Pulse → Advertising. Ahí está la lista de cuentas publicitarias: crear, editar, conectar por OAuth, iniciar la sincronización.
Las claves de las apps Google / Yandex / Meta las define el administrador de ClikBy en los ajustes de la plataforma. No tiene que pegar el App Secret en la ficha de la cuenta: solo el Account ID de su publicidad y (para Meta) el Pixel ID.
La cuenta debe estar verificada (verified). Si el botón Connect indica que las credenciales de la plataforma no están configuradas, escriba a soporte ClikBy.
Qué aporta la conexión — y qué no
Делает
- Google Ads — añade IP de fraude a los negative criteria de las campañas (hasta 500 IP por campaña); la lista rota según threat score.
- Yandex Direct — bloquea IP/subredes en campañas (hasta 25 ranuras por campaña; con ≥3 bots de una /24 puede bloquearse toda la subred).
- Meta / Facebook Ads — envía señales negativas por Conversions API (evento FraudDetected con fbclid de visitas bot). Las IP en Meta no se bloquean con esta sección: la plataforma tiene otro mecanismo.
No hace
- No importa gastos, CPC, ROAS ni un «Dashboard bonito de la cuenta» dentro de ClikBy.
- No conecta TikTok ni LinkedIn como cuenta publicitaria en esta sección (los píxeles en los enlaces son otra historia).
- No sustituye el píxel en el smart link ni cancela la configuración de Smart Traffic.
La fuente de datos para el sync son las decisiones bot y las visitas a sus enlaces (blocked / bot_server / bot_filter). El modo Smart Filter safe escribe would_block y no entra en esta exportación.
Pasos comunes
Cree una cuenta
Advertising → Nuevo: nombre, plataforma, Account ID.
Conecte OAuth
En la página de edición, haga clic en Connect (para Yandex, un flujo aparte con código).
Configure el sync
Periodo de recogida de datos de fraude 7/14/30 días; autosincronización cada 6 horas si lo desea.
Seleccione campañas (Google / Yandex)
Load campaigns → marque las campañas para bloqueo de IP → guarde.
Para Meta, indique el Pixel ID
Y active el envío de negative signals por Conversions API.
Sync now
Revise el registro de sincronización. Luego puede funcionar el autosync programado.
Google Ads
En Account ID indique un Customer ID del tipo XXX-XXX-XXXX (Google Ads → ajustes de la cuenta). Si la cuenta está bajo MCC, complete el Manager Customer ID (MCC) cuando lo pida la API.
- Cree un registro de tipo Google Ads y guarde.
- Haga clic en Connect: se abre Google OAuth con acceso a Google Ads.
- Tras el estado Connected, cargue las campañas y elija dónde escribir las exclusiones de IP.
- Active el autosync o haga clic en Sync now.
- En el lado ClikBy el administrador debe tener Client ID/Secret y Developer Token de Google Ads API; sin developer token la conexión no se considera completa.
- Límite: hasta 500 IP por campaña; la lista se actualiza y las IP antiguas pueden quitarse en la rotación.
Sin campaign_ids seleccionados, el sync de IP a Google no se ejecutará: primero Load campaigns y guardar la selección.
Yandex Direct
En Account ID: el login de la cuenta o el Client ID (como en la interfaz de agencia). En la API se envía como Client-Login.
- Cree un registro de tipo Yandex Direct.
- Haga clic en obtener código de autorización: se abre oauth.yandex.ru (verification code).
- Copie el código y péguelo en el formulario «Conectar por código».
- Cargue las campañas, elija las necesarias, guarde, sincronice.
- Hasta 25 registros BlockedIps por campaña.
- Agregación inteligente: si de una subred /24 llegan ≥3 IP bot, el sistema puede bloquear toda la subred (una ranura ≈ 256 direcciones).
Si la validación falla después del código, compruebe que el usuario OAuth tiene acceso a ese login de Yandex Direct.
Meta (Facebook Ads)
En la interfaz la plataforma se llama Facebook Ads. Indique el Ad Account ID (act_… o un número). El usuario de Facebook con el que inicia OAuth debe tener acceso a ese ad account.
- Cree el registro → Connect → autorización Meta con los permisos necesarios (ads, business y scopes relacionados).
- Introduzca el Facebook Pixel / Dataset ID: sin él no saldrán las señales negativas.
- Active la opción de envío de negative signals via Conversions API.
- Sync now o autosync cada 6 horas.
Cómo funciona: ClikBy toma el fbclid de las visitas bot a sus enlaces y envía al píxel el evento FraudDetected (en lotes). Esto ayuda a la optimización de Meta: no lo confunda con una IP-blacklist, que Facebook no tiene en esta integración.
Para que aparezcan fbclid, la gente debe hacer clic en anuncios Meta por enlaces ClikBy (en la URL suele haber fbclid). Sin visitas bot con fbclid no hay nada que enviar.
Sincronización
| Configuración | Qué hace |
|---|---|
| Autosincronización cada 6 horas | El comando ad:sync-fraud para cuentas con auto_sync y token activo |
| Periodo de recogida de datos de fraude | 7 / 14 / 30 días: la ventana de la que se toman IP bot y fbclid |
| Sync now | Recálculo manual de scores + exportación de IP o señales fbclid |
| Registro de sincronización | Logs oauth_connect, ip_exclusion, fbclid_exclusion, token_refresh |
Los tokens se renuevan en segundo plano (si caducan en los próximos días). Estados de la cuenta: Connected / Disconnected / Error.
Problemas típicos
- «Las credenciales de la plataforma no están configuradas»: el admin aún no ha introducido App ID/Secret (ni Developer Token para Google).
- Google Connected, pero el sync está vacío: no hay campañas seleccionadas o no hay IP bot en el periodo.
- Yandex: código aceptado, acceso no confirmado: Client-Login incorrecto o sin permisos.
- Meta: error sin pixel_id: indique Pixel/Dataset ID y active negative signals.
- Safe mode Smart Filter: las decisiones would_block no entran en el recolector de IP de fraude para el sync.
- No hay smart links / no hay bots en los datos: conectar la cuenta por sí sola no cura el «silencio».
Primero asegúrese de que la detección en los enlaces funciona: guía de detección. Explicación del fraude en lenguaje sencillo: здесь.