Sambung Apple Search Ads ke Google Sheets

Sambungkan Apple Ads dan Google Drive ke Hermoso dan kedua-duanya boleh dipanggil daripada ejen yang sama. apple_ads_report menarik baris prestasi; create_sheet dan append_to_sheet meletakkannya dalam hamparan yang anda miliki. Tiada fail eksport, tiada gudang data, dan tiada alat ketiga yang memegang kelayakan anda.

Rupanya begini

"Tarik perbelanjaan Apple Search Ads minggu lepas mengikut kata kunci dan tambahkannya ke helaian Apple Ads saya." Ejen memanggil laporan itu, membentuk baris dan menambahkannya. Tanya lagi Isnin depan dan helaian itu bertambah seminggu.

Skop Drive yang Hermoso minta ialah drive.file, yang mencapai fail yang dicipta olehnya atau yang anda pilih, bukan seluruh Drive anda.

Cara menyambung Apple Search Ads ke Google Sheets

1. Sambungkan kedua-dua akaun. Dalam aplikasi, buka Penyambung dan sambungkan Apple Ads, kemudian Google Drive. Sheets dan Docs menumpang pada kebenaran Google yang sama, jadi ia satu skrin persetujuan, bukan tiga. Apple Ads ialah pertukaran kunci dan bukan butang; panduan persediaan Apple Search Ads meliputinya, termasuk cara menyambung Apple Search Ads ke Claude atau ChatGPT, tempat anda akan menaip permintaan itu.
2. Minta tarikan pertama. "Tarik prestasi Apple Search Ads mengikut kempen untuk 30 hari terakhir dan letakkannya dalam helaian baharu bernama Apple Ads." Ejen memanggil apple_ads_report, kemudian create_sheet, dan memulangkan pautannya.
3. Jadikannya berulang. Ayat yang sama dengan "append" dan bukannya "helaian baharu", dijalankan mengikut jadual daripada klien yang anda guna (tugas berjadual dalam Claude atau ChatGPT, atau tugas cron yang memanggil CLI Hermoso), menambah satu blok baris setiap kali. Tiada apa-apa yang ditulis ganti melainkan anda memintanya.
4. Tunjukkan dashboard anda ke helaian itu. Looker Studio, Power BI dan Tableau semuanya membaca Google Sheets dengan penyambung mereka sendiri.

Rupa helaian itu

Satu baris setiap entiti setiap tempoh. Lajur mengikut peringkat yang anda minta (kempen, kumpulan iklan, iklan, kata kunci atau istilah carian) ditambah metrik yang Apple laporkan: tayangan, ketikan, pemasangan, perbelanjaan, kadar klik-lalu, kos setiap ketikan dan kos setiap pemerolehan. Minta granulariti harian dan setiap entiti mendapat satu baris sehari; minta jumlah dan ia mendapat satu. Ejen boleh menambah baris jumlah keseluruhan, dan pada laporan App Store ia boleh mengekalkan entiti yang tiada penghantaran supaya kata kunci yang dijeda ditunjukkan sebagai sifar dan bukannya hilang.

Oleh kerana ejen membentuk baris sebelum menulisnya, anda boleh meminta helaian yang tepat seperti yang anda mahu: hanya kata kunci melebihi had perbelanjaan, nama kempen di sebelah id-nya, perubahan minggu-ke-minggu dikira sebelum penulisan. Itu kerja yang akan anda tinggalkan kepada eksport CSV.

Tambah, ganti atau format

Alat Sheets meliputi keseluruhan suntingan: append_to_sheet menambah baris, update_sheet menulis julat di tempatnya, clear_sheet_range mengosongkan julat dahulu apabila anda mahukan penggantian dan bukannya penimbunan, format_sheet mengurus pengepala, lebar dan format nombor, dan manage_sheet_tabs memberi setiap kempen atau setiap bulan tabnya sendiri. Permintaan "segarkan helaian dashboard" ialah pengosongan diikuti penulisan, pada tab yang anda namakan.

Eksport Apple Search Ads ke Looker Studio daripada helaian

Hermoso tidak mempunyai penyambung Looker Studio asli; helaian ialah jambatannya. Dalam Looker Studio, cipta sumber data, pilih Google Sheets, dan pilih hamparan serta tab yang ejen tambahkan. Bina laporan sekali dan biarkannya. Setiap penambahan muncul pada refresh data seterusnya dashboard, selagi pengepala lajur kekal sama antara setiap larian. Pola yang sama berfungsi untuk Power BI dan Tableau.

Mahukan JSON dan bukannya helaian?

Laporan yang sama tersedia sebagai JSON mentah daripada API Hermoso (POST /v1/tools/apple_ads_report) atau CLI. Lihat Eksport Apple Search Ads ke JSON, dan eksport data daripada Apple Search Ads untuk setiap destinasi lain.

Soalan lazim

Bagaimana saya menyambung Apple Search Ads ke Google Sheets?

Sambungkan Apple Ads dan Google Drive dalam Hermoso, kemudian minta ejen anda memasukkan laporan ke dalam helaian. Ia menarik baris dengan apple_ads_report dan menulisnya dengan create_sheet atau append_to_sheet, dan memulangkan pautannya.

Adakah Hermoso memerlukan akses ke seluruh Google Drive saya?

Tidak. Ia meminta drive.file, yang meliputi fail yang dicipta oleh Hermoso dan fail yang anda pilih secara eksplisit.

Peringkat dan metrik apa yang boleh masuk ke dalam helaian?

Peringkat kempen, kumpulan iklan, iklan, kata kunci atau istilah carian, dengan tayangan, ketikan, pemasangan, perbelanjaan, kadar klik-lalu, kos setiap ketikan dan kos setiap pemerolehan, sebagai jumlah atau sebagai siri setiap jam, harian, mingguan atau bulanan.

Adakah laporan berjadual akan menulis ganti helaian saya?

Tidak melainkan anda memintanya. Penambahan menambah baris; penggantian ialah pengosongan diikuti penulisan pada tab yang anda namakan, dan ejen hanya melakukannya apabila permintaan itu menyatakannya.

Bolehkah Looker Studio atau Power BI membaca hasilnya?

Boleh. Hermoso tidak mempunyai penyambung asli untuk mana-mana satu, tetapi kedua-duanya membaca Google Sheets dengan penyambung mereka sendiri, jadi dashboard yang dibina atas helaian itu segar semula apabila ejen menambah padanya.

Bolehkah laporan dijalankan mengikut jadual?

Boleh, daripada klien tempat ejen anda berjalan: tugas berjadual dalam Claude atau ChatGPT, atau tugas cron yang memanggil CLI atau API Hermoso. Setiap larian menarik tempoh baharu dan menambahkannya.