Apple Search Ads verilerini dışa aktarın

Hermoso, Apple Search Ads'e bağlanır ve bunu ajanınızın çağırabileceği araçlar olarak sunar: Claude, ChatGPT, Cursor, Codex, Cline, CLI ya da düz HTTP. apple_ads_report, kampanya, reklam grubu, reklam, anahtar kelime ve arama terimi performansını çeker. Satırlar, bir yere taşımanız gereken bir CSV indirmesi olarak değil, veri olarak geri gelir.

Apple Search Ads bağlayıcısı

Apple reklam API'si için bir OAuth akışı yayımlamaz, bu yüzden bağlantı bir düğme tıklaması değil bir anahtar alışverişidir: Hermoso imza anahtarını üretir, genel yarısını Apple Ads'e yapıştırırsınız ve üç kimliği geri yapıştırırsınız. Apple Search Ads kurulum rehberi adımları anlatır. Çoğu insanın bulamadığı Public Key alanı da buna dahildir. Tek bir bağlantı web uygulamasına, MCP sunucusuna, CLI'ya ve REST API'ye hizmet eder. Böylece aynı dışa aktarma Claude, ChatGPT ya da Cursor'dan çalışır: bir kez Apple Search Ads'i Claude'a ya da ChatGPT'ye bağlayın, sonra sorun.

Raporlama bunun yalnızca bir parçası. Aynı bağlantı hesabı da kurar ve yönetir: kampanyalar, reklam grupları, anahtar kelimeler ve negatifler, bütçe siparişleri, hedefleme, anahtar kelime önerileri ve değişiklik geçmişi. Her aracı görmek için Apple Ads kanal sayfasına bakın.

Raporda neler var

Tek çağrı, beş düzey. apple_ads_report, kampanya, reklam grubu, reklam, anahtar kelime ya da arama terimi düzeyinde raporlar ve her satır Apple'ın kendi panelinin gösterdiği metrikleri taşır: gösterim, dokunma, yükleme, harcama, tıklama oranı, dokunma başına maliyet ve edinme başına maliyet. Toplam isteyebilir ya da saatlik, günlük, haftalık veya aylık bir seri isteyebilirsiniz. Satırlar harcamaya göre, en yüksekten başlayarak, sayfa başına 5.000'e kadar gelir ve istenirse bir genel toplam satırı da eklenir. App Store raporları teslimat olmayan öğeleri de içerebilir, dolayısıyla durdurulmuş bir anahtar kelime boş bir satır yerine sıfır olarak görünür.

Apple'ın uyguladığı iki kural var, araç bunları sessizce başarısız olmak yerine açıklar: kampanya düzeyinin altındaki bir rapor bir kampanya kimliği gerektirir (yalnızca kampanya düzeyindeki bir rapor tüm hesabı kapsayabilir) ve arama terimi raporları UTC'de değil, kuruluşunuzun kendi saat diliminde çalışır. Apple Haritalar'daki reklamlar da kapsanır: işletme markaları raporu aynı araçtan gelir, yalnızca bir parametre değiştirilir.

Apple Search Ads'i Google E-Tablolar'a bağlayın

Hermoso'nun kendisinin yazdığı tek hedef budur. Apple Ads'in yanına Google Drive'ı bağlayın (tek bir Google yetkilendirmesi Drive, Sheets ve Docs'u kapsar), sonra sorun: "Son 30 gün için Apple Search Ads performansını anahtar kelimeye göre çek ve Apple Ads adlı yeni bir e-tabloya koy." Ajan apple_ads_report aracını çağırır, ardından create_sheet ile e-tabloyu oluşturur ve bağlantıyı size verir. Gelecek hafta aynı istek, "ekle" diyerek yapılırsa satırlar baştan başlamak yerine append_to_sheet ile eklenir.

Hermoso, Google'dan drive.file kapsamını ister. Bu kapsam yalnızca Hermoso'nun oluşturduğu dosyalara ve sizin seçtiklerinize erişir, tüm Drive'ınıza asla değil. Bir sekmeyi yerinde değiştirmeyi ve biçimlendirmeyi de içeren tam anlatım: Apple Search Ads'i Google E-Tablolar'a bağlayın.

Apple Search Ads'i Looker Studio'ya aktarın

Hermoso'nun yerel bir Looker Studio bağlayıcısı yok ve bunu var gibi göstermek yerine açıkça söylemeyi tercih ederiz. Buna ihtiyaç da yok: Looker Studio Google E-Tablolar'ı kendi yerleşik bağlayıcısıyla okur, dolayısıyla yukarıdaki e-tablo köprü görevi görür.

1. Ajanın raporu tek bir sekmeye yazmasını isteyin. Günlük granülerlik, gün başına anahtar kelime başına bir satır, bir başlık satırı ve bir tarih sütunu. Looker Studio'nun bunu tarih olarak okuması için tarih sütununun tarih biçiminde olmasını isteyin (format_sheet bunu yapar).
2. E-tabloyu bir veri kaynağı olarak ekleyin. Looker Studio'da bir veri kaynağı oluşturun, Google E-Tablolar'ı seçin, e-tabloyu ve o sekmeyi seçin, "İlk satırı başlık olarak kullan" seçeneğini açık bırakın.
3. Raporu bir kez kurun. Güne göre harcama, anahtar kelimeye göre edinme başına maliyet, kampanyaya göre yüklemeler: her Pazartesi bir e-tabloda yeniden yapacağınız her şey.
4. Eklemeye devam edin. Ajan her hafta yeni satırları aynı sekmeye ekler ve pano bir sonraki veri yenilemesinde bunları alır. Looker Studio alanları başlığa göre eşlediği için sütun adlarını çalıştırmalar arasında aynı tutun.

Aynı e-tablo Power BI ve Tableau için de çalışır, ikisinin de kendi Google E-Tablolar bağlayıcıları var.

Apple Search Ads'i JSON'a aktarın

Bir e-tablo yerine ham satırları istiyorsanız, aynı bağlantıyı kullanarak üç yol var.

REST API. Her Hermoso aracı, MCP & CLI sekmesinde uygulamada oluşturduğunuz bir API anahtarıyla POST /v1/tools/{name} adresinden çağrılabilir. İstek gövdesi aracın argümanlarıdır, yanıtın data alanı yapılandırılmış sonuçtur ve satırlar data.rows içindedir:

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 aynı yapılandırılmış sonucu JSON olarak yazdırır. Bir dosyaya yönlendirmek ya da başka bir betiğe aktarmak için hazırdır.

Ajanınız. Herhangi bir sohbette satırları JSON olarak isteyin, istediğiniz biçimde düzenlenmiş olarak yanıtta gelirler.

Uzun raporlar için limit sayfa başına 5.000 satıra kadar alır, offset bir sonraki sayfaya geçer. Sonucun hasMore alanı başka bir sayfa olup olmadığını söyler. Bir raporu okumak kredi harcamaz. Tam API referansı geliştirici dokümanlarında.

Diğer hedefler

"Doğrudan" demek Hermoso'nun yazdığı anlamına gelir. Diğer her şey, zaten kullandığınız bir aracın kendi yaptığı tek bir adımdır.

• Google E-Tablolar, Google Docs, Google Drive, OneDrive: doğrudan.
• Looker Studio, Power BI, Tableau: e-tablo üzerinden, her biri kendi Google E-Tablolar bağlayıcısıyla.
• BigQuery: e-tablo üzerinden ya da kendi ajanınız üzerinden. BigQuery bir Google E-Tabloyu dış tablo olarak sorgulayabilir. Ajanınız bir BigQuery istemcisi ve proje kimlik bilgileriniz olan bir yerde çalışıyorsa, Hermoso'nun döndürdüğü satırları doğrudan bir tabloya ekleyebilir.
• Excel: e-tablo ya da dosya üzerinden. E-tabloyu .xlsx olarak indirin ya da ajanın Google Drive veya OneDrive'da bir dosya bırakmasını isteyin.
• PostgreSQL, Redshift, Snowflake ya da herhangi bir veri ambarı: kendi ajanınız ya da API üzerinden. Hermoso JSON döndürür. Veritabanı kimlik bilgilerinizi tutan her ne ise onu yazar. Hermoso ambar kimlik bilgilerinizi tutmaz.

Haftalık dışa aktarmayı otomatikleştirmek

İstek otomasyonun kendisidir. "Her Pazartesi, geçen haftanın Apple Search Ads performansını her kampanya için anahtar kelimeye göre çek, Apple Ads e-tablosuna ekle ve edinme başına maliyeti en çok değişen anahtar kelimeleri söyle" gibi bir cümle eksiksiz bir iştir. Bunu, müşterinizin zaten sahip olduğu zamanlamayla çalıştırın (Claude ya da ChatGPT'deki zamanlanmış görevler veya Hermoso CLI'ını ya da API'yi çağıran bir cron işi) ve e-tablo ile ondan okuyan her pano güncel kalır.

Aynı bağlantı hesabı da düzenlediği için rapor ve düzeltme tek bir yerde durur: bir anahtar kelimenin edinme başına maliyetinin iki katına çıktığını fark eden ajan, aynı sohbette onu duraklatabilir ya da bir negatif ekleyebilir.

Sık sorulan sorular

Apple Search Ads verilerini nasıl dışa aktarırım?

Apple Ads'i Hermoso'ya bir kez bağlayın, sonra ajanınızdan istediğiniz raporu isteyin, örneğin geçen haftanın anahtar kelime performansı. apple_ads_report aracı bunu Apple'ın raporlama API'sinden çeker, ajan da bunu bir Google E-Tabloya yazar, size JSON verir ya da ikisini birden yapar.

Apple Search Ads'i Google E-Tablolar'a bağlayabilir miyim?

Evet. Hermoso'da Apple Ads ve Google Drive'ı bağlayın, sonra ajandan raporu bir e-tabloya koymasını isteyin. Ajan create_sheet ile e-tabloyu oluşturur ya da append_to_sheet ile mevcut bir e-tabloya satır ekler ve bunu her hafta tekrarlayabilir.

Apple Search Ads'i Looker Studio'ya aktarabilir miyim?

Evet, Google E-Tablolar üzerinden. Hermoso'nun yerel bir Looker Studio bağlayıcısı yok. Ajan raporu bir e-tabloya yazar, siz o e-tabloyu Looker Studio'da bir kez Google E-Tablolar veri kaynağı olarak eklersiniz ve her ekleme panonun bir sonraki yenilemesinde görünür.

Apple Search Ads verilerini JSON olarak nasıl dışa aktarırım?

Hermoso API'sinde bir API anahtarıyla POST /v1/tools/apple_ads_report çağırın ve yanıttan data.rows alanını okuyun, ya da CLI'dan hermoso call apple_ads_report --json '{...}' --structured komutunu çalıştırın. İkisi de aynı satırları JSON olarak döndürür.

Apple Search Ads için bir raporlama API'si var mı?

Evet ve Hermoso onun üzerine kuruludur. apple_ads_report kampanya, reklam grubu, reklam, anahtar kelime ve arama terimi performansını kapsar, diğer Apple Ads araçları ise hesabı kurar ve yönetir.

Apple Search Ads arama terimi raporlarını alabilir miyim?

Evet. Arama terimi düzeyini isteyin ve kampanyayı adlandırın. Apple arama terimlerini yalnızca kampanya bazında, kuruluşun kendi saat diliminde sunar.

Tek bir rapor kaç satır döndürebilir?

Sayfa başına 5.000'e kadar, harcamaya göre en yüksekten en düşüğe sıralı, ajana daha fazla sayfa olup olmadığını söyleyen bir işaretle. Çoğu hesap için haftalık bir anahtar kelime raporu tek sayfaya sığar.

Bu, Apple Haritalar'daki reklamları kapsıyor mu?

Evet. İşletme markaları kampanyaları için raporlar aynı araçtan gelir, yalnızca tanıtılan nesne türü App Store yerine Apple Haritalar olarak ayarlanır.

Kurulum için bir geliştiriciye ihtiyacım var mı?

Hayır. Apple Ads'i uygulamada bir kez bağlayın, sonra ajanınıza sade bir dille sorun: geçen haftayı anahtar kelimeye göre çek ve bir e-tabloya koy. API ve CLI, betikle otomatikleştirmek isterseniz hazır bekler.