Collegare Apple Search Ads a Google Sheets

Collega Apple Ads e Google Drive a Hermoso e diventano entrambi richiamabili dallo stesso agente. apple_ads_report estrae le righe delle prestazioni; create_sheet e append_to_sheet le mettono in un foglio di calcolo che possiedi. Nessun file di esportazione, nessun warehouse, nessuno strumento terzo che custodisce le tue credenziali.

Come appare nella pratica

"Estrai la spesa di Apple Search Ads della settimana scorsa per parola chiave e aggiungila al mio foglio Apple Ads." L'agente chiama il report, modella le righe e le aggiunge. Chiedi di nuovo il lunedì successivo e il foglio cresce di una settimana.

Lo scope di Drive che Hermoso richiede è drive.file, che raggiunge i file che ha creato o che hai scelto, non tutto il tuo Drive.

Come collegare Apple Search Ads a Google Sheets

1. Collega entrambi gli account. Nell'app, apri Connettori e collega Apple Ads, poi Google Drive. Sheets e Docs usano la stessa autorizzazione Google, quindi c'è una sola schermata di consenso, non tre. Apple Ads è uno scambio di chiavi e non un pulsante; la guida alla configurazione di Apple Search Ads lo spiega, incluso come collegare Apple Search Ads a Claude o a ChatGPT, dove scriverai la richiesta.
2. Chiedi la prima estrazione. "Estrai le prestazioni di Apple Search Ads per campagna degli ultimi 30 giorni e mettile in un nuovo foglio chiamato Apple Ads." L'agente chiama apple_ads_report, poi create_sheet, e ti restituisce il link.
3. Rendila ricorrente. La stessa frase con "aggiungi" invece di "nuovo foglio", eseguita a una pianificazione dal client che usi (un'attività pianificata in Claude o ChatGPT, oppure un cron job che richiama la CLI di Hermoso), aggiunge ogni volta un blocco di righe. Non si sovrascrive nulla, a meno che tu non lo chieda.
4. Collega la dashboard al foglio. Looker Studio, Power BI e Tableau leggono tutti Google Sheets con i rispettivi connettori.

Come appare il foglio

Una riga per entità per periodo. Le colonne seguono il livello che hai chiesto (campagna, gruppo di annunci, annuncio, parola chiave o termine di ricerca) più le metriche che riporta Apple: impression, tap, installazioni, spesa, tasso di tap, costo per tap e costo per acquisizione. Se chiedi la granularità giornaliera, ogni entità ha una riga al giorno; se chiedi i totali, ne ha una sola. L'agente può aggiungere una riga di totali generali e, sui report App Store, può mantenere le entità senza consegna, così una parola chiave in pausa compare come zero invece di sparire.

Poiché l'agente modella le righe prima di scriverle, puoi chiedere esattamente il foglio che vuoi: solo le parole chiave sopra una soglia di spesa, il nome della campagna accanto al suo id, le variazioni settimana su settimana calcolate prima della scrittura. È un lavoro che un export CSV lascia a te.

Aggiungere, sostituire o formattare

Gli strumenti per i Fogli coprono tutta la modifica: append_to_sheet aggiunge righe, update_sheet scrive un intervallo sul posto, clear_sheet_range svuota prima un intervallo quando vuoi una sostituzione invece di un accumulo, format_sheet gestisce intestazioni, larghezze e formati numerici, e manage_sheet_tabs dà a ogni campagna o a ogni mese una propria scheda. Una richiesta di "aggiorna il foglio della dashboard" è una cancellazione seguita da una scrittura, sulla scheda che indichi.

Esportare Apple Search Ads in Looker Studio dal foglio

Hermoso non ha un connettore nativo per Looker Studio; il foglio fa da ponte. In Looker Studio crea un'origine dati, scegli Google Sheets, e seleziona il foglio di calcolo e la scheda in cui l'agente aggiunge le righe. Costruisci il report una volta e lascialo così. Ogni aggiunta compare al successivo aggiornamento dei dati della dashboard, purché le intestazioni delle colonne restino le stesse tra un'esecuzione e l'altra. Lo stesso schema funziona per Power BI e Tableau.

Preferisci il JSON al foglio?

Lo stesso report è disponibile come JSON grezzo dall'API di Hermoso (POST /v1/tools/apple_ads_report) o dalla CLI. Vedi Esportare Apple Search Ads in JSON, e esportare i dati da Apple Search Ads per tutte le altre destinazioni.

Domande frequenti

Come collego Apple Search Ads a Google Sheets?

Collega Apple Ads e Google Drive in Hermoso, poi chiedi al tuo agente di mettere il report in un foglio. Estrae le righe con apple_ads_report, le scrive con create_sheet o append_to_sheet, e ti restituisce il link.

Hermoso ha bisogno dell'accesso a tutto il mio Google Drive?

No. Richiede drive.file, che copre i file creati da Hermoso e quelli che scegli esplicitamente.

Quali livelli e quali metriche possono finire nel foglio?

Livello campagna, gruppo di annunci, annuncio, parola chiave o termine di ricerca, con impression, tap, installazioni, spesa, tasso di tap, costo per tap e costo per acquisizione, sia come totali sia come serie oraria, giornaliera, settimanale o mensile.

Un report pianificato sovrascriverà il mio foglio?

No, a meno che tu non lo chieda. Le aggiunte aggiungono righe; una sostituzione è una cancellazione seguita da una scrittura sulla scheda che indichi, e l'agente la esegue solo quando la richiesta lo dice.

Looker Studio o Power BI possono leggere il risultato?

Sì. Hermoso non ha un connettore nativo per nessuno dei due, ma entrambi leggono Google Sheets con i propri connettori, quindi una dashboard costruita sul foglio si aggiorna man mano che l'agente vi aggiunge righe.

Il report può girare a una pianificazione?

Sì, dal client in cui gira il tuo agente: un'attività pianificata in Claude o ChatGPT, oppure un cron job che richiama la CLI o l'API di Hermoso. Ogni esecuzione estrae il nuovo periodo e lo aggiunge.