Daten aus Apple Search Ads exportieren

Hermoso verbindet sich mit Apple Search Ads und stellt es als Tools bereit, die dein Agent aufrufen kann: Claude, ChatGPT, Cursor, Codex, Cline, die CLI oder einfaches HTTP. apple_ads_report holt die Performance von Kampagne, Anzeigengruppe, Anzeige, Keyword und Suchbegriff, und die Zeilen kommen als Daten zurück und nicht als CSV-Download, den du dann irgendwohin tragen musst.

Der Apple-Search-Ads-Connector

Apple veröffentlicht für seine Ads-API keinen OAuth-Ablauf, die Verbindung läuft deshalb über einen Schlüsseltausch und nicht über einen Button: Hermoso erzeugt den Signaturschlüssel, du fügst seine öffentliche Hälfte in Apple Ads ein und fügst drei IDs zurück. Die Einrichtungsanleitung für Apple Search Ads führt durch alles, einschließlich des Feldes Public Key, das die meisten Leute nicht finden. Eine Verbindung bedient dann Web-App, MCP-Server, CLI und REST-API, sodass derselbe Export aus Claude, ChatGPT oder Cursor funktioniert: Apple Search Ads mit Claude verbinden oder mit ChatGPT, einmal, und dann fragst du.

Berichte sind nur ein Teil davon. Dieselbe Verbindung baut und betreibt auch das Konto: Kampagnen, Anzeigengruppen, Keywords und Negativ-Keywords, Budgetaufträge, Targeting, Keyword-Vorschläge und Änderungsverlauf. Die Seite zum Apple-Ads-Kanal listet jedes Tool auf.

Was der Bericht enthält

Ein Aufruf, fünf Ebenen. apple_ads_report berichtet auf Ebene Kampagne, Anzeigengruppe, Anzeige, Keyword oder Suchbegriff, und jede Zeile enthält die Kennzahlen, die auch Apples eigenes Dashboard zeigt: Impressionen, Taps, Installationen, Ausgaben, Tap-Through-Rate, Kosten pro Tap und Kosten pro Akquisition. Du kannst Summen anfordern oder eine Reihe in stündlicher, täglicher, wöchentlicher oder monatlicher Granularität. Die Zeilen kommen absteigend nach Ausgaben sortiert, bis zu 5.000 pro Seite, mit einer Gesamtzeile auf Wunsch. App-Store-Berichte können auch Objekte ohne Auslieferung enthalten, ein pausiertes Keyword erscheint also als Null statt als fehlende Zeile.

Zwei Regeln, die Apple durchsetzt und die das Tool erklärt, statt stillschweigend zu scheitern: Ein Bericht unterhalb der Kampagnenebene braucht eine Kampagnen-ID (nur ein Bericht auf Kampagnenebene kann das ganze Konto abdecken), und Suchbegriff-Berichte laufen in der Zeitzone deiner Organisation, nie in UTC. Anzeigen auf Apple Maps sind ebenfalls abgedeckt: Ein Bericht für Business-Brands kommt aus demselben Tool, wobei ein Parameter geändert wird.

Apple Search Ads mit Google Tabellen verbinden

Das ist das einzige Ziel, in das Hermoso selbst schreibt. Verbinde Google Drive neben Apple Ads (eine Google-Autorisierung deckt Drive, Tabellen und Docs ab) und frag dann: „Hol die Apple-Search-Ads-Performance nach Keyword für die letzten 30 Tage und schreib sie in eine neue Tabelle namens Apple Ads.“ Der Agent ruft apple_ads_report auf, dann create_sheet, und gibt dir den Link zurück. Nächste Woche fügt dieselbe Anfrage mit „anhängen“ die Zeilen mit append_to_sheet hinzu, statt von vorn zu beginnen.

Hermoso fordert bei Google den Scope drive.file an, der nur Dateien erreicht, die es erstellt hat, und die, die du auswählst, nie dein ganzes Drive. Die vollständige Anleitung, einschließlich Ersetzen eines Tabs an Ort und Stelle und Formatierung, steht unter Apple Search Ads mit Google Tabellen verbinden.

Apple Search Ads nach Looker Studio exportieren

Hermoso hat keinen nativen Looker-Studio-Connector, und wir sagen das lieber offen, als etwas anderes anzudeuten. Er ist auch nicht nötig: Looker Studio liest Google Tabellen mit eigenem, eingebautem Connector, deshalb ist die Tabelle oben die Brücke.

1. Lass den Agenten den Bericht in einen Tab schreiben. Tägliche Granularität, eine Zeile pro Keyword und Tag, eine Kopfzeile und eine Datumsspalte. Bitte darum, die Datumsspalte als Datum zu formatieren (format_sheet erledigt das), damit Looker Studio sie als Datum liest.
2. Füge die Tabelle als Datenquelle hinzu. Erstelle in Looker Studio eine Datenquelle, wähle Google Tabellen, wähle die Tabelle und diesen Tab und lass „Erste Zeile als Überschriften verwenden“ eingeschaltet.
3. Baue den Bericht einmal. Ausgaben pro Tag, Kosten pro Akquisition pro Keyword, Installationen pro Kampagne: alles, was du sonst jeden Montag in einer Tabelle neu aufbauen würdest.
4. Häng weiter an. Jede Woche hängt der Agent neue Zeilen an denselben Tab, und das Dashboard holt sie bei der nächsten Datenaktualisierung. Behalte die Spaltennamen zwischen den Läufen bei, denn Looker Studio ordnet Felder über die Überschriften zu.

Dieselbe Tabelle funktioniert für Power BI und Tableau, die beide eigene Google-Tabellen-Connectoren haben.

Apple Search Ads als JSON exportieren

Wenn du die rohen Zeilen statt einer Tabelle willst, gibt es drei Wege, sie zu holen, alle über dieselbe Verbindung.

Die REST-API. Jedes Hermoso-Tool ist unter POST /v1/tools/{name} aufrufbar, mit einem API-Schlüssel, den du in der App im Tab MCP & CLI erstellst. Der Request-Body sind die Argumente des Tools, und das Feld data der Antwort ist das strukturierte Ergebnis, mit den Zeilen in data.rows:

curl -sX POST https://app.hermoso.ai/v1/tools/apple_ads_report \
  -H "Authorization: Bearer hmk_..." -H 'content-type: application/json' \
  -d '{"level":"keyword","campaignId":"1234567890","startTime":"2026-09-01","endTime":"2026-09-07","granularity":"DAILY"}' \
  | jq '.data.rows' > apple-search-ads.json

Die CLI. npx -y hermoso call apple_ads_report --json '{...}' --structured gibt dasselbe strukturierte Ergebnis als JSON aus, bereit zum Umleiten in eine Datei oder zum Weiterleiten an ein anderes Skript.

Dein Agent. In jedem Chat fragst du nach den Zeilen als JSON, und du bekommst sie in der Antwort, bereits so geformt, wie du es verlangt hast.

Bei langen Berichten nimmt limit bis zu 5.000 Zeilen pro Seite, und offset springt zur nächsten; das Feld hasMore im Ergebnis sagt, ob eine weitere Seite existiert. Einen Bericht zu lesen verbraucht keine Credits. Die vollständige API-Referenz steht in der Entwicklerdokumentation.

Andere Ziele

„Direkt“ heißt, Hermoso schreibt es selbst. Alles andere ist ein Schritt, den ein Tool, das du ohnehin nutzt, selbst erledigt.

• Google Tabellen, Google Docs, Google Drive, OneDrive: direkt.
• Looker Studio, Power BI, Tableau: über die Tabelle, jeweils mit ihrem eigenen Google-Tabellen-Connector.
• BigQuery: über die Tabelle oder über deinen eigenen Agenten. BigQuery kann eine Google Tabelle als externe Tabelle abfragen. Wenn dein Agent irgendwo mit einem BigQuery-Client und deinen Projekt-Zugangsdaten läuft, kann er die Zeilen, die Hermoso zurückgibt, direkt in eine Tabelle einfügen.
• Excel: über die Tabelle oder eine Datei. Lade die Tabelle als .xlsx herunter oder lass den Agenten eine Datei in Google Drive oder OneDrive ablegen.
• PostgreSQL, Redshift, Snowflake oder jedes andere Data Warehouse: über deinen eigenen Agenten oder die API. Hermoso gibt JSON zurück; was deine Datenbank-Zugangsdaten hält, schreibt sie. Hermoso hält keine Warehouse-Zugangsdaten.

Den wöchentlichen Export automatisieren

Der Prompt ist die Automatisierung. Etwas wie „Hol jeden Montag die Apple-Search-Ads-Performance der letzten Woche nach Keyword für jede Kampagne, hänge sie an die Tabelle Apple Ads an und sag mir, welche Keywords sich bei den Kosten pro Akquisition am stärksten bewegt haben“ ist ein vollständiger Auftrag. Lass ihn in einem Rhythmus laufen, mit der Planung, die dein Client schon hat (geplante Aufgaben in Claude oder ChatGPT oder ein Cron-Job, der die Hermoso-CLI oder die API aufruft), und die Tabelle sowie jedes Dashboard, das sie liest, bleiben aktuell.

Weil dieselbe Verbindung das Konto auch bearbeitet, liegen Bericht und Korrektur an einer Stelle: Der Agent, der sieht, dass sich die Kosten pro Akquisition eines Keywords verdoppelt haben, kann es im selben Gespräch pausieren oder ein Negativ-Keyword hinzufügen.

Häufig gestellte Fragen

Wie exportiere ich Daten aus Apple Search Ads?

Verbinde Apple Ads einmal mit Hermoso und frag deinen Agenten dann nach dem Bericht, den du willst, zum Beispiel Keyword-Performance der letzten Woche. Das Tool apple_ads_report holt ihn aus der Reporting-API von Apple, und der Agent schreibt ihn in eine Google Tabelle, gibt dir JSON zurück oder beides.

Kann ich Apple Search Ads mit Google Tabellen verbinden?

Ja. Verbinde Apple Ads und Google Drive in Hermoso und bitte den Agenten dann, den Bericht in eine Tabelle zu schreiben. Er erstellt die Tabelle mit create_sheet oder hängt Zeilen mit append_to_sheet an eine bestehende an und kann das jede Woche wiederholen.

Kann ich Apple Search Ads nach Looker Studio exportieren?

Ja, über Google Tabellen. Hermoso hat keinen nativen Looker-Studio-Connector. Der Agent schreibt den Bericht in eine Tabelle, du fügst diese Tabelle einmal in Looker Studio als Google-Tabellen-Datenquelle hinzu, und jedes Anhängen erscheint beim nächsten Aktualisieren des Dashboards.

Wie exportiere ich Apple-Search-Ads-Daten als JSON?

Ruf POST /v1/tools/apple_ads_report auf der Hermoso-API mit einem API-Schlüssel auf und lies data.rows aus der Antwort, oder führe in der CLI hermoso call apple_ads_report --json '{...}' --structured aus. Beide liefern dieselben Zeilen als JSON.

Gibt es eine Reporting-API für Apple Search Ads?

Ja, und Hermoso baut darauf auf. apple_ads_report deckt die Performance von Kampagne, Anzeigengruppe, Anzeige, Keyword und Suchbegriff ab, und die anderen Apple-Ads-Tools bauen und verwalten das Konto.

Kann ich Suchbegriff-Berichte von Apple Search Ads abrufen?

Ja. Verlange die Ebene Suchbegriff und nenne die Kampagne. Apple liefert Suchbegriffe nur pro Kampagne und in der Zeitzone der Organisation.

Wie viele Zeilen kann ein Bericht enthalten?

Bis zu 5.000 pro Seite, absteigend nach Ausgaben sortiert, mit einem Hinweis für den Agenten, ob weitere Seiten existieren. Ein wöchentlicher Keyword-Bericht passt bei den meisten Konten auf eine Seite.

Gilt das auch für Anzeigen auf Apple Maps?

Ja. Berichte für Business-Brands-Kampagnen kommen aus demselben Tool, wobei der Typ des beworbenen Objekts auf Apple Maps statt App Store gesetzt wird.

Brauche ich einen Entwickler für die Einrichtung?

Nein. Verbinde Apple Ads einmal in der App und frag deinen Agenten dann in einfacher Sprache: Hol die letzte Woche nach Keyword und leg sie in eine Tabelle. Die API und die CLI sind da, falls du es doch skripten willst.