Hermoso se conectează la Apple Search Ads și le expune ca unelte pe care agentul tău le poate apela: Claude, ChatGPT, Cursor, Codex, Cline, CLI-ul sau HTTP simplu. apple_ads_report extrage performanța pe campanie, grup de reclame, reclamă, cuvânt cheie și termen de căutare, iar rândurile vin înapoi ca date, nu ca un fișier CSV pe care trebuie să-l duci undeva.
Conectorul Apple Search Ads
Apple nu publică niciun flux OAuth pentru API-ul său de reclame, deci conectarea este un schimb de chei, nu un buton: Hermoso generează cheia de semnare, tu lipești jumătatea ei publică în Apple Ads și lipești înapoi trei id-uri. Ghidul de configurare Apple Search Ads parcurge tot, inclusiv câmpul Public Key pe care majoritatea oamenilor nu îl găsesc. O singură conexiune servește apoi aplicația web, serverul MCP, CLI-ul și API-ul REST, deci același export funcționează din Claude, ChatGPT sau Cursor: conectează Apple Search Ads la Claude sau la ChatGPT o dată, apoi întreabă.
Raportarea este doar o parte. Aceeași conexiune construiește și rulează și contul: campanii, grupuri de reclame, cuvinte cheie și negative, bugete, targetare, sugestii de cuvinte cheie și istoricul modificărilor. Pagina canalului Apple Ads listează fiecare unealtă.
Ce conține raportul
Un apel, cinci niveluri. apple_ads_report raportează la nivel de campanie, grup de reclame, reclamă, cuvânt cheie sau termen de căutare, iar fiecare rând poartă metricile pe care le arată și tabloul de bord al Apple: impresii, atingeri, instalări, cheltuieli, rata de atingere, costul pe atingere și costul pe achiziție. Cere totaluri sau o serie la granularitate orară, zilnică, săptămânală sau lunară. Rândurile vin ordonate după cheltuieli, cele mai mari primele, până la 5.000 pe pagină, cu un rând de totaluri generale la cerere. Rapoartele App Store pot include și entități fără livrare, deci un cuvânt cheie oprit apare ca zero, nu ca un rând lipsă.
Două reguli pe care le impune Apple, și pe care unealta le explică în loc să eșueze în tăcere: un raport sub nivelul de campanie are nevoie de un id de campanie (doar un raport la nivel de campanie poate acoperi întregul cont), iar rapoartele pentru termeni de căutare rulează în fusul orar al organizației tale, niciodată în UTC. Reclamele din Apple Maps sunt și ele acoperite: un raport pentru business-brands vine din aceeași unealtă, cu un singur parametru schimbat.
Conectează Apple Search Ads la Google Sheets
Aceasta este singura destinație în care Hermoso scrie chiar el. Conectează Google Drive lângă Apple Ads (o singură autorizare Google acoperă Drive, Sheets și Docs), apoi cere: „Scoate performanța Apple Search Ads pe cuvinte cheie pentru ultimele 30 de zile și pune-o într-un sheet nou numit Apple Ads.” Agentul apelează apple_ads_report, apoi create_sheet, și îți returnează linkul. Săptămâna viitoare, aceeași cerere cu „adaugă” adaugă rânduri cu append_to_sheet, în loc să pornească de la zero.
Scope-ul Drive pe care îl cere Hermoso este drive.file, care ajunge doar la fișierele create de el și la cele pe care le alegi, niciodată la tot Drive-ul tău. Pasul cu pas complet, inclusiv înlocuirea unui tab pe loc și formatarea lui, este pe Conectează Apple Search Ads la Google Sheets.
Exportă Apple Search Ads în Looker Studio
Hermoso nu are un conector nativ pentru Looker Studio și preferăm să spunem asta decât să sugerăm contrariul. Nu are nevoie de unul: Looker Studio citește Google Sheets cu propriul conector integrat, deci foaia de mai sus este puntea.
- Cere agentului să scrie raportul într-un singur tab. Granularitate zilnică, un rând per cuvânt cheie per zi, un rând de antet și o coloană de dată. Cere ca coloana de dată să fie formatată ca dată (
format_sheeto face), ca Looker Studio să o citească drept dată. - Adaugă foaia ca sursă de date. În Looker Studio, creează o sursă de date, alege Google Sheets, alege foaia de calcul și tabul respectiv și lasă activ „Use first row as headers”.
- Construiește raportul o singură dată. Cheltuieli pe zi, cost pe achiziție pe cuvânt cheie, instalări pe campanie: orice ai reface altfel în fiecare luni într-o foaie de calcul.
- Continuă să adaugi rânduri. În fiecare săptămână, agentul adaugă rânduri noi în același tab, iar tabloul le preia la următoarea reîmprospătare a datelor. Păstrează aceleași nume de coloane între rulări, pentru că Looker Studio mapează câmpurile după antet.
Aceeași foaie funcționează și pentru Power BI și Tableau, care au conectori Google Sheets proprii.
Exportă Apple Search Ads în JSON
Dacă vrei rândurile brute, nu o foaie de calcul, există trei moduri de a le obține, toate folosind aceeași conexiune.
API-ul REST. Fiecare unealtă Hermoso poate fi apelată la POST /v1/tools/{name} cu o cheie API pe care o creezi în aplicație, la tab-ul MCP & CLI. Corpul cererii sunt argumentele uneltei, iar câmpul data din răspuns este rezultatul structurat, cu rândurile în 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.jsonCLI-ul. npx -y hermoso call apple_ads_report --json '{...}' --structured afișează același rezultat structurat ca JSON, gata de redirecționat într-un fișier sau de trimis într-un alt script.
Agentul tău. În orice chat, cere rândurile ca JSON și le primești în răspuns, deja modelate așa cum ai cerut.
Pentru rapoarte lungi, limit acceptă până la 5.000 de rânduri pe pagină, iar offset trece la pagina următoare; hasMore din rezultat spune dacă mai există o pagină. Citirea unui raport nu consumă credite. Referința completă a API-ului este în documentația pentru dezvoltatori.
Alte destinații
„Direct” înseamnă că Hermoso scrie el. Orice altceva este un pas pe care îl face singur un instrument pe care îl folosești deja.
- Google Sheets, Google Docs, Google Drive, OneDrive: direct.
- Looker Studio, Power BI, Tableau: prin foaie, fiecare cu propriul conector Google Sheets.
- BigQuery: prin foaie sau prin propriul tău agent. BigQuery poate interoga un Google Sheet ca tabel extern. Dacă agentul tău rulează undeva unde există un client BigQuery și credențialele proiectului tău, poate insera direct în tabel rândurile returnate de Hermoso.
- Excel: prin foaie sau printr-un fișier. Descarcă foaia ca .xlsx sau cere agentului să lase un fișier în Google Drive sau OneDrive.
- PostgreSQL, Redshift, Snowflake sau orice depozit de date: prin propriul tău agent sau prin API. Hermoso îți returnează JSON; cel care deține credențialele bazei tale de date scrie rândurile. Hermoso nu deține credențiale pentru depozitul tău.
Automatizarea exportului săptămânal
Promptul este automatizarea. Ceva de genul „În fiecare luni, scoate performanța Apple Search Ads din săptămâna trecută pe cuvinte cheie, pentru fiecare campanie, adaug-o în foaia Apple Ads și spune-mi ce cuvinte cheie s-au mișcat cel mai mult la costul pe achiziție” este o sarcină completă. Rulează-o periodic cu planificarea pe care o are deja clientul tău (sarcini programate în Claude sau ChatGPT, sau un job cron care apelează CLI-ul ori API-ul Hermoso), iar foaia și orice tablou care o citește rămân la zi.
Pentru că aceeași conexiune editează și contul, raportul și corecția trăiesc în același loc: agentul care observă că inexplicabil costul pe achiziție al unui cuvânt cheie s-a dublat îl poate pune pe pauză sau poate adăuga un negativ în aceeași conversație.
Întrebări frecvente
Cum export date din Apple Search Ads?
Conectează Apple Ads la Hermoso o singură dată, apoi cere agentului raportul pe care îl vrei, de exemplu performanța pe cuvinte cheie din săptămâna trecută. Unealta apple_ads_report extrage datele din API-ul de raportare al Apple, iar agentul le scrie într-un Google Sheet, îți returnează JSON sau pe amândouă.
Pot conecta Apple Search Ads la Google Sheets?
Da. Conectează Apple Ads și Google Drive în Hermoso, apoi cere agentului să pună raportul într-un sheet. Creează foaia cu create_sheet sau adaugă rânduri la una existentă cu append_to_sheet și poate repeta asta în fiecare săptămână.
Pot exporta Apple Search Ads în Looker Studio?
Da, prin Google Sheets. Hermoso nu are un conector nativ pentru Looker Studio. Agentul scrie raportul într-un sheet, adaugi o singură dată foaia ca sursă de date Google Sheets în Looker Studio, iar fiecare adăugare apare pe tablou la următoarea reîmprospătare.
Cum export datele Apple Search Ads în JSON?
Apelează POST /v1/tools/apple_ads_report pe API-ul Hermoso cu o cheie API și citește data.rows din răspuns, sau rulează hermoso call apple_ads_report --json '{...}' --structured din CLI. Ambele returnează aceleași rânduri ca JSON.
Există un API de raportare Apple Search Ads?
Da, iar Hermoso este construit pe el. apple_ads_report acoperă performanța pe campanie, grup de reclame, reclamă, cuvânt cheie și termen de căutare, iar celelalte unelte Apple Ads construiesc și administrează contul.
Pot obține rapoarte pe termeni de căutare?
Da. Cere nivelul de termen de căutare și numește campania. Apple servește termenii de căutare doar pe campanie, în fusul orar propriu al organizației.
Câte rânduri poate returna un raport?
Până la 5.000 pe pagină, ordonate după cheltuieli, de la cea mai mare la cea mai mică, cu un indicator care îi spune agentului dacă mai există pagini. Un raport săptămânal pe cuvinte cheie încape, pentru majoritatea conturilor, într-o singură pagină.
Acoperă și Ads pe Apple Maps?
Da. Rapoartele pentru campaniile business-brands vin din aceeași unealtă, cu tipul de obiect promovat setat pe Apple Maps în loc de App Store.
Am nevoie de un developer ca să configurez asta?
Nu. Conectează Apple Ads o dată în aplicație, apoi cere agentului tău, în limbaj obișnuit: performanța din săptămâna trecută pe cuvinte cheie și pune-o într-un sheet. API-ul și CLI-ul sunt acolo dacă vrei totuși să scrii un script.