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

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

Πώς μοιάζει στην πράξη

"Βάλε την απόδοση του Apple Search Ads ανά λέξη-κλειδί της περασμένης εβδομάδας στο φύλλο Apple Ads." Ο πράκτορας καλεί την αναφορά, διαμορφώνει τις γραμμές και τις προσθέτει στο τέλος. Ρωτήστε ξανά τη Δευτέρα και το φύλλο μεγαλώνει μία εβδομάδα.

Το scope του Drive που ζητά το Hermoso είναι το drive.file, που φτάνει σε αρχεία που δημιούργησε ή που επιλέγετε, όχι σε ολόκληρο το Drive σας.

Πώς συνδέεται το Apple Search Ads με Google Sheets

1. Συνδέστε και τους δύο λογαριασμούς. Στην εφαρμογή, ανοίξτε τους Σύνδεσμοι (Connectors) και συνδέστε το Apple Ads, μετά το Google Drive. Τα Sheets και τα Docs ακολουθούν την ίδια εξουσιοδότηση Google, οπότε είναι μία οθόνη συναίνεσης, όχι τρεις. Το Apple Ads είναι ανταλλαγή κλειδιού και όχι κουμπί· ο οδηγός ρύθμισης του Apple Search Ads το καλύπτει, μαζί με το πώς να συνδέσετε το Apple Search Ads με το Claude ή με το ChatGPT, όπου θα πληκτρολογείτε το αίτημα.
2. Ζητήστε την πρώτη εξαγωγή. "Τράβα την απόδοση του Apple Search Ads ανά καμπάνια για τις τελευταίες 30 ημέρες και βάλ' την σε νέο φύλλο με όνομα Apple Ads." Ο πράκτορας καλεί το apple_ads_report, μετά το create_sheet, και σας δίνει τον σύνδεσμο.
3. Κάντε την επαναλαμβανόμενη. Η ίδια φράση με το "append" αντί για "νέο φύλλο", τρέχοντας σε πρόγραμμα από τον πελάτη που χρησιμοποιείτε (προγραμματισμένη εργασία στο Claude ή στο ChatGPT, ή εργασία cron που καλεί το CLI του Hermoso), προσθέτει ένα νέο μπλοκ γραμμών κάθε φορά. Τίποτε δεν αντικαθίσταται αν δεν το ζητήσετε.
4. Δείξτε τον πίνακά σας στο φύλλο. Το Looker Studio, το Power BI και το Tableau διαβάζουν όλα τα Google Sheets με τους δικούς τους connectors.

Πώς μοιάζει το φύλλο

Μία γραμμή ανά οντότητα και ανά περίοδο. Οι στήλες ακολουθούν το επίπεδο που ζητήσατε (καμπάνια, ομάδα διαφημίσεων, διαφήμιση, λέξη-κλειδί ή όρος αναζήτησης) συν τα μετρικά που αναφέρει η Apple: εμφανίσεις, πατήματα, εγκαταστάσεις, δαπάνη, ποσοστό κλικ, κόστος ανά πάτημα και κόστος ανά απόκτηση. Αν ζητήσετε ημερήσια κατανομή, κάθε οντότητα παίρνει μία γραμμή την ημέρα· αν ζητήσετε σύνολα, παίρνει μία. Ο πράκτορας μπορεί να προσθέσει γραμμή συνολικών, και στις αναφορές App Store μπορεί να κρατήσει οντότητες χωρίς καμία απόδοση, ώστε μια σε παύση λέξη-κλειδί να εμφανίζεται ως μηδέν και όχι να εξαφανίζεται.

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

Προσθήκη, αντικατάσταση ή μορφοποίηση

Τα εργαλεία Sheets καλύπτουν ολόκληρη την επεξεργασία: το append_to_sheet προσθέτει γραμμές, το update_sheet γράφει μια περιοχή στη θέση της, το clear_sheet_range αδειάζει μία πρώτα όταν θέλετε αντικατάσταση και όχι στοιβαγμένες γραμμές, το format_sheet χειρίζεται επικεφαλίδες, πλάτη και μορφές αριθμών, και το manage_sheet_tabs δίνει σε κάθε καμπάνια ή σε κάθε μήνα τη δική της καρτέλα. Ένα αίτημα "ανανέωσε τον πίνακα" είναι ένα καθάρισμα ακολουθούμενο από εγγραφή, πάνω στην καρτέλα που ονομάζετε.

Εξαγωγή του Apple Search Ads στο Looker Studio από το φύλλο

Το Hermoso δεν έχει εγγενή connector για το Looker Studio· το φύλλο είναι η γέφυρα. Στο Looker Studio, δημιουργήστε πηγή δεδομένων, επιλέξτε Google Sheets, και διαλέξτε το υπολογιστικό φύλλο και την καρτέλα στην οποία γράφει ο πράκτορας. Χτίστε την αναφορά μία φορά και αφήστε την. Κάθε προσθήκη εμφανίζεται στην επόμενη ανανέωση δεδομένων του πίνακα, εφόσον οι επικεφαλίδες των στηλών μένουν ίδιες ανάμεσα στις εκτελέσεις. Το ίδιο μοτίβο δουλεύει και για το Power BI και το Tableau.

Θέλετε JSON αντί για φύλλο;

Η ίδια αναφορά είναι διαθέσιμη ως ακατέργαστο JSON από το API του Hermoso (POST /v1/tools/apple_ads_report) ή από το CLI. Δείτε το Εξαγωγή του Apple Search Ads σε JSON, και το Εξαγωγή δεδομένων από το Apple Search Ads για κάθε άλλον προορισμό.

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

Πώς συνδέω το Apple Search Ads με Google Sheets;

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

Χρειάζεται το Hermoso πρόσβαση σε ολόκληρο το Google Drive μου;

Όχι. Ζητά το drive.file, που καλύπτει αρχεία που δημιούργησε το Hermoso και αρχεία που επιλέγετε ρητά.

Ποια επίπεδα και μετρικά μπορούν να μπουν στο φύλλο;

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

Θα αντικαταστήσει μια προγραμματισμένη αναφορά το φύλλο μου;

Όχι, εκτός αν το ζητήσετε. Οι προσθήκες προσθέτουν γραμμές· η αντικατάσταση είναι ένα καθάρισμα ακολουθούμενο από εγγραφή στην καρτέλα που ονομάζετε, και ο πράκτορας το κάνει μόνο όταν το αίτημα το λέει.

Μπορούν το Looker Studio ή το Power BI να διαβάσουν το αποτέλεσμα;

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

Μπορεί η αναφορά να τρέχει με πρόγραμμα;

Ναι, από τον πελάτη μέσα στον οποίο τρέχει ο πράκτορας: μια προγραμματισμένη εργασία στο Claude ή στο ChatGPT, ή μια εργασία cron που καλεί το CLI ή το API του Hermoso. Κάθε εκτέλεση τραβά τη νέα περίοδο και την προσθέτει.