Integrationen

Die meisten Integrationen laufen über OAuth – denselben sicheren Standard, den du von „Weiter mit Google“ kennst. Du klickst auf Verbinden, autorisierst auf dem Bildschirm des Anbieters, und CrunchJunkie erhält ein eingeschränktes, jederzeit widerrufbares Zugriffstoken – niemals dein Passwort. Ein paar selbst gehostete Analytics-Tools (Matomo und Piwik PRO) funktionieren etwas anders: Statt eines OAuth-Redirects fügst du die URL deiner eigenen Instanz plus einen API-Token mit Lesezugriff ein. In beiden Fällen gilt: Die Zugangsdaten werden verschlüsselt gespeichert, gewähren ausschließlich Lesezugriff und lassen sich beim Anbieter jederzeit widerrufen. Nach dem Verbinden wählst du aus, welche Konten, Properties oder Websites importiert werden sollen. Die erste Synchronisierung startet sofort, danach aktualisieren sich die Daten automatisch einmal täglich. Unter Daten → Integrationen siehst du den Status jeder einzelnen Verbindung – so weißt du jederzeit, dass deine Daten aktuell sind.

Für Google Ads klickst du auf der Google-Ads-Karte auf Verbinden und autorisierst mit dem Google-Konto, das Zugriff auf die betreffenden Werbekonten hat. Wenn du Kunden über ein MCC verwaltest, kannst du einzelne Konten darunter auswählen – importiere nur die, über die du wirklich berichtest. GA4 läuft genauso: mit Google autorisieren und dann gezielt die Properties auswählen, die du brauchst. Beide Integrationen setzen voraus, dass der Google-Nutzer, mit dem du autorisierst, mindestens Lesezugriff auf die Konten bzw. Properties hat. Taucht ein Konto in der Auswahlliste nicht auf, liegt es fast immer an fehlenden Berechtigungen auf Google-Seite – und nicht an CrunchJunkie.

Meta Ads verbindet sich über Facebook Login. Autorisiere mit einem Nutzer, der eine Rolle im betreffenden Business Manager und in den Werbekonten hat, und wähle anschließend die Werbekonten aus, die importiert werden sollen. Da Meta in regelmäßigen Abständen eine erneute Autorisierung verlangt, überwacht CrunchJunkie die Gültigkeit des Tokens und warnt dich, bevor eine Verbindung ausläuft. LinkedIn Ads folgt demselben OAuth-Ablauf. Autorisiere mit einem Konto, das Zugriff auf die Campaign-Manager-Werbekonten hat, über die du berichtest, und wähle sie bei der Einrichtung aus. Wie bei jeder Integration gibst du ausschließlich Lesezugriff frei – CrunchJunkie nimmt nie Änderungen an deinen Kampagnen vor.

Microsoft Ads (Bing), TikTok Ads und die Google Search Console verbindest du jeweils mit einem einzigen OAuth-Klick auf ihrer Karte unter Daten → Integrationen. Bei Microsoft Ads und TikTok autorisierst du mit einem Nutzer, der Zugriff auf die Werbekonten hat, und wählst aus, welche importiert werden. Die Search Console verbindest du über Google und wählst dann die bestätigten Properties, deren organische Suchdaten in deinen Berichten landen sollen. Alle drei aktualisieren sich täglich zusammen mit deinen übrigen Quellen und erscheinen in derselben Statusübersicht – du verwaltest deinen kompletten Stack also von einem Bildschirm aus.

Amazon Ads verbindet sich über OAuth (Login with Amazon) und zieht das Sponsored-Products-Reporting mit reinem Lesezugriff. Weil Amazons API nach Regionen getrennt ist, wählst du beim Verbinden die Marketplace-Region des Advertisers. So verbindest du: 1. Stell sicher, dass der Kunde, für den du berichtest, unter Kunden existiert (du weist die Verbindung ihm zu). 2. Öffne Daten → Integrationen und klick auf der Amazon-Ads-Karte auf Verbinden. 3. Wähle die Marketplace-Region des Advertisers – Europa (EU), Nordamerika (NA) oder Ferner Osten (FE). Sie muss zu dem Standort passen, an dem das Werbekonto registriert ist. 4. Melde dich per Login with Amazon mit einem Amazon-Nutzer an, der Zugriff auf das Konto des Advertisers hat, und bestätige den Lesezugriff. 5. Wähle das genaue Werbeprofil (Advertiser-Konto) für den Import aus und weise es dem Kunden zu. Die erste Synchronisierung startet sofort, danach aktualisieren sich die Daten täglich. Damit du über das Konto eines Kunden berichten kannst, fügt der Kunde entweder deinen Amazon-Nutzer (mit Viewer-/Reporting-Zugriff) in seiner Amazon-Ads-Konsole hinzu, oder er autorisiert die Verbindung in Schritt 4 selbst. Verfügbar sind Daten zu Sponsored Products über Kampagnen, Anzeigengruppen, Keywords/Targeting, Suchbegriffe von Kunden sowie beworbene vs. gekaufte Produkte – mit Metriken wie Impressionen, Klicks, Ausgaben, CTR, Ø CPC, CPM, Bestellungen, Umsatz, Einheiten, ACOS und ROAS. Amazon erzeugt seine Berichte asynchron, deshalb kann der erste Aufbau einer Aufschlüsselung einen Moment dauern. Noch nicht enthalten: Sponsored Brands, Sponsored Display und Amazon DSP (Streaming/OTT-Video, inklusive Twitch) – DSP braucht eine separate Freigabe von Amazon, über den Standard-API-Zugang hinaus. Und eine Anmerkung, falls beim Verbinden einmal ein „bad scope“-Fehler auftaucht: Dann ist das Login-with-Amazon-Profil noch nicht mit einem freigegebenen Amazon-Ads-API-Zugang verknüpft – das ist ein Zustand deines Amazon-Kontos, kein Problem von CrunchJunkie.

Reddit Ads verbindet sich über OAuth und zieht das Kampagnen-Reporting mit reinem Lesezugriff. Klick unter Daten → Integrationen auf der Reddit-Ads-Karte auf Verbinden, autorisiere mit einem Reddit-Nutzer, der Zugriff auf das Ads-Konto des Advertisers hat, wähle dann das zu importierende Werbekonto aus und weise es einem Kunden zu. Die Zugangsdaten werden verschlüsselt gespeichert, gewähren nur Lesezugriff und lassen sich bei Reddit jederzeit widerrufen; die Daten aktualisieren sich täglich wie bei jeder anderen Quelle. Zu den verfügbaren Metriken zählen Impressionen, Klicks, Ausgaben, CTR, Ø CPC, eCPM, Reichweite, Frequenz, Conversions, Conversion-Rate, ROAS und Conversion-Wert – dazu Reddit-spezifisches Engagement: Videoaufrufe und Quartil-Abschlüsse (3 s, 25/50/75/100 % sowie Abschlussrate) und Upvotes/Downvotes auf Kommentare, aufgeschlüsselt im Zeitverlauf oder nach Kampagne. Wenn du einen Bericht mit KI entwirfst, steuert ein verbundenes Reddit-Konto automatisch eine Scorecard mit den Kernmetriken und ein Diagramm zu Ausgaben und Conversions im Zeitverlauf bei – und fließt neben deinen anderen Paid-Quellen in die kanalübergreifenden Vergleiche ein.

Matomo nutzt kein OAuth – jede Matomo-Instanz läuft selbst gehostet oder in der Matomo Cloud, deshalb verbindest du sie mit deiner Instanz-URL und einem API-Token mit Lesezugriff (Matomo nennt das „token_auth“). Das funktioniert mit Matomo Cloud ebenso wie mit selbst gehostetem Matomo 4 und 5. Erstell zuerst den Token in Matomo. Melde dich mit einem Nutzer an, der mindestens View-Zugriff auf die Website hat, über die du berichten willst (ein reiner View-Nutzer hält den Token strikt lesend), und geh dann auf das Zahnrad (Administration) → Persönlich → Sicherheit → Auth-Tokens → „Neuen Token erstellen“. Bestätige dein Passwort, gib dem Token eine Beschreibung wie „CrunchJunkie“ und erstelle ihn. Matomo zeigt den Token nur ein einziges Mal an – kopier ihn also sofort. „Nur sichere Anfragen zulassen“ kannst du aktiviert lassen: CrunchJunkie sendet den Token im Request-Body, was diese Einstellung erfüllt. Dann verbindest du ihn in CrunchJunkie. Öffne Daten → Integrationen und klick auf der Matomo-Karte auf Verbinden. Füge deine Instanz-URL ein – die Adresse vor /index.php, zum Beispiel https://yourcompany.matomo.cloud – dazu den token_auth, und klick auf Verbinden. CrunchJunkie prüft die Zugangsdaten sofort und listet die Websites auf, die der Token sehen kann. Wähle die gewünschte Website aus und weise sie einem Kunden zu. Der Token wird verschlüsselt gespeichert, der Zugriff bleibt lesend, und die Daten aktualisieren sich täglich wie bei jeder anderen Quelle. Zum Rotieren oder Entziehen löschst du den Token später einfach in Matomo (Administration → Persönlich → Sicherheit → Auth-Tokens) und verbindest mit einem neuen. Zu den verfügbaren Metriken zählen Besuche, Eindeutige Besucher (ca.), Aktionen, Aktionen/Besuch, Absprungrate, Conversions, Conversion-Rate und Umsatz – im Zeitverlauf oder aufgeschlüsselt nach Kanal, Quelle, Kampagne, Land/Region/Stadt, Gerät, Browser, Betriebssystem, Top-/Einstiegs-/Ausstiegsseiten und Zielen. Eine Anmerkung zur Genauigkeit: „Eindeutige Besucher (ca.)“ heißt bewusst so. Matomo kann für einen mehrtägigen Zeitraum keine echte Zahl eindeutiger Besucher liefern, deshalb summiert CrunchJunkie bei Zeiträumen über einen Tag die Tageswerte – wer an mehreren Tagen da war, wird dadurch leicht doppelt gezählt. Werte für einzelne Tage sind exakt, und jede andere Metrik (Besuche, Aktionen, Absprungrate, Conversions, Umsatz) ist über jeden Zeitraum exakt.

Piwik PRO verbindet sich ebenfalls über Zugangsdaten statt über OAuth, und zwar per Client-Credentials-Grant seiner API. Das funktioniert mit Piwik PRO Cloud und mit On-Premises-Instanzen. Erstell zuerst einen API-Client in Piwik PRO. Öffne als Admin Einstellungen → API (Administration) und leg neue API-Zugangsdaten an – Piwik PRO erzeugt eine Client-ID und ein Client Secret. Die beiden wirken wie ein eingeschränkter, widerrufbarer Schlüssel für den Lesezugriff auf deine Analytics-Daten. Dann verbindest du sie in CrunchJunkie. Öffne Daten → Integrationen und klick auf der Piwik-PRO-Karte auf Verbinden. Füge deine Instanz-URL ein – deine Piwik-PRO-Adresse, zum Beispiel https://yourorg.piwik.pro – zusammen mit Client-ID und Client Secret, und klick auf Verbinden. CrunchJunkie authentifiziert sich sofort, listet die Apps (Websites) auf, auf die die Zugangsdaten Zugriff haben, und du wählst eine davon aus und weist sie einem Kunden zu. Zugangsdaten werden verschlüsselt gespeichert; wir erzeugen pro Anfrage einen kurzlebigen Token, es wird also nichts Langlebiges aufbewahrt. Zu den verfügbaren Metriken zählen Sitzungen, Besucher, Seitenaufrufe, Eindeutige Seitenaufrufe, Seiten/Sitzung, Absprungrate, Ziel-Conversions und Conversion-Rate – im Zeitverlauf oder aufgeschlüsselt nach Kanal, Quelle, Quelle/Medium, Kampagne, Keyword, Land/Region/Stadt, Gerät, Browser, Betriebssystem sowie Top-/Einstiegs-/Ausstiegsseiten. Die Berichte respektieren das „Scope“-Modell von Piwik PRO: Aufschlüsselungen auf Sitzungsebene (Kanäle, Geo, Geräte) und auf Seitenebene (Top-Seiten) nutzen jeweils die Metriken, die zu diesem Scope gehören – so bleiben die Zahlen konsistent. Beachte außerdem: Piwik-PRO-Daten haben rund zwei Stunden Verarbeitungsverzögerung, der aktuelle Tag füllt sich also meist noch auf.

Unter Daten → Integrationen sind auch die Plattformen gelistet, die wir als Nächstes bauen – markiert mit „Bald verfügbar“, damit du siehst, wohin die Roadmap läuft: Pinterest Ads, Snapchat Ads, X (Twitter) Ads, Shopify, Klaviyo, HubSpot, Mailchimp, Criteo, Taboola und Outbrain. Das sind Platzhalter, die Nachfrage einsammeln – noch keine fertigen Connectoren. Du kannst sie heute also weder verbinden noch Daten daraus ziehen, und sie tauchen auch in „Mit KI entwerfen“ nicht auf. Wenn eine davon für dein Reporting wichtig ist, sag uns Bescheid – das hilft uns bei der Priorisierung. Wir kündigen jede im Changelog an, sobald sie live geht.

CrunchJunkie überwacht deine Verbindungen, damit du es nicht tun musst. Sobald etwas deinen Eingriff braucht, erscheint es im Bereich „Braucht Aufmerksamkeit“ – und zwar bevor ein Bericht mit einer Lücke rausgeht, nicht erst wenn ein Kunde sie bemerkt. Zwei Arten von Hinweisen tauchen hier auf. Der erste ist die Aufforderung, neu zu verbinden: Läuft ein Token ab oder wird es vom Anbieter entzogen (oft nach einer Passwortänderung, einer entfernten Berechtigung oder Metas regelmäßiger Neuautorisierung), wird die betroffene Integration mit einem Banner zum Neuverbinden markiert. Ein Klick führt dich zurück durch OAuth, und die tägliche Synchronisierung läuft weiter. Der zweite betrifft einen fehlgeschlagenen eigenen KI-Schlüssel: Wenn du KI-Sichtbarkeit auf deinen eigenen Anbieter-Schlüsseln laufen lässt und ein Schlüssel nicht mehr funktioniert – abgelaufen, Kontingent aufgebraucht oder beim Anbieter widerrufen –, wird auch dieser Fehler hier gemeldet, damit ein still gescheiterter Scan nie unbemerkt bleibt. Du löst den Hinweis auf, indem du die Quelle neu verbindest oder den Schlüssel aktualisierst; beim nächsten erfolgreichen Sync oder Scan verschwindet die Markierung.

Die meisten Probleme haben eine von drei Ursachen. Erstens abgelaufene oder entzogene Tokens: Wenn ein Anbieter ein Token ungültig macht (oft nach einer Passwortänderung oder einer Berechtigungsänderung auf seiner Seite), siehst du ein Banner zum Neuverbinden – ein Klick und eine erneute Autorisierung stellen die Verbindung wieder her. Zweitens fehlende Berechtigungen: Taucht ein Konto oder eine Property bei der Einrichtung nicht auf, prüf, ob der Nutzer, mit dem du autorisiert hast, auf der Plattform des Anbieters mindestens Lesezugriff darauf hat. Drittens eine veraltete Synchronisierung: Wenn Zahlen nicht mehr aktuell wirken, schau unter Daten → Integrationen auf den Zeitpunkt der letzten Synchronisierung – du kannst manuell aktualisieren, statt auf den täglichen Lauf zu warten. Wenn eine Verbindung auch nach dem Neuverbinden und geprüften Berechtigungen nicht will, schreib dem Support an hello@crunchjunkie.io – mit dem Namen des Workspace und der betroffenen Integration. Ein echter Mensch hilft dir weiter.