Conectează Apple Search Ads la Google Sheets

Conectează Apple Ads și Google Drive la Hermoso, și amândouă devin apelabile din același agent. apple_ads_report extrage rândurile de performanță; create_sheet și append_to_sheet le pun într-o foaie de calcul pe care o deții tu. Fără fișier de export, fără depozit de date, fără un al treilea instrument care să-ți țină credențialele.

Cum arată

„Scoate cheltuielile Apple Search Ads pe cuvinte cheie din săptămâna trecută și adaugă-le în foaia mea Apple Ads.” Agentul apelează raportul, modelează rândurile și le adaugă. Întreabă din nou luni viitoare și foaia crește cu o săptămână.

Scope-ul Drive pe care îl cere Hermoso este drive.file, care ajunge la fișierele pe care le-a creat sau pe care le alegi, nu la tot Drive-ul tău.

Cum conectezi Apple Search Ads la Google Sheets

1. Conectează ambele conturi. În aplicație, deschide Connectors și conectează Apple Ads, apoi Google Drive. Sheets și Docs merg pe aceeași autorizare Google, deci este un singur ecran de consimțământ, nu trei. Apple Ads este un schimb de chei, nu un buton; ghidul de configurare Apple Search Ads îl acoperă, inclusiv cum să conectezi Apple Search Ads la Claude sau la ChatGPT, unde vei scrie cererea.
2. Cere prima extragere. „Scoate performanța Apple Search Ads pe campanie 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.
3. Fă-o recurentă. Aceeași frază, cu „adaugă” în loc de „sheet nou”, rulată periodic din clientul pe care îl folosești (o sarcină programată în Claude sau ChatGPT, sau un job cron care apelează CLI-ul Hermoso), adaugă un bloc de rânduri de fiecare dată. Nimic nu se suprascrie decât dacă ceri explicit.
4. Conectează tabloul la foaie. Looker Studio, Power BI și Tableau citesc toate Google Sheets cu propriii conectori.

Cum arată foaia

Un rând per entitate per perioadă. Coloanele urmează nivelul pe care l-ai cerut (campanie, grup de reclame, reclamă, cuvânt cheie sau termen de căutare), plus metricile raportate de Apple: impresii, atingeri, instalări, cheltuieli, rata de atingere, costul pe atingere și costul pe achiziție. Cere granularitate zilnică și fiecare entitate primește un rând pe zi; cere totaluri și primește un singur rând. Agentul poate adăuga un rând de totaluri generale, iar pentru rapoartele App Store poate păstra entitățile fără livrare, astfel încât un cuvânt cheie oprit apare ca zero, nu dispare.

Pentru că agentul modelează rândurile înainte de a le scrie, poți cere exact foaia pe care o vrei: doar cuvintele cheie peste un prag de cheltuieli, numele campaniei lângă id-ul ei, variațiile săptămână-cu-săptămână calculate înainte de scriere. Este munca pe care un export CSV o lasă pe seama ta.

Adaugă, înlocuiește sau formatează

Uneltele pentru Sheets acoperă toată editarea: append_to_sheet adaugă rânduri, update_sheet scrie un interval pe loc, clear_sheet_range golește unul înainte, când vrei o înlocuire în loc de o grămadă, format_sheet se ocupă de antete, lățimi și formatele numerelor, iar manage_sheet_tabs dă fiecărei campanii sau fiecărei luni propriul tab. O cerere de tipul „reîmprospătează foaia tabloului” este o golire urmată de o scriere, pe tabul pe care îl numești.

Exportă Apple Search Ads în Looker Studio din foaie

Hermoso nu are un conector nativ pentru Looker Studio; foaia este puntea. În Looker Studio, creează o sursă de date, alege Google Sheets, apoi alege foaia de calcul și tabul în care scrie agentul. Construiește raportul o singură dată și lasă-l așa. Fiecare adăugare apare pe tablou la următoarea reîmprospătare a datelor, atâta timp cât antetele coloanelor rămân aceleași între rulări. Același model funcționează și pentru Power BI și Tableau.

Vrei JSON în loc de foaie?

Același raport este disponibil ca JSON brut din API-ul Hermoso (POST /v1/tools/apple_ads_report) sau din CLI. Vezi Exportă Apple Search Ads în JSON și exportă date din Apple Search Ads pentru toate celelalte destinații.

Întrebări frecvente

Cum conectez Apple Search Ads la Google Sheets?

Conectează Apple Ads și Google Drive în Hermoso, apoi cere agentului să pună raportul într-o foaie. Extrage rândurile cu apple_ads_report și le scrie cu create_sheet sau append_to_sheet, apoi îți returnează linkul.

Hermoso are nevoie de acces la tot Google Drive-ul meu?

Nu. Cere drive.file, care acoperă fișierele create de Hermoso și fișierele pe care le alegi explicit.

Ce niveluri și ce metrici pot intra în foaie?

Nivel de campanie, grup de reclame, reclamă, cuvânt cheie sau termen de căutare, cu impresii, atingeri, instalări, cheltuieli, rata de atingere, costul pe atingere și costul pe achiziție, fie ca totaluri, fie ca serie orară, zilnică, săptămânală sau lunară.

Va suprascrie un raport programat foaia mea?

Nu, decât dacă cere asta explicit. Adăugările adaugă rânduri; o înlocuire înseamnă o golire urmată de o scriere pe tabul numit, iar agentul face asta doar când cererea o spune.

Pot Looker Studio sau Power BI să citească rezultatul?

Da. Hermoso nu are un conector nativ pentru niciunul, dar ambele citesc Google Sheets cu propriii conectori, deci un tablou construit pe foaie se reîmprospătează pe măsură ce agentul adaugă rânduri.

Poate raportul să ruleze programat?

Da, din clientul în care rulează agentul tău: o sarcină programată în Claude sau ChatGPT, sau un job cron care apelează CLI-ul sau API-ul Hermoso. Fiecare rulare extrage perioada nouă și o adaugă.