Doku

Integrationen

Verbinde deine Werbeplattformen und Analytics-Tools – und bring eine hakende Verbindung schnell wieder zum Laufen.

So funktioniert das Verbinden

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 Tools funktionieren etwas anders: Bei den selbst gehosteten Analytics-Tools (Matomo und Piwik PRO) fügst du die URL deiner eigenen Instanz plus einen API-Token mit Lesezugriff ein, bei Brevo und ChatGPT Ads einen API-Key des jeweiligen Kontos, Mailchimp entweder die eigene Anmeldung (OAuth) oder einen Schlüssel. In allen 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. Wenn du eine Datenquelle trennst, werden die darüber importierten Zahlen gelöscht, und das gespeicherte Token, sobald nichts anderes in deinem Workspace denselben Login nutzt. Eine Anmeldung kann mehrere Konten und Kunden versorgen, das Token bleibt also, bis die letzte davon getrennt ist; ein Merchant-Center-Login bleibt außerdem, solange dein AI-Shopping-Katalog darüber importiert. Tokens von Reddit Ads werden zusätzlich bei Reddit widerrufen. Google- und Meta-Tokens werden nur bei uns gelöscht, denn ein Widerruf bei Google oder Meta beendet jede Verbindung, die dieselbe Person mit diesem Login hergestellt hat; um den Zugriff auch dort zu entziehen, entferne CrunchJunkie in den Einstellungen des jeweiligen Kontos.

Google Ads und GA4

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. Verliert dieser Nutzer später den Zugriff auf ein Konto (aus dem Verwaltungskonto entfernt oder das Konto gekündigt), zeigen dessen Berichts-Widgets „Kein Zugriff“ statt Zahlen, und der Bericht zeigt nach der nächsten täglichen Prüfung ein Banner. Ist der Zugriff wieder erteilt, kann es pro Server bis zu 10 Minuten dauern, bis die Zahlen zurück sind; das Banner verschwindet nach der nächsten täglichen Prüfung. Geteilte Links, der Präsentationsmodus und die PDFs, die CrunchJunkie erzeugt, zeigen ein solches Widget als „Daten nicht verfügbar“, ohne Konto oder Grund. Schlägt die PDF-Erzeugung fehl und die Berichtsseite weicht auf den Druck deines Browsers aus, zeigt dieses PDF stattdessen die Formulierung für dein Team. Eine KI-Zusammenfassung vermerkt nur, für wie viele Konten Daten fehlen. Über die REST-API kommt das Widget als null zurück, und meta.unavailable nennt den Grund (no_access oder error) und Googles Code; das MCP-Tool get_report_data liefert dasselbe unter _meta.unavailable. Bei GA4 gilt dasselbe, wenn ein Bericht gar nicht antwortet: Eine ausgelastete Property wird ein paarmal neu angefragt, und ein Widget, auf das Google trotzdem nicht antwortet, zeigt „Nicht geladen“ (geteilte Links und PDFs: „Daten nicht verfügbar“), nie 0. Matomo, Merchant Center und Brevo machen es genauso, wenn ihr Hauptabruf fehlschlägt. Seit dem 9. Oktober 2026 gilt das auch für die Tabellen und Ringdiagramme von Meta Ads, Microsoft Ads, Amazon Ads, Reddit Ads, ChatGPT Ads, Piwik PRO, Mailchimp, Business Profile, Bing Webmaster Tools und Search Console: Ein fehlgeschlagener Abruf zeigt „Nicht geladen“, oder „Kein Zugriff“, wenn die Plattform das Konto verweigert hat, statt „Keine Daten für diesen Zeitraum“. Dasselbe gilt für KPIs und Diagramme aus Business Profile, die bei einem fehlgeschlagenen Abruf von Google bisher ganz aus dem Bericht fielen, und für den Video-Funnel von Reddit Ads. Eine Business-Profile-KPI, deren Bewertungsabruf geantwortet hat, während die Tageswerte fehlschlugen, behält ihre Bewertungszahlen und zeigt für den Rest „—“; ein fehlgeschlagener Vergleichszeitraum bedeutet keine Vorwerte statt einer Veränderung gegenüber 0, und die Durchschnittsbewertung eines Standorts ohne Bewertungen ist „—“, nicht 0. Schlägt nur ein zweiter Abruf fehl (die Ziele aus Matomo, der Leistungsbericht im Merchant Center, die Umsatzzuordnung von Brevo), zeigen die Zahlen, die darauf beruhen, „—“, und der Rest des Widgets bleibt. Eine Rate ohne Grundlage, etwa Kosten pro Conversion ohne Conversions oder eine CTR ohne Impressionen, ist ebenfalls „—“.

Meta und LinkedIn

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. Einmal am Tag prüft es außerdem jedes verbundene Meta-Werbekonto darauf, ob es nicht mehr ausliefert (siehe Signale & Automatisierungen). 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.

Facebook & Instagram (organisch)

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 eindeutige Konten über höchstens 30 Tage zählt, werden Reichweite und erreichte Konten einmal über die letzten 30 Tage des Berichtszeitraums gelesen (über den ganzen Zeitraum, wenn er kürzer ist), mit „(30 Tage)“ gekennzeichnet, und die Scorecard nennt diese Tage; schlägt dieses Lesen fehl, steht ein Gedankenstrich, nie der Wert eines älteren Fensters. 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. Die Seitenreichweite ist eine tägliche Zahl eindeutiger Personen: Das Diagramm zeigt die Reichweite je Tag, eine Scorecard über mehr als einen Tag zeigt dagegen einen Gedankenstrich mit Begründung, weil sich dieselben Personen, die an mehreren Tagen erreicht wurden, nicht addieren lassen (Seitenaufrufe lassen sich addieren). 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 und Search Console

Microsoft Ads (Bing) und die Google Search Console verbindest du jeweils mit einem einzigen OAuth-Klick auf ihrer Karte unter Daten → Integrationen. Bei Microsoft Ads 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. Beide 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.

Bing Webmaster Tools

Die Bing Webmaster Tools verbindest du mit einer Microsoft-Anmeldung (OAuth) und reinem Lesezugriff: CrunchJunkie bittet Bing um die Berechtigung webmaster.read, nie um das Recht, etwas zu ändern, und nie um einen API-Key. Klick unter Daten → Integrationen auf der Karte Bing Webmaster Tools auf Verbinden, melde dich mit dem Microsoft-Konto an, unter dem deine Websites in den Bing Webmaster Tools liegen, und erlaube den Zugriff. Danach hakst du eine oder mehrere Websites an und wählst den Kunden, zu dem sie gehören. Nur in den Bing Webmaster Tools bestätigte Websites liefern Daten; eine nicht bestätigte Website wird angezeigt, lässt sich aber nicht auswählen. Jedes Mitglied des Workspace kann verbinden, ein Platz mit Lesezugriff nicht. Lehnt Bing die gespeicherte Anmeldung einmal ab, zeigt die Verbindung „Handlungsbedarf“, und ein erneutes Verbinden mit demselben Microsoft-Konto holt jeden Kunden zurück, der es nutzt. Um den Zugriff bei Bing zu entziehen, entferne CrunchJunkie unter Bing Webmaster Tools → Einstellungen → API-Zugriff. Worüber du berichten kannst: Klicks, Impressionen und CTR pro Tag für die ganze Website; die Top-Suchanfragen und Top-Seiten mit Klicks, Impressionen, CTR, durchschnittlicher Klickposition und durchschnittlicher Impressionsposition; Crawling-Werte pro Tag (gecrawlte Seiten, Crawling-Fehler, Antworten nach HTTP-Status, durch robots.txt blockierte URLs, Seiten im Index, eingehende Links, Seiten mit Malware-Hinweis); Bings aktuelle Liste der Crawling-Probleme; die am häufigsten verlinkten Seiten der Website; und den Status ihrer Sitemaps und Feeds. KPIs, Linien- und Balkendiagramme, Tabellen und Donuts funktionieren alle, im Builder, in „Mit KI entwerfen“, in geteilten Links und PDFs sowie über die API und den Connector für KI-Assistenten. So liest du die Zahlen richtig. Die Klicks und Impressionen von Bing enthalten alle Bing-Bereiche, also Websuche, Copilot und Chat, News, Bilder, Videos und das Knowledge Panel zusammen (so zählt Bing seit dem 24. März 2023). Bing kann sie nicht trennen, deshalb kennzeichnen wir sie als „alle Bereiche inkl. Copilot“ und nennen sie nie Websuche. Die CTR ist die Summe der Klicks geteilt durch die Summe der Impressionen im Zeitraum, nie ein Durchschnitt täglicher Raten. Eine durchschnittliche Position für die ganze Website liefert Bing nicht, nur für die Top-Suchanfragen und -Seiten; die Position steht deshalb in diesen Tabellen und nicht in einem KPI. Diese Tabellen zählen nur die Bing-Websuche: Laut Bing gibt es Daten zu Suchanfragen, Seiten, Geräten und Ländern nicht für Copilot, Chat und andere Bereiche; ihre Summen liegen daher unter den Gesamtwerten der Website. Diese Tabellen kommen von Bing als Wochenwerte: Eine Tabelle für einen Zeitraum fasst die Bing-Wochen zusammen, deren Datum in ihm liegt, und nennt die Wochen unter der Tabelle (zum Beispiel „die Wochen vom 6. Okt., 13. Okt. 2026“), statt so zu tun, als deckte sie die Tage des Zeitraums genau ab. Positionen über mehrere Wochen sind gewichtet, die Impressionsposition nach Impressionen und die Klickposition nach Klicks. Bing zählt seine Tage in US-Pazifikzeit, wie die Search Console. Crawling-Zahlen wie gecrawlte Seiten werden über die Tage des Zeitraums addiert; Bestände wie Seiten im Index, eingehende Links oder durch robots.txt blockierte URLs zeigen den Wert von Bings letztem Tag im Zeitraum, und das Widget nennt diesen Tag. Bing speichert etwa sechs Monate Crawling-Daten. Bings Zahlen kommen meist ein, zwei Tage später. Liegt Bings letzter Tag im Zeitraum, zählt der Bericht den Zeitraum bis zu diesem Tag, genau wie Bings eigene Search-Performance-Ansicht (Bings Daten kommen etwa zwei Tage später), und das Widget nennt die Tage, für die Bing noch keine Daten hat. Der Vergleich deckt die passenden Tage ab: bei der Vorperiode ebenso viele Tage direkt davor, bei Kalendermonaten dieselben Tage des Vormonats (ein angeschnittener Monat wird mit den ersten Tagen des früheren Monats verglichen, ganze Monate sind unterschiedlich lang), beim Vorjahr dieselben Daten ein Jahr früher. Ein Zeitraum, der am 1. eines Monats beginnt (dieser oder letzter Monat, ein Quartal, ein Jahr oder ein „bis heute“), wird nie in den Vormonat verschoben: Er zählt vom 1. bis zu Bings letztem Tag (zum Beispiel 1.–29. Okt. gegen 1.–29. Sept.; der März bis zum 30. gegen den ganzen Februar). Decken Bings Daten nicht beide Zeiträume ab, zeigt das Widget keine Veränderung statt einer verzerrten. Eine wöchentliche Tabelle der Suchanfragen oder Seiten wird nur mit derselben Zahl an Bing-Wochen verglichen, und der Hinweis nennt beide Wochengruppen. Ein Tag, den Bing nicht geliefert hat, ist eine Lücke, nie eine Null. Google und Bing im Vergleich. Hat ein Kunde sowohl die Search Console als auch die Bing Webmaster Tools verbunden, zeigt das Widget „Google und Bing im Vergleich“ (Tabelle oder Liniendiagramm) beide Suchmaschinen für dieselben Tage nebeneinander. Sie werden nie addiert: Die Search Console zählt die Google-Websuche, Bing alle seine Bereiche, eine Summe oder ein Anteil am Gesamtwert würde also Verschiedenes vermischen. Noch nicht in diesem Connector: Bings Bericht AI Performance (wie oft Copilot und Bings KI-Antworten deine Seiten zitieren). Bing zeigt ihn nur in den Bing Webmaster Tools und bietet dafür keine API an; wir fügen ihn hinzu, sobald es einen verlässlichen Weg gibt, ihn zu übernehmen. Auch Bings Keyword-Recherche ist nicht enthalten: Sie schätzt die Suchnachfrage pro Keyword, statt deine Website zu messen, und die Keyword-Positionen bei Bing deckt bereits der Rank Tracker ab. Fehlerbehebung. „Bing hat die Anmeldung ohne ihren Sicherheitswert zurückgeschickt“ heißt: Bing kam ohne den state-Wert zurück, mit dem CrunchJunkie die Anmeldung prüft. Es wurde nichts gespeichert, und der Support sieht die Ursache im Log. „Bing hat keine dauerhafte Anmeldung geschickt“ heißt: Bing hat kein Refresh-Token ausgegeben. Entferne CrunchJunkie unter Bing Webmaster Tools → Einstellungen → API-Zugriff und verbinde neu. Eine als nicht bestätigt angezeigte Website musst du zuerst in den Bing Webmaster Tools bestätigen. Bing begrenzt, wie oft ein Konto seine API abfragen darf; antwortet es mit ThrottleUser oder ThrottleHost, wartet CrunchJunkie und fragt noch einmal, und ein Widget, das sich dann noch nicht lesen lässt, zeigt „Nicht geladen“, nie null. Wirken die Zahlen einer Website leer, prüfe, ob die Website des Kunden die in Bing bestätigte ist: http und https oder www und die Domain ohne www sind dort verschiedene Websites.

Amazon Ads

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

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, 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. Die Reichweite ist eine Zahl eindeutiger Personen und wird daher nie über Kampagnen oder Tage addiert: Die Scorecard liest die Reichweite des Zeitraums direkt bei Reddit, Diagramm und Tagestabelle die Reichweite jedes Tages, und die Frequenz ist Impressionen geteilt durch diese Reichweite. Die Conversion-Rate zeigt einen Gedankenstrich mit Begründung: Reddit liefert die Key Conversion nur als Klick- und View-Through-Conversions zusammen, und hinter einer View-Through-Conversion steht kein Klick, daher lässt sie sich nicht durch Klicks teilen; die Klick-Conversions je Event, etwa Purchases (click), werden ausgewiesen.

ChatGPT Ads

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 (auch getrennt nach Klick und View), Kosten pro Conversion, Conversion-Rate, Käufe, Kaufwert, Kosten pro Kauf und ROAS, nach Kampagne oder im Zeitverlauf. Die Tabellen nach Land und Gerät zeigen auch Conversions, aus OpenAIs eigener Aufschlüsselung nach Land und Gerät. Eine Conversion-Zeile wird nur dann einer Auslieferungszeile zugeordnet, wenn beide dasselbe Land oder Gerät nennen (derselbe Text oder ein Ländercode und sein Name); eine, die nicht passt, steht als eigene Zeile mit Gedankenstrich in den Auslieferungsspalten, damit keine Conversion in der falschen Zeile landet und die Tabelle trotzdem die Summe des Kontos ergibt. Tabellen nach Produkt zeigen nur die Auslieferung; ihre Conversion-Spalten zeigen einen Gedankenstrich. So sind die Conversion-Zahlen definiert: Conversions sind die Ziel-Conversions deiner Kampagnen innerhalb von 30 Tagen nach einem Klick oder 1 Tag nach einem View, datiert auf den Tag dieses Klicks oder Views. Das sind OpenAIs Standardfenster, und CrunchJunkie schickt sie bei jeder Abfrage mit – ändert OpenAI später seine Standards, bleibt dein Bericht unverändert. Die Conversion-Rate teilt Klick-Conversions durch Klicks, denn hinter einer View-Conversion steht kein Klick. Käufe und Kaufwert zählen jeden zugeordneten Kauf, auch bei Kampagnen, die auf ein anderes Ziel optimieren; ROAS ist Kaufwert geteilt durch Ausgaben. Ein Konto, das noch nie ein Kauf-Event gesendet hat, zeigt dort einen Gedankenstrich statt einer Null, und in einem „Alle Kanäle“-Widget bleiben seine Ausgaben aus dem gebündelten ROAS heraus (in den Ausgaben zählen sie weiter). Die Tage folgen der Zeitzone des Werbekontos, und die Conversions des laufenden Tages gelten bei OpenAI als vorläufig, bis sie verarbeitet sind. 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, Conversions und Kaufwert).

Brevo

Brevo (früher Sendinblue) verbindest du mit einem API-Key des Kontos statt über OAuth – Brevos OAuth ist den eigenen Partnern vorbehalten, ein Schlüssel ist für ein Drittanbieter-Tool der einzige Weg. Erstell zuerst den Schlüssel in Brevo. Melde dich an, klick oben rechts auf deinen Profilnamen → SMTP & API → API-Schlüssel → „Neuen API-Schlüssel erstellen“. Gib ihm einen Namen wie „CrunchJunkie“ und kopier ihn sofort: Brevo zeigt einen Schlüssel nur ein einziges Mal an. Wenn du mehrere Brevo-Konten betreust, erstell pro Konto einen Schlüssel – ein Schlüssel gehört zu dem Konto, in dem er erzeugt wurde. Dann verbindest du ihn in CrunchJunkie. Öffne Daten → Integrationen, klick auf der Brevo-Karte auf Verbinden, wähl den Kunden und füg den Schlüssel ein. CrunchJunkie prüft ihn sofort gegen das Konto, speichert ihn verschlüsselt und liest damit ausschließlich Kampagnenstatistiken. Zum Entziehen löschst du den Schlüssel später in Brevo und verbindest mit einem neuen. Zu den verfügbaren Metriken zählen Reichweite – gesendete Kampagnen, gesendete E-Mails, Zugestellt und Zustellrate –, Engagement (Öffnungsrate, eindeutige Klicks, Klickrate, Click-to-Open-Rate), Listenqualität (Hard und Soft Bounces, Bounce-Rate, Abmeldungen, Beschwerden und die jeweiligen Raten) sowie, wenn im Brevo-Konto E-Commerce-Tracking aktiv ist, Bestellungen, Umsatz und durchschnittlicher Bestellwert in der Anzeigewährung des Kontos. Aufgeschlüsselt nach Kampagne oder Versandtag oder im Zeitverlauf. Drei ehrliche Details, die E-Mail eigen sind. Brevo meldet die Statistik jeder Kampagne als laufende Summe für diese Kampagne, nicht tageweise – ein „Tag“ im Diagramm sind also die an diesem Tag versendeten Kampagnen zusammengefasst, und die Öffnungsrate einer Woche ist Öffnungen geteilt durch Zustellungen über die ganze Woche, nie ein Mittel aus Tagesraten. „Öffnungsrate (nachverfolgbar)“ schließt bewusst Öffnungen aus, die Apples Mail Privacy Protection erzeugt, das jede E-Mail vorlädt, ob ein Mensch sie gelesen hat oder nicht; die ausgeschlossenen maschinellen Öffnungen stehen separat als „Apple-MPP-Öffnungen“. „Öffnungsrate (inkl. MPP)“ ist der Rohwert mit diesen maschinellen Öffnungen – die Zahl, die Brevos eigener Kampagnenbericht vorne zeigt; nimm sie zum Abgleichen und die nachverfolgbare zum Beurteilen. Die Click-to-Open-Rate teilt eindeutige Klicks durch alle eindeutigen Öffnungen (ein Klick ist immer eine Öffnung, egal aus welchem Mailprogramm). Und Bestellungen und Umsatz zeigen „—“ statt 0, wenn im Brevo-Konto kein E-Commerce-Tracking läuft – eine fehlende Zahl ist keine Null.

Mailchimp

Mailchimp verbindest du auf einem von zwei Wegen. Der einfachste ist „Mit Mailchimp fortfahren“: Du meldest dich auf Mailchimps eigener Seite an, wählst das Konto, und CrunchJunkie erhält ein Lese-Token – nie dein Passwort. Mailchimp-Tokens laufen nicht ab; widerrufen kannst du sie unter Account & billing → Extras → Registered apps. Willst du lieber einen Schlüssel nutzen (Agenturen halten oft einen pro Kundenkonto), erstell ihn in Mailchimp unter deinem Profil → Account & billing → Extras → API keys, kopier ihn einmal und füg ihn auf der Mailchimp-Karte unter Daten → Integrationen ein. Der Schlüssel endet auf sein Rechenzentrum („-us21“) – daran erkennt CrunchJunkie, von welchem Mailchimp-Server es lesen muss. Beide Zugänge gehören zu genau einem Mailchimp-Konto und zu dem Nutzer, der sie erstellt hat: Eine Agentur mit mehreren Kundenkonten verbindet jedes Konto einmal, und ein aus dem Konto entfernter Nutzer nimmt den Zugang mit. Zu den verfügbaren Metriken zählen Reichweite – gesendete Kampagnen, gesendete E-Mails, Zugestellt und Zustellrate –, Engagement (Öffnungsrate, eindeutige und gesamte Öffnungen, eindeutige und gesamte Klicks, Klickrate, Click-to-Open-Rate, Weiterleitungen), Listenqualität (Hard und Soft Bounces, Syntaxfehler, Bounce-Rate, Abmeldungen, Beschwerden und die jeweiligen Raten) sowie, wenn mit dem Mailchimp-Konto ein Shop verbunden ist, Bestellungen, Umsatz und durchschnittlicher Bestellwert in der Währung des Shops. Aufgeschlüsselt nach Kampagne, nach Zielgruppe (der Liste, an die eine Kampagne ging) oder nach Versandtag – oder im Zeitverlauf. Vier ehrliche Details, die E-Mail eigen sind. Mailchimp meldet die Statistik jeder Kampagne als laufende Summe für diese Kampagne, nicht tageweise – ein „Tag“ im Diagramm sind also die an diesem Tag versendeten Kampagnen zusammengefasst, und die Öffnungsrate einer Woche ist Öffnungen geteilt durch Zustellungen über die ganze Woche, nie ein Mittel aus Tagesraten. Zugestellt ist gesendete E-Mails minus Bounces – die Definition hinter Mailchimps eigenen „successful deliveries“. „Öffnungsrate (nachverfolgbar)“ zählt nur eindeutige Öffnungen aus Mailprogrammen, die nicht über einen Privacy-Proxy laden – Mailchimps proxy-bereinigte Zahl –, weil Apples Mail Privacy Protection jede E-Mail als geöffnet meldet, ob ein Mensch sie gelesen hat oder nicht; die ausgeschlossenen maschinellen Öffnungen stehen separat als „Proxy-Öffnungen“, und „Öffnungsrate (inkl. MPP)“ ist der Rohwert, den Mailchimps eigener Bericht vorne zeigt – zum Abgleichen. Die Klickrate zählt Personen, die geklickt haben (Mailchimps unique subscriber clicks), nicht Links. Und Umsatz ist die Bestellsumme ohne Versand und Steuern, angezeigt als „—“ statt 0, wenn kein Shop verbunden ist – eine fehlende Zahl ist keine Null. Noch nicht in diesem Konnektor: das Wachstum der Zielgruppe im Zeitverlauf. Mailchimps Growth-History- und Daily-Activity-Endpunkte dokumentieren weder Format noch Zeitzone ihrer Monats- und Tagesfelder – wir ergänzen sie lieber, sobald ein Live-Konto geklärt hat, was sie bedeuten, statt sie auf Verdacht zu zeichnen.

Matomo

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 werden nie über Tage addiert, denn wer an mehreren Tagen kam, zählte sonst einmal pro Tag. Eine Scorecard zeigt Matomos eigene Zahl eindeutiger Besucher für den ganzen Zeitraum, die Aufschlüsselungstabellen Matomos Zahl je Zeile. Matomo zählt eindeutige Besucher über einen Zeitraum nur, wenn die Instanz sie für Zeiträume verarbeitet; wo nicht, steht ein Gedankenstrich mit Begründung. Diagramm und Tagestabelle zeigen die Zahl jedes Tages. Die Conversion-Rate ist die Zahl der Besuche, die mindestens ein Ziel erreicht haben, geteilt durch alle Besuche – Matomos eigene Conversion-Rate –, ein Besuch mit mehreren Zielen zählt also einmal, und die Rate liegt nie über 100 %.

Piwik PRO

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 Conversions / Sitzung – 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. Besucher auf einer Scorecard sind Piwik PROs eigene Zahl für den ganzen Zeitraum, wer an mehreren Tagen kam, zählt also einmal; Diagramm und Tagestabelle zeigen die Besucher jedes Tages. Conversions / Sitzung ist Ziel-Conversions geteilt durch Sitzungen: Eine Sitzung kann mehrere Ziele erreichen, es ist also eine Zahl pro Sitzung, die über 1 liegen kann, kein Anteil der Sitzungen (früher hieß sie Conversion-Rate; gespeicherte Widgets stellen sich von selbst um). Beachte außerdem: Piwik-PRO-Daten haben rund zwei Stunden Verarbeitungsverzögerung, der aktuelle Tag füllt sich also meist noch auf.

Google Unternehmensprofil

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: Ein Bericht über eine Woche oder 30 Tage zeigt die ganzen Kalendermonate, die er berührt, und nennt sie unter der Tabelle; Begriffe mit geringem Volumen nennt Google nur mit einer Obergrenze, angezeigt als „< N“ und nie mitaddiert oder im Donut dargestellt). 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 – die KPI sagt das mit dem Datum, an dem sie gelesen wurden. 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.

Weitere Plattformen in Arbeit

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.

Hinweise unter „Braucht Aufmerksamkeit“

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.

Verbindungsprobleme beheben

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.