HilltopAds MCP nedir?
MCP Sunucusu (Model Context Protocol), HilltopAds tarafından AI istemcileri için geliştirilen resmi bir bağlayıcıdır. Bağlantı kurulduktan sonra AI, hesabınızdaki verilere erişebilir ve onayınız doğrultusunda kampanya oluşturma veya güncelleme gibi işlemleri güvenli ve özel bir kanal üzerinden gerçekleştirebilir. Böylece verileri manuel olarak kopyalayıp yapıştırmanıza gerek kalmaz.
Kullanıcı adınız ve şifreniz hiçbir zaman AI istemcisiyle paylaşılmaz. Bağlantı, hesabınızdan oluşturduğunuz bir API Anahtarı (API Key) ile yetkilendirilir.
Bağlayıcı, HilltopAds hesabınızı bir dizi Araç (Tools) üzerinden AI'a sunar. AI, isteğiniz için en uygun aracı seçer, çalıştırır ve sonucu tablo, özet veya grafik gibi kolay okunabilir bir formatta sunar.
Bununla neler yapabilirsiniz?
Araçlar iki kategoriye ayrılır:
Okuma İşlemleri (Read Operations): Bakiye, envanter, istatistikler, belirli bir kampanyanın ayrıntıları veya kampanyanın trafik kaynağı listeleri gibi verileri getirir.
İşlem Araçları (Action Operations): Kampanya oluşturma veya güncelleme, kampanyaları başlatma veya durdurma, teklifleri (Bid) ve hedef URL'leri değiştirme, ayrıca trafik kaynağı kara listelerini (Blacklist) ve beyaz listelerini (Whitelist) yönetme gibi hesabınızda değişiklik yapar.
Kullanabileceğiniz araçlar hesap türünüze bağlıdır: Advertiser, Publisher veya her ikisi. Şu anda bağlayıcı toplam 27 işlemi desteklemektedir: Advertiser'lar için 23, Publisher'lar için ise 4 işlem.
İşlem Araçları (Action Operations) yalnızca sizin onayınızdan sonra çalıştırılır. AI istemcileri araçları salt okunur (Read-only) veya yazma/silme (Write/Delete) olarak işaretler ve herhangi bir değişiklik yapmadan önce onayınızı ister.
Hesap ve Raporlama Araçları
Araç | İşlevi |
| Advertiser hesabının mevcut bakiyesini gösterir. |
| Kampanyalarınızı ve bunlara ait reklamları listeler. |
| Tarih, zone, GEO, kampanya, işletim sistemi, saat veya trafik kaynağına göre filtrelenmiş ya da gruplanmış istatistikleri gösterir. |
| Campaign ID kullanarak belirli bir kampanyanın tüm ayrıntılarını görüntüler. |
Kampanya Yönetim Araçları
Not: Bu kılavuzdaki örneklerde asistan, her kampanyayı varsayılan olarak Inactive durumda oluşturur. Böylece bütçe harcanmaya başlamadan önce kampanyanızı inceleyebilirsiniz. Bu, asistanın tercih ettiği varsayılan davranıştır; zorunlu bir kural değildir. Kampanyanın Inactive oluşturulmasını veya hemen başlatılmasını istiyorsanız, bunu isteğinizde açıkça belirtin.
Araç | İşlevi |
| Yeni bir kampanya oluşturur. |
| Kampanya ayarlarını kısmen günceller. |
| Onaylanmış bir kampanyayı etkinleştirir. |
| Yayında olan bir kampanyayı durdurur. |
| Kampanyayı arşive taşır. |
| Kampanyayı arşivden geri yükler. |
| Wildcard GEO için teklif tutarını (Bid) değiştirir. |
| Bir Popunder kampanyasının hedef URL'sini değiştirir. |
| Advertiser hesabındaki tüm reklamlarda kullanılan alan adını (domain) değiştirir. |
Trafik Kaynağı Kara Liste Araçları (Source Blacklist)
Araç | İşlevi |
| Bir kampanyanın trafik kaynağı kara listesini görüntüler. |
| Kara listeye kaynak ekler. |
| Kaynakları kara listeden kaldırır. |
| Kampanyanın kara listesini tamamen temizler. |
| Kara listenin tamamını değiştirir ve kampanyayı BLACKLIST moduna geçirir. |
Trafik Kaynağı Beyaz Liste Araçları (Source Whitelist)
Araç | İşlevi |
| Bir kampanyanın trafik kaynağı beyaz listesini görüntüler. |
| Beyaz listeye kaynak ekler. |
| Kaynakları beyaz listeden kaldırır. |
| Kampanyanın beyaz listesini tamamen temizler. |
| Beyaz listenin tamamını değiştirir ve kampanyayı WHITELIST moduna geçirir. |