hermoso
Σύνδεση Εγγραφή
MCP & CLI
APIΤιμές
Σύνδεση Εγγραφή

Εξαγωγή δεδομένων από το Apple Search Ads

Η Apple έχει API αναφορών και δεν έχει κουμπί εξαγωγής που βάζει τους αριθμούς εκεί όπου δουλεύετε. Ο connector του Hermoso τραβά την αναφορά για εσάς και τη βάζει σε ένα Google Sheet, σε πίνακα Looker Studio ή σε αρχείο JSON.

Hermoso συνδέεται με το Apple Search Ads και το εκθέτει ως εργαλεία που μπορεί να καλέσει ο πράκτοράς σας: Claude, ChatGPT, Cursor, Codex, Cline, το CLI ή απλό HTTP. Το apple_ads_report τραβά την απόδοση σε επίπεδο καμπάνιας, ομάδας διαφημίσεων, διαφήμισης, λέξης-κλειδιού και όρου αναζήτησης, και οι γραμμές επιστρέφονται ως δεδομένα και όχι ως αρχείο CSV που πρέπει να μεταφέρετε μόνοι σας κάπου.

Ο connector του Apple Search Ads

Η Apple δεν δημοσιεύει ροή OAuth για το API διαφημίσεών της, οπότε η σύνδεση γίνεται με ανταλλαγή κλειδιού και όχι με κουμπί: το Hermoso δημιουργεί το κλειδί υπογραφής, εσείς επικολλάτε το δημόσιο μισό στο Apple Ads και επιστρέφετε τρία αναγνωριστικά. Ο οδηγός ρύθμισης του Apple Search Ads τα περιγράφει όλα, συμπεριλαμβανομένου του πεδίου Public Key που οι περισσότεροι δεν βρίσκουν. Μία σύνδεση εξυπηρετεί έπειτα την εφαρμογή ιστού, τον διακομιστή MCP, το CLI και το REST API, οπότε η ίδια εξαγωγή δουλεύει από το Claude, το ChatGPT ή το Cursor: σύνδεση του Apple Search Ads με το Claude ή με το ChatGPT, μία φορά, και μετά ρωτάτε.

Οι αναφορές είναι μόνο το ένα μέρος. Η ίδια σύνδεση χτίζει και διαχειρίζεται τον λογαριασμό: καμπάνιες, ομάδες διαφημίσεων, λέξεις-κλειδιά και αρνητικά, εντολές προϋπολογισμού, στόχευση, προτάσεις λέξεων-κλειδιών και ιστορικό αλλαγών. Η σελίδα του καναλιού Apple Ads απαριθμεί κάθε εργαλείο.

Τι περιέχει η αναφορά

Μία κλήση, πέντε επίπεδα. Το apple_ads_report αναφέρεται σε επίπεδο καμπάνιας, ομάδας διαφημίσεων, διαφήμισης, λέξης-κλειδιού ή όρου αναζήτησης, και κάθε γραμμή φέρνει τα μετρικά που δείχνει ο ίδιος ο πίνακας της Apple: εμφανίσεις, πατήματα, εγκαταστάσεις, δαπάνη, ποσοστό κλικ, κόστος ανά πάτημα και κόστος ανά απόκτηση. Ζητήστε είτε σύνολα είτε σειρά σε ωριαία, ημερήσια, εβδομαδιαία ή μηνιαία κατανομή. Οι γραμμές έρχονται ταξινομημένες κατά δαπάνη, από την υψηλότερη, έως 5.000 ανά σελίδα, με γραμμή συνολικών αν τη ζητήσετε. Στις αναφορές App Store μπορούν να συμπεριληφθούν και οντότητες χωρίς καμία απόδοση, οπότε μια σε παύση λέξη-κλειδί εμφανίζεται ως μηδέν και όχι ως κενή γραμμή.

Δύο κανόνες που επιβάλλει η Apple, και το εργαλείο τους εξηγεί αντί να αποτυγχάνει σιωπηρά: μια αναφορά κάτω από το επίπεδο καμπάνιας χρειάζεται αναγνωριστικό καμπάνιας (μόνο μια αναφορά σε επίπεδο καμπάνιας μπορεί να καλύψει ολόκληρο τον λογαριασμό), και οι αναφορές όρων αναζήτησης τρέχουν στη ζώνη ώρας του ίδιου του οργανισμού σας, ποτέ στη UTC. Οι διαφημίσεις στους Χάρτες Apple καλύπτονται κι αυτές: μια αναφορά για business-brands βγαίνει από το ίδιο εργαλείο με μία παράμετρο αλλαγμένη.

Σύνδεση του Apple Search Ads με Google Sheets

Αυτός είναι ο μόνος προορισμός στον οποίο γράφει μόνο του το Hermoso. Συνδέστε το Google Drive δίπλα στο Apple Ads (μία εξουσιοδότηση Google καλύπτει Drive, Sheets και Docs), και μετά ρωτήστε: "Βάλε την απόδοση του Apple Search Ads ανά λέξη-κλειδί για τις τελευταίες 30 ημέρες σε νέο φύλλο με όνομα Apple Ads." Ο πράκτορας καλεί το apple_ads_report, μετά το create_sheet, και σας δίνει τον σύνδεσμο. Την επόμενη εβδομάδα, το ίδιο αίτημα με τη λέξη "append" προσθέτει γραμμές με το append_to_sheet αντί να ξεκινά από την αρχή.

Το scope του Drive που ζητά το Hermoso είναι το drive.file, που φτάνει μόνο στα αρχεία που δημιούργησε ή που επιλέγετε, ποτέ σε ολόκληρο το Drive σας. Ο πλήρης οδηγός, μαζί με την αντικατάσταση ενός φύλλου στη θέση του και τη μορφοποίησή του, βρίσκεται στο Σύνδεση του Apple Search Ads με Google Sheets.

Εξαγωγή του Apple Search Ads στο Looker Studio

Το Hermoso δεν έχει εγγενή connector για το Looker Studio, και προτιμούμε να το λέμε παρά να υπονοούμε ότι υπάρχει. Δεν το χρειάζεται: το Looker Studio διαβάζει Google Sheets με τον δικό του ενσωματωμένο connector, οπότε το φύλλο είναι η γέφυρα.

  1. Βάλτε τον πράκτορα να γράψει την αναφορά σε μία καρτέλα. Ημερήσια κατανομή, μία γραμμή ανά λέξη-κλειδί ανά ημέρα, γραμμή επικεφαλίδων και στήλη ημερομηνίας. Ζητήστε η στήλη ημερομηνίας να μορφοποιηθεί ως ημερομηνία (το format_sheet το κάνει) ώστε το Looker Studio να τη διαβάζει ως τέτοια.
  2. Προσθέστε το φύλλο ως πηγή δεδομένων. Στο Looker Studio δημιουργήστε πηγή δεδομένων, επιλέξτε Google Sheets, διαλέξτε το υπολογιστικό φύλλο και εκείνη την καρτέλα, και αφήστε ενεργό το "Use first row as headers".
  3. Χτίστε την αναφορά μία φορά. Δαπάνη ανά ημέρα, κόστος ανά απόκτηση ανά λέξη-κλειδί, εγκαταστάσεις ανά καμπάνια: ό,τι αλλιώς θα ξαναφτιάχνατε σε υπολογιστικό φύλλο κάθε Δευτέρα.
  4. Συνεχίστε τις προσθήκες. Κάθε εβδομάδα ο πράκτορας προσθέτει νέες γραμμές στην ίδια καρτέλα, και ο πίνακας τις παίρνει στην επόμενη ανανέωση δεδομένων. Κρατήστε ίδια τα ονόματα των στηλών ανάμεσα στις εκτελέσεις, γιατί το Looker Studio αντιστοιχίζει τα πεδία με βάση την επικεφαλίδα.

Το ίδιο φύλλο δουλεύει και για το Power BI και το Tableau, που έχουν και τα δικά τους connectors για Google Sheets.

Εξαγωγή του Apple Search Ads σε JSON

Αν θέλετε τις ακατέργαστες γραμμές αντί για υπολογιστικό φύλλο, υπάρχουν τρεις τρόποι, όλοι με την ίδια σύνδεση.

Το REST API. Κάθε εργαλείο του Hermoso καλείται στο POST /v1/tools/{name} με κλειδί API που δημιουργείτε στην εφαρμογή, στην καρτέλα MCP & CLI. Το σώμα του αιτήματος είναι τα ορίσματα του εργαλείου, και το πεδίο data της απάντησης είναι το δομημένο αποτέλεσμα, με τις γραμμές στο 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

Το CLI. Το npx -y hermoso call apple_ads_report --json '{...}' --structured εμφανίζει το ίδιο δομημένο αποτέλεσμα ως JSON, έτοιμο για ανακατεύθυνση σε αρχείο ή για σωλήνωση σε άλλο script.

Ο πράκτοράς σας. Σε οποιαδήποτε συνομιλία, ζητήστε τις γραμμές ως JSON και θα έρθουν στην απάντηση, ήδη διαμορφωμένες όπως ζητήσατε.

Για μεγάλες αναφορές, το limit δέχεται έως 5.000 γραμμές ανά σελίδα και το offset μεταφέρει στην επόμενη· το πεδίο hasMore του αποτελέσματος δείχνει αν υπάρχει άλλη σελίδα. Η ανάγνωση μιας αναφοράς δεν ξοδεύει πιστώσεις. Η πλήρης τεκμηρίωση του API βρίσκεται στην τεκμηρίωση για προγραμματιστές.

Άλλοι προορισμοί

Το "άμεσο" σημαίνει ότι το γράφει το Hermoso. Όλα τα υπόλοιπα είναι ένα βήμα που κάνει μόνο του ένα εργαλείο που ήδη χρησιμοποιείτε.

  • Google Sheets, Google Docs, Google Drive, OneDrive: άμεσο.
  • Looker Studio, Power BI, Tableau: μέσω του φύλλου, με τον δικό καθενός connector για Google Sheets.
  • BigQuery: μέσω του φύλλου, ή μέσω του δικού σας πράκτορα. Το BigQuery μπορεί να ερωτήσει ένα Google Sheet ως εξωτερικό πίνακα. Αν ο πράκτορας σας τρέχει κάπου με πελάτη BigQuery και τα διαπιστευτήρια του έργου σας, μπορεί να εισάγει τις γραμμές που επιστρέφει το Hermoso κατευθείαν σε πίνακα.
  • Excel: μέσω του φύλλου ή ενός αρχείου. Κατεβάστε το φύλλο ως .xlsx, ή αφήστε τον πράκτορα να αφήσει ένα αρχείο στο Google Drive ή στο OneDrive.
  • PostgreSQL, Redshift, Snowflake ή οποιαδήποτε αποθήκη δεδομένων: μέσω του δικού σας πράκτορα ή του API. Το Hermoso επιστρέφει JSON· ό,τι κρατά τα διαπιστευτήρια της βάσης σας γράφει τα δεδομένα. Το Hermoso δεν κρατά διαπιστευτήρια αποθήκης.

Αυτοματοποίηση της εβδομαδιαίας εξαγωγής

Η προτροπή είναι ο αυτοματισμός. Κάτι σαν "Κάθε Δευτέρα, τράβα την απόδοση του Apple Search Ads της περασμένης εβδομάδας ανά λέξη-κλειδί για κάθε καμπάνια, πρόσθεσέ την στο φύλλο Apple Ads, και πες μου ποιες λέξεις-κλειδιά μετακινήθηκαν περισσότερο στο κόστος ανά απόκτηση" είναι πλήρης δουλειά. Τρέξτε την με τον προγραμματισμό που έχει ήδη ο πελάτης σας (προγραμματισμένες εργασίες στο Claude ή στο ChatGPT, ή μια εργασία cron που καλεί το CLI ή το API του Hermoso), και το φύλλο, μαζί με κάθε πίνακα που το διαβάζει, μένει ενημερωμένο.

Επειδή η ίδια σύνδεση επεξεργάζεται και τον λογαριασμό, η αναφορά και η διόρθωση ζουν στον ίδιο χώρο: ο πράκτορας που βλέπει το κόστος ανά απόκτηση μιας λέξης-κλειδιού να διπλασιάζεται μπορεί να την παύσει ή να προσθέσει αρνητικό στην ίδια συνομιλία.

Συχνές ερωτήσεις

Πώς εξάγω δεδομένα από το Apple Search Ads;

Συνδέστε μία φορά το Apple Ads με το Hermoso, και μετά ζητήστε από τον πράκτορα την αναφορά που θέλετε, για παράδειγμα την απόδοση λέξεων-κλειδιών της περασμένης εβδομάδας. Το εργαλείο apple_ads_report την τραβά από το API αναφορών της Apple, και ο πράκτορας τη γράφει σε Google Sheet, σας δίνει JSON, ή και τα δύο.

Μπορώ να συνδέσω το Apple Search Ads με Google Sheets;

Ναι. Συνδέστε το Apple Ads και το Google Drive στο Hermoso, και μετά ζητήστε από τον πράκτορα να βάλει την αναφορά σε φύλλο. Δημιουργεί το φύλλο με το create_sheet, ή προσθέτει γραμμές σε υπάρχον με το append_to_sheet, και μπορεί να το επαναλαμβάνει κάθε εβδομάδα.

Μπορώ να εξάγω το Apple Search Ads στο Looker Studio;

Ναι, μέσω των Google Sheets. Το Hermoso δεν έχει εγγενή connector για το Looker Studio. Ο πράκτορας γράφει την αναφορά σε φύλλο, εσείς προσθέτετε εκείνο το φύλλο ως πηγή δεδομένων Google Sheets στο Looker Studio μία φορά, και κάθε προσθήκη εμφανίζεται στην επόμενη ανανέωση του πίνακα.

Πώς εξάγω δεδομένα του Apple Search Ads σε JSON;

Καλέστε το POST /v1/tools/apple_ads_report στο API του Hermoso με κλειδί API και διαβάστε το data.rows από την απάντηση, ή τρέξτε το hermoso call apple_ads_report --json '{...}' --structured από το CLI. Και τα δύο επιστρέφουν τις ίδιες γραμμές ως JSON.

Υπάρχει API αναφορών του Apple Search Ads;

Ναι, και το Hermoso είναι χτισμένο πάνω του. Το apple_ads_report καλύπτει την απόδοση σε επίπεδο καμπάνιας, ομάδας διαφημίσεων, διαφήμισης, λέξης-κλειδιού και όρου αναζήτησης, και τα υπόλοιπα εργαλεία Apple Ads χτίζουν και διαχειρίζονται τον λογαριασμό.

Μπορώ να πάρω αναφορές όρων αναζήτησης του Apple Search Ads;

Ναι. Ζητήστε το επίπεδο όρων αναζήτησης και ονομάστε την καμπάνια. Η Apple σερβίρει όρους αναζήτησης μόνο ανά καμπάνια, στη ζώνη ώρας του οργανισμού.

Πόσες γραμμές μπορεί να επιστρέψει μία αναφορά;

Έως 5.000 ανά σελίδα, ταξινομημένες κατά δαπάνη από την υψηλότερη προς τη χαμηλότερη, με ένδειξη που λέει στον πράκτορα αν υπάρχουν κι άλλες σελίδες. Μια εβδομαδιαία αναφορά λέξεων-κλειδιών για τους περισσότερους λογαριασμούς χωράει σε μία σελίδα.

Καλύπτει αυτό τις διαφημίσεις στους Χάρτες Apple;

Ναι. Οι αναφορές για καμπάνιες business-brands έρχονται από το ίδιο εργαλείο, με τον τύπο του promoted object ορισμένο σε Apple Maps αντί για App Store.

Χρειάζομαι προγραμματιστή για να το ρυθμίσω;

Όχι. Συνδέστε το Apple Ads στην εφαρμογή μία φορά και ζητήστε από τον πράκτορα με απλά λόγια: πάρε την περασμένη εβδομάδα ανά λέξη-κλειδί και βάλ' τα σε φύλλο. Το API και το CLI υπάρχουν αν θέλετε να το γράψετε σε σενάριο.

Ξεκινήστε δωρεάν, χωρίς κάρτα, με κάθε δυνατότητα σε κάθε πλάνο.

Ξεκινήστε δωρεάν →   Δείτε τις τιμές