Apple Search Ads'i beş dakikada Claude veya ChatGPT'ye bağlayın

Hermoso Apple Search Ads bağlayıcısı, Apple Ads hesabınızı Claude, ChatGPT, Cursor, CLI veya düz HTTP'ye bağlar. Böylece bir yapay zeka ajanı App Store arama reklamlarınızı sizin yerinize yönetebilir. Kampanyayı, reklam grubunu, hedefleme anahtar kelimelerini ve negatif anahtar kelimeleri oluşturur, Apple'ın gerçekten kaydettiğini geri okur ve bir kişinin uygulamayı yüklemeden önce yazdığı arama terimine kadar performansı raporlar. Oluşturulan her şey duraklatılmış olarak gelir ve harcamayı açmak ayrı, açıkça onaylanan bir adımdır. Raporlar bir Google E-Tablo'ya, bir Looker Studio panosuna veya bir JSON dosyasına gidebilir. Apple Ads MCP sayfası bağlayıcının yapabildiği her şeyi listeler.

Bağlantı yaklaşık beş dakika sürer. openssl çalıştırmanız gerekmez ve Apple şifreniz hiçbir noktada Hermoso'ya ulaşmaz.

Apple Search Ads'i Claude'a bağlayın

Apple Search Ads'i Claude'a bağlamak için Hermoso'yu Claude'a bir bağlayıcı olarak ekleyin, sonra Apple Ads hesabınızı Hermoso içinde bir kez bağlayın. Claude'da Customize › Connectors › Add custom connector yolunu açın, adını Hermoso koyun, https://app.hermoso.ai/mcp adresini yapıştırın ve Hermoso hesabınızla onaylayın. Claude'a yapıştıracağınız bir anahtar yok. Ardından Hermoso içinde Ayarlar › Bağlayıcılar yolundan Apple Ads'i bağlayın, adımları bu sayfanın aşağısında bulabilirsiniz. Bu noktadan sonra Claude, Hermoso'nun sahip olduğu her Apple Ads aracını çağırabilir: rapor, anahtar kelime değişikliği ya da yeni kampanya isteyin, sade bir dille yazmanız yeterli. Claude Code'da ise iki komut yeter: /plugin marketplace add hermoso-ai/hermoso, ardından /plugin install hermoso@hermoso. Tüm adımlar için Claude'da Hermoso sayfasına bakın.

Apple Search Ads'i ChatGPT'ye bağlayın

ChatGPT de aynı şekilde çalışır. ChatGPT'de Plugins'i açın, ardından Add › Create MCP App yolunu izleyin, adını Hermoso koyun, Server URL olarak https://app.hermoso.ai/mcp adresini yapıştırın, Authentication'ı OAuth'ta bırakın ve Hermoso hesabınızla onaylayın. Create MCP App görünmüyorsa, Settings › Plugins › Developer mode yolundan Developer mode'u bir kez açın. Apple Ads Hermoso'da bağlıyken ChatGPT anahtar kelime raporunuzu çekebilir, bir Google E-Tablo'ya yazabilir ya da sizin kontrol edeceğiniz bir kampanya taslağı hazırlayabilir. ChatGPT'de Hermoso sayfası adımları anlatır.

Cursor, Codex ve diğer MCP istemcileri

Model Context Protocol kullanan her istemci aynı araçlara aynı adresten ulaşır. Cursor, https://app.hermoso.ai/mcp adresini mcp.json dosyasından okur. Codex, Hermoso eklentisini codex plugin marketplace add hermoso-ai/hermoso komutuyla alır ve aynı araçları terminalden sürer. Hangi istemciyi kullanırsanız kullanın, Apple kimlik bilgileriniz sohbetten geçmez. Ajan Hermoso'nun araçlarını çağırır, Hermoso ise her isteği Apple'a kendi tuttuğu anahtarla imzalar. Tüm araçların listesi için Apple Ads MCP sayfasına bakın.

Bağlandıktan sonra ne sorabilirsiniz

• “Geçen haftanın Apple Search Ads performansını anahtar kelimeye göre çek ve en yüksek edinme başına maliyete sahip on tanesini göster.”
• “Son 30 günün harcamasını, yüklemelerini ve kampanya bazında CPA'sını Apple Ads adlı yeni bir Google E-Tablo'ya yaz.” (Önce Google Drive'ı bağlayın.)
• “Bu ay ABD kampanyamda yüklemeye yol açan ama henüz tam eşleşme anahtar kelimesi olarak teklif vermediğim arama terimleri neler?”
• “Brand reklam grubuna ‘budget planner’ ve ‘expense tracker’ kelimelerini tam eşleşme olarak ekle, ‘jobs’ kelimesini de negatif olarak ekle.”
• “Apple uygulamam için hangi anahtar kelimeleri öneriyor ve zaten teklif verdiklerimde gösterim payım ne kadar?”
• “Uygulamam için Birleşik Krallık'ta günlük 50 dolar bütçeli duraklatılmış bir kampanya kur, sonra Apple'ın ne kaydettiğini göster.”

Bir raporu okumak harcamaya asla dokunmaz. Ajanın oluşturduğu her şey duraklatılmış gelir ve harcamayı açan anahtar, sizin açık onayınızı bekler.

Önce en çok kişiyi durduran şey

Apple'ın kendi talimatı şöyle diyor: “Ads arayüzünden Account Settings › API seçeneğini seçin. Anahtarı Public Key alanına yapıştırın.”

Bu alan bir Account Admin için mevcut değil. Hesabınızın admin'i olarak oturum açın, Account Settings › API bölümünü açın. Ekranda Manage API Access başlıklı bir tablo çıkar (üçüncü taraf hizmet sağlayıcıların listesi ve tek bir Remove Access işlemi) ve sayfanın hiçbir yerinde anahtar alanı yoktur. Bu, eksik bir özellik gibi görünür. İnsanların burada durup API'nin kendileri için kullanılamadığı sonucuna varmasının nedeni de budur.

Ama kullanılabilir. Public Key alanı, bir API rolü taşıyan kullanıcıya aittir ve hesap admin'i olmak bunun yerine geçmez. Apple'ın davet penceresi altı rol sunar, bunlardan tam olarak ikisi API rolüdür:

• API Account Manager: “read and write access to all campaign groups for API management”. Hermoso'nun yalnızca rapor değil, kampanya da oluşturmasını istiyorsanız bunu seçin.
• API Account Read Only: “read only access to all campaign groups for API management”. Yalnızca raporlama için yeterlidir, başka bir işe yaramaz.

Diğer dört rol (Account Admin, Account Finance, Account Read Only ve Limited Access) API kimlik bilgisi üretemez. Bu yüzden çözüm, kendinize gönderdiğiniz bir davettir:

1. Account Settings › User Management bölümünü açın ve Invite Users seçeneğini seçin.
2. Kontrol ettiğiniz bir adresi davet edin (kendi adresiniz ya da kimlik bilgisinin tek bir kişiden bağımsız kalması için ads-api@yourcompany.com gibi ortak bir adres) ve rolü API Account Manager olarak verin.
3. Daveti o gelen kutusundan kabul edin, ardından Apple Ads'e bu kullanıcı olarak giriş yapın.

Artık Account Settings › API üzerinde bir Public Key alanı vardır.

Bağlantı, adım adım

1. Hermoso'da başlatın. Ayarlar › Bağlayıcılar › Apple Ads › Connect. Hermoso bir EC P-256 imza anahtarı üretir (prime256v1 eğrisinde, Apple'ın iki openssl komutunun üreteceği türden bir anahtar) ve size yalnızca genel yarıyı gösterir. Kopyalayın.
2. Genel yarıyı Apple'a verin. API rolü olan kullanıcınızla Account Settings › API bölümünü açın, Public Key alanına yapıştırın ve Save'e basın.
3. Üç kimliği geri kopyalayın. Apple artık o alanın hemen üstünde clientId, teamId ve keyId değerlerini gösterir. Üçünü de kopyalayın.
4. Hermoso'da tamamlayın. Üç kimliği yapıştırın ve kaydedin. Hermoso, bir şey saklamadan önce Apple ile bir token alışverişi yapar ve organizasyon listenizi okur. Böylece yanlış yazılmış bir kimlik hemen burada başarısız olur, yapıştırdığınızı hâlâ görebilirken, bir saat sonra ilk raporda değil.
5. Organizasyonu seçin, kimlik bilgileriniz birden fazlasını kapsıyorsa. Bağlantı seçtiğiniz tek organizasyona sabitlenir.

Bir sorun çıkarsa

API sayfasında Public Key alanı yok

Account Admin olarak ya da dört API olmayan rolden biriyle oturum açmış durumdasınız. Kendinizi API Account Manager olarak davet edin ve o kullanıcı olarak oturum açın (yukarıya bakın). Bir Apple Ads bağlantısının hiç kurulamamasının tek en yaygın nedeni budur.

Apple kimlik bilgilerini reddediyor

Üç kimlik, Apple'ın elinde tuttuğu anahtara ait olmalıdır. clientId, teamId ve keyId değerlerini Public Key alanının hemen üstünden yeniden kopyalayın, değiştirdiğiniz eski bir anahtardan değil. Hâlâ başarısız olursa Hermoso'da bağlantıyı baştan başlatın. Bu, yeni bir anahtar çifti üretir ve yeni genel yarıyı Apple'a yapıştırırsınız.

Kurulum oturumu zaman aşımına uğradı

Hermoso, genel yarıyı Apple'a yapıştırmanız için üretilen özel anahtarı 24 saat tutar. Bu süreden sonra anahtar kasıtlı olarak silinir. Bağlantıyı baştan başlatın ve yeni genel anahtarı yapıştırın.

Zaten openssl ile bir anahtar ürettim

O zaman onu kullanın. Hermoso'nun anahtarını almak yerine bağlanırken mevcut EC P-256 özel anahtarınızı yapıştırın. Apple hesabınızda zaten duran genel anahtar çalışmaya devam eder. Anahtarın bir EC P-256 (prime256v1) olması gerekir. Apple başka bir eğriyi kabul etmez.

Birden fazla Apple Ads organizasyonu yönetiyorum

Her birini kendi Hermoso profilinde bağlayın. Bir bağlantı tek bir organizasyona sabitlenir ve bu, bir ajansın kampanyasının yanlış müşterinin hesabına düşmesini önleyen şeydir.

Apple Search Ads bağlayıcısının yapabildikleri

Oluşturma: create_apple_ads_campaign, create_apple_ads_ad_group, add_apple_ads_keywords, add_apple_ads_negative_keywords, update_apple_ads_object, set_apple_ads_status, delete_apple_ads_object.

Okuma: list_apple_ads_campaigns (durum, sunum durumu, günlük ve toplam bütçe, kampanyanın yayınlandığı ülkeler ve bir kampanya çalışamadığında Apple'ın kendi belirttiği neden), list_apple_ads_ad_groups (varsayılan teklif ve Apple'ın Search Match özelliğinin açık olup olmadığı), list_apple_ads_keywords (hedefleme ve negatif, eşleşme türü ve teklifle birlikte), apple_ads_report (kampanya, reklam grubu, anahtar kelime, arama terimi veya reklam düzeyinde gösterim, dokunma, yükleme, harcama, TTR, CPT ve CPA) ve list_apple_ads_orgs.

Bunların hepsi Claude, Claude Code, Codex, Cursor, Cline, OpenClaw, Hermes ve diğer MCP istemcilerinden, ayrıca web stüdyosundan çağrılabilir. Hangi yoldan giderseniz gidin motor aynıdır. Ayrıntılar için MCP genel bakışına ya da reklam araç referansına bakın.

Ve daha fazlası: reklamları ve reklam öğelerini oluşturur (create_apple_ads_creative, create_apple_ads_ad), tek çağrıda 1.000 anahtar kelimeye kadar yükler (bulk_apple_ads_keywords) ve Apple'ın kendi verilerini okur: apple_ads_keyword_suggestions, apple_ads_impression_share, apple_ads_search_term_popularity ve apple_ads_change_history. Bunların hepsi aynı sohbetten çağrılabilir.

Apple Search Ads verilerini dışa aktarın

Aynı bağlantı raporlama da yapar. apple_ads_report, kampanya, reklam grubu, reklam, anahtar kelime ve arama terimi performansını (gösterim, dokunma, yükleme, harcama, tıklama oranı, dokunma başına maliyet ve edinme başına maliyet) toplam olarak ya da saatlik, günlük, haftalık veya aylık bir seri halinde, sayfa başına 5.000 satıra kadar çeker. Bir raporu okumak harcamaya asla dokunmaz. Satırların nereye gideceği size kalmış. En yaygın üç yer aşağıda. Tam rehber için: Apple Search Ads verilerini dışa aktarın.

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

Apple Ads'in yanına Google Drive'ı bağlayın (tek bir Google yetkilendirmesi Drive, Sheets ve Docs'u kapsar) ve ajanınızdan raporu bir e-tabloya yazmasını isteyin. Ajan apple_ads_report aracını çağırır, ardından yeni bir e-tablo için create_sheet, ya da bu haftanın satırlarını mevcut bir e-tabloya eklemek için append_to_sheet kullanır. Hermoso, Google'dan drive.file kapsamını ister, dolayısıyla yalnızca kendi oluşturduğu ya da sizin seçtiğiniz dosyalara erişir. Adım adım 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. Bunu söylemek, var gibi göstermekten daha iyidir. Yine de buna ihtiyaç yoktur: 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. Looker Studio adımları.

Apple Search Ads'i JSON'a aktarın

Ham satırlar için aracı bir API anahtarıyla Hermoso REST API üzerinden çağırın: POST https://app.hermoso.ai/v1/tools/apple_ads_report, rapor argümanlarını JSON gövdesi olarak gönderin ve yanıttaki satırları data.rows alanından okuyun. Bir terminalden npx -y hermoso call apple_ads_report --json '{...}' --structured aynı sonucu JSON olarak yazdırır. Tam bir örnek istek.

Sık sorulan sorular

Apple Search Ads'i Claude'a nasıl bağlarım?

Hermoso'yu Claude'a https://app.hermoso.ai/mcp adresiyle özel bir bağlayıcı olarak ekleyin, Hermoso hesabınızla onaylayın, sonra Hermoso içinde Ayarlar › Bağlayıcılar yolundan Apple Ads'i bağlayın. Claude, Hermoso'nun Apple Ads araçlarıyla Apple Search Ads kampanyalarınızı raporlayabilir, düzenleyebilir ve oluşturabilir.

ChatGPT Apple Search Ads verilerimi okuyabilir mi?

Evet. ChatGPT'de Plugins › Add › Create MCP App yolunda https://app.hermoso.ai/mcp adresini ekleyin ve Apple Ads'i Hermoso içinde bağlayın. ChatGPT o zaman kampanya, reklam grubu, reklam, anahtar kelime veya arama terimi bazında gösterim, dokunma, yükleme, harcama, TTR, CPT ve CPA değerlerini çekebilir ve satırları bir Google E-Tabloya yazabilir.

Bir Apple Search Ads MCP sunucusu var mı?

Evet. Hermoso'nun barındırılan MCP sunucusu, https://app.hermoso.ai/mcp adresinde, Apple Ads araç setinin tamamını Claude, ChatGPT, Cursor, Codex veya herhangi bir MCP istemcisine açar: raporlama, kampanyalar, reklam grupları, anahtar kelimeler ve negatifler, kreatifler ve reklamlar ile Apple'ın anahtar kelime önerileri. Oluşturulan her şey duraklatılmış gelir.

Apple Ads API sayfasında neden Public Key alanı yok?

Çünkü Account Admin olarak oturum açmışsınız. Apple bu alanı yalnızca bir API rolü taşıyan kullanıcıya gösterir. Bir admin, bunun yerine üçüncü taraf hizmet sağlayıcıların “Manage API Access” tablosunu görür ve sayfanın hiçbir yerinde anahtar alanı bulunmaz. Account Settings › User Management altında kendinizi API Account Manager olarak davet edin, o kullanıcı olarak oturum açın ve alan görünür.

Hangi Apple Ads rolüne ihtiyacım var?

Hermoso'nun kampanya, reklam grubu ve anahtar kelime oluşturmasını istiyorsanız API Account Manager. Apple bunu “read and write access to all campaign groups for API management” olarak tanımlar. Yalnızca raporlama istiyorsanız API Account Read Only yeterlidir. Apple'ın sunduğu diğer dört rol (Account Admin, Account Finance, Account Read Only ve Limited Access) API kimlik bilgisi üretemez.

openssl çalıştırmam gerekiyor mu?

Hayır. Apple'ın kendi talimatı size iki openssl komutu verir. Hermoso EC P-256 anahtar çiftini sizin için üretir ve yalnızca genel yarıyı gösterir. Özel yarı isteklerinizi imzalar ve siz onu hiç görmez, yapıştırmaz ya da saklamazsınız. Başka bir araçtan zaten bir anahtarınız varsa onu getirebilirsiniz.

Apple Ads bağlamak bir maliyete yol açar mı ya da harcama riski taşır mı?

Hayır. Okumalar çağrılması ücretsizdir ve Hermoso'nun oluşturduğu her nesne, hiçbir geçersiz kılma olmadan PAUSED olarak oluşturulur. Bir nesneyi etkinleştirmek, gerçek harcamayı açan tek anahtardır ve açık bir onay gerektirir.

clientId, teamId ve keyId nedir?

Anahtarınızı kaydettikten sonra Apple'ın Public Key alanının üstünde gösterdiği üç tanımlayıcı. Bunlar API kullanıcınızı Apple'a tanıtır, özel anahtar ise bunun gerçekten siz olduğunuzu kanıtlar. Üçünü de Hermoso'ya geri yapıştırdığınızda bağlantı tamamlanır.

Tek bir bağlantı birden fazla Apple Ads organizasyonunu kapsayabilir mi?

Bir bağlantı, onu kurarken seçtiğiniz tek organizasyona sabitlenir. Apple orgId'yi bir kampanya grubu gibi ele alır, bu yüzden tek bir giriş birkaçını kapsayabilir. Her müşterisi için bir organizasyonu olan bir ajans, her birini kendi Hermoso profilinde bağlar.

Anahtarı 180 günde bir döndürmem gerekiyor mu?

Hayır. Apple bir istemci sırrının ömrünü 180 günle sınırlar, bu yüzden Apple'ın kendi talimatı bir yenileme takvimi tutmanızı ister. Hermoso özel anahtarı tutar ve her token alışverişi için kısa ömürlü yeni bir sır üretir. Dolayısıyla süresi dolacak bir yapılandırma dosyasında hiçbir şey yoktur.

Apple Search Ads verilerimi Google E-Tablolar ya da Looker Studio'ya aktarabilir miyim?

Evet. Apple Ads'in yanına Google Drive'ı bağlayın, ajanınız raporu create_sheet ya da append_to_sheet ile bir Google E-Tabloya yazar. Hermoso'nun yerel bir Looker Studio bağlayıcısı yoktur. Looker Studio o e-tabloyu kendi Google E-Tablolar bağlayıcısıyla okur.

Apple Search Ads verilerini JSON olarak alabilir miyim?

Evet. 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 --structured ile hermoso call apple_ads_report komutunu çalıştırın.