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.

Getrennt von Meta Ads zieht der Facebook-&-Instagram-Connector ORGANISCHE Page- und Instagram-Metriken – wie deine Beiträge, deine Reichweite und deine Audience laufen, nicht deine bezahlten Kampagnen. Klick unter Daten → Integrationen auf der Facebook-&-Instagram-Karte auf Verbinden, autorisiere über Facebook Login for Business mit einem Nutzer, der eine Rolle auf der Seite hat, hake im Zustimmungsschritt die Seite (und das verknüpfte Instagram-Business-Konto) an und weise sie einem Kunden zu. Es ist eine eigene Verbindung, getrennt von der Meta-Ads-Verbindung – du kannst also die eine widerrufen, ohne die andere anzutasten –, und sie gewährt nur Lesezugriff. Die Instagram-Daten sind die reichhaltigere Hälfte: Aufrufe, Reichweite, Interaktionen, Likes, Kommentare, geteilte Inhalte, Saves und Follower-Zahl, dazu deine letzten Medien. Weil Instagram eine Insights-Abfrage auf 30 Tage begrenzt, werden Reichweite und erreichte Konten als jüngstes 30-Tage-Fenster ausgewiesen und mit „(30 T.)“ gekennzeichnet, damit sie nie mit einem Zeitraum-Gesamtwert verwechselt werden. Die Facebook-Page-Daten umfassen Seitenaufrufe, Reichweite, Beitrags-Interaktionen, Follows, neue Follows und Videoaufrufe, die aktuelle Follower-Zahl sowie deine letzten Beiträge mit Likes, Kommentaren und geteilten Inhalten. Page-Metriken sind zeitraumgebunden – eine Seite, die zuletzt nichts gepostet hat, zeigt über einen kurzen Zeitraum wenig; wähle einen Zeitraum, der echte Posting-Aktivität abdeckt, damit sich die Zahlen füllen. Jede Metrik, die ein Konto nicht liefert, zeigt einen Gedankenstrich – nie eine erfundene Null. Zwei ehrliche Hinweise. Erstens tragen organische Metriken keine Werbeausgaben, deshalb ist dieser Connector bewusst aus kanalübergreifenden Ausgaben-Mischungen und „Alle Kanäle“-Summen herausgehalten – organische Reichweite in bezahlte Ausgaben zu mischen würde beide verzerren. Zweitens erfordert das Auslesen von Text und Interaktionen einzelner Facebook-Page-Beiträge (die Tabelle „Top-Facebook-Beiträge“) Metas Advanced Access für die Berechtigung pages_read_engagement, die durch Metas App Review läuft; Instagram, die Facebook-Page-Insights und die Follower-Zahl funktionieren auch ohne sie.

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. Die verfügbaren Metriken decken alles ab, was Reddits Reporting-API liefert: Auslieferung (Impressionen, Klicks, Ausgaben, CTR, Ø CPC, eCPM, Reichweite, Frequenz), Conversions gesamt (Conversions, Conversion-Rate, ROAS, Conversion-Wert) und pro Pixel-Event — Käufe mit Wert, Stückzahl, Kosten pro Kauf und Kauf-ROAS, Registrierungen, Pixel-Leads, In-den-Warenkorb, Seitenbesuche, Content-Aufrufe, Suchen und Schlüssel-Conversions — App-Install-Kampagnen (Installationen, Kosten pro Install, App-Umsatz und -ROAS) sowie Video-Tiefe (Aufrufe, 3/5/10 s, 25/50/75/95/100 %, sichtbare Impressionen, erweiterte Wiedergaben und Abschlussrate, inklusive eines Video-Funnel-Widgets) — aufgeschlüsselt im Zeitverlauf oder nach Kampagne, Anzeigengruppe, Anzeige, Community, Platzierung, Geo, Gerät, Geschlecht, Interesse oder Keyword. Ein ehrliches Detail: Nicht jedes Konto liefert jedes Conversion-Feld — CrunchJunkie fragt das beim ersten Abruf die API selbst, und Metriken, die dein Konto nicht liefert, zeigen einen Gedankenstrich statt einer erfundenen Null. 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.

ChatGPT Ads (die Werbeplattform von OpenAI) verbindet sich mit einem Konto-API-Key statt über OAuth. Erstelle im OpenAI Ads Manager unter Einstellungen → API Keys einen Key – er ist auf ein einzelnes Werbekonto beschränkt. Öffne in CrunchJunkie Daten → Integrationen, klick auf der ChatGPT-Ads-Karte auf Verbinden, wähle den Kunden und füge den Key ein. CrunchJunkie prüft ihn gegen das Konto, speichert ihn verschlüsselt und liest ausschließlich die Reporting-Daten dieses Kontos; die Daten aktualisieren sich täglich wie bei jeder anderen Quelle. Die verfügbaren Metriken decken Auslieferung und Effizienz ab – Impressionen, Klicks, Ausgaben, CTR, Ø CPC und CPM – dazu Conversions, Kosten pro Conversion und Conversion-Rate, aufgeschlüsselt nach Kampagne, Land, Gerät oder Produkt oder im Zeitverlauf. Zwei ehrliche Details speziell zu dieser API: Conversions werden auf Kampagnenebene gemeldet (nicht pro Tag), sie erscheinen also auf Scorecards und in der Kampagnentabelle, zeigen im Tagesdiagramm sowie bei den Aufschlüsselungen nach Land/Gerät/Produkt aber einen Gedankenstrich statt einer erfundenen Null; und OpenAIs API liefert keinen Conversion-Wert, es gibt daher keinen ROAS – der Connector erfindet keinen. Beträge werden in der Kontowährung angezeigt. Wenn du einen Bericht mit KI entwirfst, steuert ein verbundenes ChatGPT-Ads-Konto automatisch eine Scorecard mit den Kernmetriken und ein Diagramm zu Ausgaben und Klicks im Zeitverlauf bei – und fließt neben deinen anderen Paid-Quellen in die kanalübergreifenden Vergleiche ein (Ausgaben, Impressionen, Klicks und Conversions).

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.

Das Google Unternehmensprofil (früher Google My Business) bringt die Performance deines lokalen Eintrags in die Berichte – wie Kundinnen und Kunden dein Unternehmensprofil in der Google-Suche und in Google Maps finden und darauf reagieren. Es nutzt dieselbe Google-Anmeldung wie GA4, Search Console und Merchant Center, das Verbinden ist also ein Klick: Klick auf der Karte „Google Business“ unter Daten → Integrationen auf Verbinden, autorisiere mit Google und lass die Berechtigung für das Unternehmensprofil auf dem Zustimmungsbildschirm angehakt (sonst kann CrunchJunkie deinen Eintrag nicht lesen). Der Zugriff erfolgt ausschließlich lesend. Danach wählst du den Standort aus, über den berichtet werden soll, und weist ihn einem Kunden zu – Konten mit mehreren Standorten und Agenturkonten listen jeden verwalteten Standort auf. Verfügbare Metriken: Impressionen aufgeschlüsselt nach Oberfläche und Gerät (Google-Suche vs. Maps, Desktop vs. Mobil) sowie Kundenaktionen – Anrufe, Website-Klicks, Routenanfragen, Nachrichten, Buchungen sowie Bestellungen/Menü-Klicks bei Restaurants – im Zeitverlauf oder als KPIs summiert. Eine Tabelle „Top-Suchbegriffe“ zeigt die Suchanfragen, mit denen Menschen den Eintrag tatsächlich gefunden haben (das sind Monatsdaten, und Google fasst Begriffe mit geringem Volumen als „≥N“ zusammen statt als exakte Zahl – das zeigen wir ehrlich so an). Bewertungen und Durchschnittsbewertung kommen ebenfalls als KPIs. Zwei Ehrlichkeitshinweise: Die Performance-Daten des Unternehmensprofils hinken der Echtzeit auf Google-Seite um etwa zwei bis drei Tage hinterher, und Bewertungen / Durchschnittsbewertung sind die aktuellen Gesamtwerte des Standorts, keine Summe über den Berichtszeitraum. Wie jede Quelle fließt das Google Unternehmensprofil in „Mit KI entwerfen“, den Bericht-Builder, geteilte Links und PDF-Exporte ein und aktualisiert sich täglich. Es ist ein organischer, lokaler Präsenzkanal ohne Werbeausgaben und wird deshalb bewusst aus den kanalübergreifenden „Alle Kanäle“-Summen der Paid-Kanäle herausgehalten (eine Quelle ohne Spend würde dort CPC und ROAS verzerren) – du berichtest darüber in einem eigenen Abschnitt, genau wie beim organischen Connector für Facebook & Instagram.

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.