Apple Search Ads koppelen aan Google Sheets

Koppel Apple Ads en Google Drive aan Hermoso, en beide worden aanroepbaar vanuit dezelfde agent. apple_ads_report haalt de prestatierijen op; create_sheet en append_to_sheet zetten ze in een spreadsheet van jou. Geen exportbestand, geen warehouse, en geen derde tool die je gegevens vasthoudt.

Zo ziet dat eruit

“Haal de Apple Search Ads-uitgaven van vorige week per zoekwoord op en voeg ze toe aan mijn Apple Ads-sheet.” De agent roept het rapport aan, maakt de rijen op maat en voegt ze toe. Vraag het volgende maandag opnieuw en de sheet is weer een week gegroeid.

De Drive-scope die Hermoso vraagt is drive.file, die bereikt bestanden die het zelf heeft aangemaakt of die jij hebt gekozen, niet je hele Drive.

Zo koppel je Apple Search Ads aan Google Sheets

1. Koppel beide accounts. Open de app, open Connectoren en koppel Apple Ads, en daarna Google Drive. Sheets en Docs werken met dezelfde Google-autorisatie, dus het is één toestemmingsscherm, niet drie. Apple Ads is een sleuteluitwisseling en geen knop; de installatiegids voor Apple Search Ads behandelt die, inclusief hoe je Apple Search Ads aan Claude koppelt of aan ChatGPT, waar je het verzoek intypt.
2. Vraag om de eerste export. “Haal de Apple Search Ads-prestaties per campagne van de afgelopen 30 dagen op en zet ze in een nieuwe sheet met de naam Apple Ads.” De agent roept apple_ads_report aan, daarna create_sheet, en geeft je de link.
3. Maak het terugkerend. Dezelfde zin met “toevoegen” in plaats van “nieuwe sheet”, op een schema vanuit de client die je gebruikt (een geplande taak in Claude of ChatGPT, of een cronjob die de Hermoso CLI aanroept), voegt elke keer een blok rijen toe. Er wordt niets overschreven tenzij je daarom vraagt.
4. Richt je dashboard op de sheet. Looker Studio, Power BI en Tableau lezen allemaal Google Sheets met hun eigen connectors.

Zo ziet de sheet eruit

Eén rij per entiteit per periode. De kolommen volgen het niveau dat je hebt gevraagd (campagne, advertentiegroep, advertentie, zoekwoord of zoekterm) plus de statistieken die Apple rapporteert: vertoningen, taps, installs, uitgaven, tap-through rate, kosten per tap en kosten per acquisitie. Vraag om dagelijkse granulariteit en elke entiteit krijgt elke dag één rij; vraag om totalen en elke entiteit krijgt er één. De agent kan een rij met totalen toevoegen, en bij App Store-rapporten kan hij entiteiten zonder levering behouden, zodat een gepauzeerd zoekwoord als nul verschijnt in plaats van te verdwijnen.

Omdat de agent de rijen vormgeeft voordat hij ze schrijft, kun je precies de sheet vragen die je wilt: alleen zoekwoorden boven een uitgavengrens, de campagnenaam naast het id, of week-over-week-wijzigingen die vooraf zijn berekend. Dat is werk dat een CSV-export voor jou overlaat.

Toevoegen, vervangen of opmaken

De Sheets-tools dekken de hele bewerking: append_to_sheet voegt rijen toe, update_sheet schrijft een bereik op zijn plek, clear_sheet_range leegt er eerst een wanneer je vervangen wilt in plaats van opstapelen, format_sheet regelt kopregels, breedtes en getalnotaties, en manage_sheet_tabs geeft elke campagne of elke maand een eigen tabblad. Een verzoek om “het dashboardsheet te verversen” is een leegmaken gevolgd door een schrijfactie, op het tabblad dat je noemt.

Apple Search Ads exporteren naar Looker Studio vanuit de sheet

Hermoso heeft geen eigen Looker Studio-connector; de sheet is de brug. Maak in Looker Studio een databron, kies Google Sheets, en kies de spreadsheet en het tabblad waar de agent aan toevoegt. Bouw het rapport één keer en laat het staan. Elke toevoeging verschijnt bij de volgende gegevensvernieuwing van het dashboard, zolang de kolomkoppen tussen de runs gelijk blijven. Hetzelfde patroon werkt voor Power BI en Tableau.

Liever JSON in plaats van een sheet?

Hetzelfde rapport is beschikbaar als ruwe JSON via de Hermoso API (POST /v1/tools/apple_ads_report) of de CLI. Zie Apple Search Ads exporteren naar JSON, en gegevens exporteren uit Apple Search Ads voor elke andere bestemming.

Veelgestelde vragen

Hoe koppel ik Apple Search Ads aan Google Sheets?

Koppel Apple Ads en Google Drive in Hermoso, en vraag dan je agent om het rapport in een sheet te zetten. Hij haalt de rijen op met apple_ads_report en schrijft ze met create_sheet of append_to_sheet, en geeft je de link.

Heeft Hermoso toegang nodig tot mijn hele Google Drive?

Nee. Het vraagt drive.file, dat geldt voor bestanden die Hermoso heeft aangemaakt en bestanden die jij expliciet kiest.

Welke niveaus en statistieken kunnen in de sheet?

Campagne-, advertentiegroep-, advertentie-, zoekwoord- of zoektermniveau, met vertoningen, taps, installs, uitgaven, tap-through rate, kosten per tap en kosten per acquisitie, als totalen of als reeks per uur, dag, week of maand.

Overschrijft een geplande export mijn sheet?

Niet tenzij je daarom vraagt. Toevoegingen voegen rijen toe; een vervanging is een leegmaken gevolgd door een schrijfactie op het tabblad dat je noemt, en de agent doet dat alleen als het verzoek erom vraagt.

Kunnen Looker Studio of Power BI het resultaat lezen?

Ja. Hermoso heeft geen eigen connector voor een van beide, maar allebei lezen Google Sheets met hun eigen connectors, dus een dashboard op de sheet wordt ververst terwijl de agent eraan toevoegt.

Kan het rapport op een schema draaien?

Ja, vanuit de client waarin je agent draait: een geplande taak in Claude of ChatGPT, of een cronjob die de Hermoso CLI of API aanroept. Elke run haalt de nieuwe periode op en voegt die toe.