Kurz
- Bereich Pulse → Advertising (/advertising): verbunden werden Google Ads, Yandex Direct und Facebook Ads (Meta).
- Sinn der Integration ist, Antifraud-Daten in die Konten zu exportieren — nicht Spend und Klicks von dort nach ClikBy zu ziehen.
- Google und Yandex: IP-Blocklisten für ausgewählte Kampagnen. Meta: negative Signale zu Bot-fbclid (Conversions API); IP-Block ist nicht verfügbar.
- Sie brauchen Smart Links mit echtem Bot-Traffic in den Daten — sonst gibt es nichts zu synchronisieren. Die OAuth-App richtet der Plattform-Administrator ein.
Wo das im Konto liegt
Öffnen Sie das Menü Pulse → Advertising. Dort liegt die Liste der Werbekonten: anlegen, bearbeiten, per OAuth verbinden, Synchronisierung starten.
App-Keys für Google / Yandex / Meta setzt der ClikBy-Administrator in den Plattformeinstellungen. Sie müssen kein App Secret in die Kontokarte einfügen — nur die Account ID Ihrer Werbung und (für Meta) die Pixel ID.
Das Konto muss verified sein. Wenn die Connect-Schaltfläche meldet, dass Plattform-Zugangsdaten nicht eingerichtet sind — schreiben Sie an den ClikBy-Support.
Was die Verbindung bringt — und was nicht
Tut
- Google Ads — fügt Betrugs-IPs zu Negative Criteria der Kampagnen hinzu (bis 500 IP pro Kampagne); die Liste rotiert nach Threat Score.
- Yandex Direct — sperrt IP/Subnetze in Kampagnen (bis 25 Slots pro Kampagne; bei ≥3 Bots aus einem /24 kann das ganze Subnetz gesperrt werden).
- Meta / Facebook Ads — sendet negative Signale über Conversions API (Ereignis FraudDetected mit fbclid von Bot-Visits). IPs werden in Meta in diesem Bereich nicht gesperrt — die Plattform hat einen anderen Mechanismus.
Tut nicht
- Importiert keine Ausgaben, kein CPC, kein ROAS und kein «schönes Konto-Dashboard» nach ClikBy.
- Verbindet TikTok oder LinkedIn in diesem Bereich nicht als Werbekonto (Pixel auf Links sind eine andere Geschichte).
- Ersetzt das Pixel auf dem Smart Link nicht und hebt die Smart Traffic Einstellung nicht auf.
Datenquelle für den Sync sind Bot-Entscheidungen und Visits auf Ihren Links (blocked / bot_server / bot_filter). Der Modus Smart Filter safe schreibt would_block und kommt nicht in diesen Export.
Gemeinsame Schritte
Konto anlegen
Advertising → Neu: Name, Plattform, Account ID.
OAuth verbinden
Klicken Sie auf der Bearbeitungsseite auf Connect (für Yandex — ein eigener Ablauf mit Code).
Sync einrichten
Erfassungszeitraum für Betrugsdaten 7/14/30 Tage, Autosync alle 6 Stunden nach Wunsch.
Kampagnen wählen (Google / Yandex)
Load campaigns → Kampagnen für IP-Sperre markieren → speichern.
Für Meta Pixel ID angeben
Und das Senden von Negative Signals über Conversions API einschalten.
Sync now
Prüfen Sie das Sync-Protokoll. Danach kann der zeitgesteuerte Autosync laufen.
Google Ads
In Account ID geben Sie eine Customer ID der Form XXX-XXX-XXXX ein (Google Ads → Kontoeinstellungen). Liegt das Konto unter MCC — füllen Sie Manager Customer ID (MCC) aus, wenn die API das braucht.
- Legen Sie einen Datensatz vom Typ Google Ads an und speichern Sie.
- Klicken Sie auf Connect — Google OAuth öffnet sich mit Zugriff auf Google Ads.
- Nach Status Connected Kampagnen laden und wählen, wohin IP-Ausschlüsse geschrieben werden.
- Autosync einschalten oder auf Sync now klicken.
- Auf ClikBy-Seite braucht der Administrator Client ID/Secret und ein Developer Token der Google Ads API — ohne Developer Token gilt die Verbindung nicht als vollständig.
- Limit: bis 500 IP pro Kampagne; die Liste wird aktualisiert, alte IPs können bei der Rotation entfallen.
Ohne gewählte campaign_ids läuft der IP-Sync zu Google nicht — zuerst Load campaigns und Auswahl speichern.
Yandex Direct
In Account ID — Konto-Login oder Client ID (wie in der Agentur-Oberfläche). In der API geht das als Client-Login raus.
- Legen Sie einen Datensatz vom Typ Yandex Direct an.
- Klicken Sie auf Autorisierungscode holen — oauth.yandex.ru öffnet sich (verification code).
- Kopieren Sie den Code und fügen Sie ihn in das Formular «Per Code verbinden» ein.
- Kampagnen laden, die nötigen wählen, speichern, synchronisieren.
- Bis 25 BlockedIps-Einträge pro Kampagne.
- Intelligente Aggregation: kommen ≥3 Bot-IPs aus einem /24-Subnetz, kann das System das ganze Subnetz sperren (ein Slot ≈ 256 Adressen).
Schlägt die Validierung nach dem Code fehl — prüfen Sie, ob der OAuth-Nutzer Zugriff auf dieses Yandex Direct Login hat.
Meta (Facebook Ads)
In der Oberfläche heißt die Plattform Facebook Ads. Geben Sie die Ad Account ID an (act_… oder eine Zahl). Der Facebook-Nutzer, mit dem Sie sich per OAuth anmelden, muss Zugriff auf dieses Ad Account haben.
- Datensatz anlegen → Connect → Meta-Autorisierung mit den nötigen Rechten (ads, business und verbundene Scopes).
- Facebook Pixel / Dataset ID eingeben — ohne sie gehen keine negativen Signale raus.
- Option zum Senden von Negative Signals via Conversions API einschalten.
- Sync now oder Autosync alle 6 Stunden.
So funktioniert es: ClikBy nimmt fbclid von Bot-Visits auf Ihren Links und sendet das Ereignis FraudDetected an das Pixel (in Batches). Das hilft der Meta-Optimierung — nicht mit einer IP-Blacklist verwechseln, die Facebook in dieser Integration nicht hat.
Damit fbclid erscheint, müssen Menschen Meta-Anzeigen über ClikBy-Links klicken (in der URL ist meist fbclid). Ohne Bot-Visits mit fbclid gibt es nichts zu senden.
Synchronisierung
| Einrichtung | Was es tut |
|---|---|
| Autosync alle 6 Stunden | Befehl ad:sync-fraud für Konten mit auto_sync und aktivem Token |
| Erfassungszeitraum für Betrugsdaten | 7 / 14 / 30 Tage — das Fenster, aus dem Bot-IPs und fbclid stammen |
| Sync now | Manuelle Score-Neuberechnung + Export von IP- oder fbclid-Signalen |
| Sync-Protokoll | Logs oauth_connect, ip_exclusion, fbclid_exclusion, token_refresh |
Tokens werden im Hintergrund erneuert (wenn sie in den nächsten Tagen ablaufen). Kontostatus: Connected / Disconnected / Error.
Typische Probleme
- «Plattform-Zugangsdaten nicht eingerichtet» — der Admin hat App ID/Secret (und Developer Token für Google) noch nicht eingegeben.
- Google Connected, aber Sync leer — keine Kampagnen gewählt oder keine Bot-IPs im Zeitraum.
- Yandex: Code akzeptiert, Zugriff nicht bestätigt — falsches Client-Login oder keine Rechte.
- Meta: Fehler ohne pixel_id — Pixel/Dataset ID angeben und Negative Signals einschalten.
- Smart Filter Safe Mode — would_block-Entscheidungen kommen nicht in den Betrugs-IP-Sammler für den Sync.
- Keine Smart Links / keine Bots in den Daten — ein Konto zu verbinden heilt die «Stille» nicht von selbst.
Stellen Sie zuerst sicher, dass die Erkennung auf Links funktioniert: Leitfaden zur Erkennung. Erklärung von Betrug in einfacher Sprache — hier.