Meta Ads CLI Kurulumu: 2026 İçin Adım Adım Eğitim

Meta Ads CLI'yi kurmak için Business Manager'da bir System User oluşturursunuz, ads_management, ads_read ve business_management izinlerine sahip süresi dolmayan bir token üretirsiniz, Reklam Hesabınızı ve Sayfanızı varlık olarak bağlarsınız ve ardından CLI'yi bir yapılandırma dosyası aracılığıyla o token'a yönlendirirsiniz. Bir Business Manager'a, bir Facebook Sayfasına ve Reklam Hesabınızda doğrulanmış bir ödeme yöntemine yönetici erişiminiz varsa tüm süreç yaklaşık 45 dakika sürer.

Bu, AI ajanlarıyla Facebook Reklamları yürütme konulu genel bakışımızın derinlemesine devamıdır. O yazı, birkaç kampanyadan fazlasını yürüten herkes için CLI tabanlı bir kurulumun neden Ads Manager tıklamalarını geçtiğini açıklıyor. Bu yazı ise uygulamalı kılavuz: her adım, kendi yığınımızı oluştururken karşılaştığımız her hata mesajı ve sonunda gerçek bir ilk kampanya yol haritası.

Meta Ads CLI Aslında Ne Yapar

"Meta Ads CLI" tek bir resmi binary değildir. Komut dosyalarınız ile Meta Marketing API arasında oturan ince, sunucu tarafı bir otomasyon katmanıdır. Python veya Node kodu yazarsınız, CLI kimlik doğrulamayı, istek imzalamayı ve uzun ömürlü System User token'ı yönetir ve kampanyalarınız Ads Manager'a kimse tıklamadan graph.facebook.com/v23.0/ üzerinden yayınlanır.

Zor kısım sarmalayıcı kod değil — o yüz satırdır. Zor kısım, Business Manager içindeki, Meta'nın üretim trafiği için gerçekten kabul edeceği bir token üreten 7 adımlı kurulum ritüelidir. Bu ritüel, sonunda her tarayıcı tabanlı otomasyonu bozan OAuth yenileme dansını ve token süresinin dolması sıkıntısını ortadan kaldırır.

Karşılığı gerçek. CLI yığını çalıştığında, 6 reklam varyantlı bir kampanyayı 90 saniyenin altında başlatabilir, dünün performansını cron ile sabah 7:00'de günlük rapora çekebilir ve düşük performans gösteren reklamları otomatik duraklatabilirsiniz — bir kez bile Ads Manager'a giriş yapmadan.

Ön Koşullar

Başlamadan önce bunların yerinde olduğundan emin olun. Herhangi birini atlamak sizi sonra 2 saatlik bir tavşan deliğine sokar.

Yönetici haklarına sahip bir Meta Business Manager hesabına ihtiyacınız var — kişisel Facebook hesapları System User token'ları için çalışmaz. Yalnızca düzenleyici olarak değil, yönetici olarak listelendiğiniz bir Facebook Sayfasına ihtiyacınız var. O Business Manager içinde, doğrulanmış bir ödeme yöntemi ve faturalandırma için onaylanmış en az bir ülkesi olan bir Meta Reklam Hesabına ihtiyacınız var. Trafik yönlendirdiğiniz web sitesi için yapılandırılmış bir Pixel (yeni terminolojide "Veri Kümesi") gerekir. Ve yerel olarak yüklü Python 3.10+ veya Node 18+ ve paket yükleme yeteneği gerekir.

Henüz bir Pixel yoksa, devam etmeden önce bir tane oluşturun. Yalnızca Conversions API (CAPI) kullanmayı planlıyor olsanız bile — biz öyle yapıyoruz — sunucu tarafı olaylar için yönlendirme adresi olarak Pixel ID'sine yine de ihtiyacınız var.

7 Adımlı Kurulum

Bu adımlar sıralıdır. Her biri bir sonrakini açar. İleri atlama, zinciri Meta'nın hata mesajları genellikle yanıltıcı olduğu için hata ayıklanması zor şekillerde kırar.

Adım 1: Bir Business Manager System User Oluşturun

İş Ayarları → Kullanıcılar → System User'lar bölümüne gidin. "Ekle"ye tıklayın ve yeni bir System User oluşturun. İsim API için önemli değildir ama gelecekteki sağduyunuz için önemlidir — altı ay sonra ne yaptığını hatırlamanız için marka-ajanı gibi bir şey adlandırın. Rol olarak "Yönetici"yi seçin ("Çalışan" değil) çünkü yönetici hakları olmayan System User'lar Custom Conversion'ları veya Pixel olaylarını yönetemez.

Yığınımızı oluştururken emaxstudioagent oluşturduk. System User ID'si otomatik olarak atanır (15 haneli numara). Bir kenara not edin.

Adım 2: Marketing API Use Case ile Geliştirici Uygulaması Oluşturun

developers.facebook.com → My Apps → Create App bölümüne gidin. Açılır menüde görürseniz "Marketing API" use case'ini seçin. Yalnızca "Other" görüyorsanız, o da iyi — System User token'ları her iki şekilde de çalışır. Almanca arayüz buna "Werbeanzeigen mit Marketing API" etiketi koyar, İngilizce arayüz ise sadece "Marketing API" veya "Other" der. Her ikisi de aynı token'ları üretir.

Uygulamayı Business tipine ayarlayın, Consumer değil. Sol kenar çubuğundan Marketing API ürününü uygulamaya ekleyin. Uygulama Development Mode'da başlar. System User token'ının gerçek reklamlar için çalışması için onu Live Mode'a taşımanız gerekir (aşağıda daha fazlası).

Live Mode'a geçmek için Meta, herkese açık bir gizlilik politikası URL'si ve bir uygulama simgesi (1024×1024 PNG) gerektirir. Her ikisi de pazarlık konusu değildir. Uygulama simgesinin cilalı olması gerekmez — bir yer tutucu çalışır — ama URL'nin gerçekten bir gizlilik politikası sayfasına çözülmesi gerekir. Bizimkini ana alanımızda /legal adresinde barındırıyoruz.

Adım 3: Süresi Dolmayan Bir System User Token Oluşturun

İş Ayarları → System User'lar → [System User'ınız] → "Generate New Token"a tıklayın. Adım 2'de oluşturduğunuz uygulamayı seçin. Ardından izinleri seçin:

• ads_management — kampanya oluşturmak, düzenlemek ve duraklatmak için gerekli
• ads_read — insights ve raporlama verilerini çekmek için gerekli
• business_management — varlıkları ve özel dönüşümleri yönetmek için gerekli

Süre dolma süresini "Never" olarak ayarlayın. System User token'ları, gerçekten asla süresi dolmayan tek Meta token'larıdır — User Access Token'lar 60 günde sona erer, Page Token'ları türetildikleri User Token'a bağlıdır. Arka uç otomasyonu için OAuth yerine System User kullanmanın tüm amacı budur.

Token'ı hemen kopyalayın. Meta onu bir kez gösterir. Bir secrets yöneticisinde veya chmod 600 ile bir .env dosyasında saklayın. Asla git'e commit etmeyin.

Adım 4: Reklam Hesabını ve Sayfayı Varlık Olarak Bağlayın

System User var ama henüz hiçbir şeye erişimi yok. Varlıkları açıkça atamanız gerekir. İş Ayarları → System User'lar → [System User'ınız] → "Add Assets"a tıklayın.

Reklam Hesabınızı tam izinle ("Manage Campaigns" + "Manage Performance") atayın. Sayfanızı tam izinle atayın. Pixel/Dataset'inizi tam izinle atayın. Birden fazla Reklam Hesabınız varsa ve CLI'nin hepsini yönetmesini istiyorsanız, her birini atayın.

Bunu ayarlarken act_975780295197610 (Reklam Hesabımız) ve 1113585798495892 Sayfası (EMAX Studio sayfamız) artı 1464075091373537 Pixel'i atadık. Reklam Hesabı ID'lerindeki act_ öneki API'yi çağırdığınızda gereklidir — gerçek ID'nin bir parçasıdır, biçimlendirme kuralı değildir.

Adım 5: "Page verwalten" / "Manage Page" İzni Atayın

Bu, ilk seferinde neredeyse herkesi tuzağa düşüren adımdır. Adım 4 Sayfayı varlık olarak atadı, ancak varsayılan izin düzeyi "Anzeigen erstellen" / "Create Ads" — bu yeterli değil. System User'ın Sayfayı referans alan reklam yaratıcılarını yayınlamak için "Page verwalten" / "Manage Page" iznine ihtiyacı vardır.

Bunu atlarsanız, her reklam oluşturma API çağrısı, Sayfadan bahsetmeyen genel bir "permission denied" hatası döndürür. Asıl sorun Sayfa varlık ayarlarında bir tık derinde iken, token kapsamlarınızı ve Reklam Hesabı izinlerinizi kontrol etmek için saatler harcayacaksınız.

Varlık listesindeki Sayfaya tıklayın, izinlere kaydırın ve System User için "Manage Page" düğmesini açın. Kaydedin.

Adım 6: CLI'yi Yükleyin ve Bir Yapılandırma Dosyası Oluşturun

Python için resmi SDK'yı yükleyin:

pip install facebook-business

Node için topluluk tarafından sürdürülen istemciyi kullanın:

npm install facebook-nodejs-business-sdk

~/.meta-ads/config.json adresinde (veya yığınınızın gizli bilgileri depoladığı yerde) bir yapılandırma dosyası oluşturun:

{
  "access_token": "EAA...system-user-token'ınız",
  "app_id": "910292175368026",
  "app_secret": "uygulama-gizliliğiniz",
  "ad_account_id": "act_975780295197610",
  "page_id": "1113585798495892",
  "pixel_id": "1464075091373537",
  "api_version": "v23.0"
}

İzinleri ayarlayın: chmod 600 ~/.meta-ads/config.json. app_secret System User token'ları için isteğe bağlıdır ancak Meta'nın üretim için önerdiği appsecret_proof imzalamayı sağlar.

Adım 7: İlk Test Komutunu Çalıştırın

Kampanyalarınızı listeleyerek her şeyin çalıştığını doğrulayın. Python'da:

from facebook_business.api import FacebookAdsApi
from facebook_business.adobjects.adaccount import AdAccount
import json

cfg = json.load(open("/path/to/config.json"))
FacebookAdsApi.init(access_token=cfg["access_token"])
account = AdAccount(cfg["ad_account_id"])
campaigns = account.get_campaigns(fields=["name", "status", "objective"])
for c in campaigns:
    print(c["name"], c["status"], c["objective"])

Bu bir liste döndürürse (henüz kampanyanız yoksa boş bir liste bile), bitirdiniz. OAuthException veya Permission denied hatası atarsa, aşağıdaki hata tablosuna geri dönün.

Yaygın Kurulum Hataları ve Nasıl Düzeltilir

Bunlar yapım sırasında bizi sokan 8 hatadır. Her biri gerçek saatlere mal oldu. Kendinizi acıdan kurtarın.

Custom Conversion olanı en kötüsüdür çünkü hata mesajı teknik olarak neyin yanlış olduğunu söyler ama geçici çözüm açık değildir. Yeni bir Custom Conversion'ın Meta sisteminde sıfır olayı vardır. Meta, geçmiş verisi olmayan bir şey için bir kampanyayı optimize etmeyi reddeder. Hile, kampanyayı önce Landing Page Views için optimize edilmiş olarak başlatmak, 50+ dönüşümün CAPI üzerinden tetiklenmesine izin vermek, ardından Reklam Setinin promoted_object alanını Custom Conversion ID'nizle OFFSITE_CONVERSIONS'a değiştirmektir. Bundan sonra optimizasyon gerçekten çalışır.

Gerçek Bir İlk Kampanya Yol Haritası

İşte ilk canlı testimiz olarak çalıştırdığımız şey. Gerçek değerler, gerçek akış, gerçek sonuçlar.

Kampanyayı Oluşturun. Amaç: OUTCOME_TRAFFIC (dönüşüm verisi elde ettikten sonra OUTCOME_SALES'a geçildi). Durum: Reklam Seti ve Reklamların altta oluşturulabilmesi için başlangıçta PAUSED, ardından her şey tek bir adımda ACTIVE'e çevrilebilir. Bütçe kurulumumuzda Reklam Seti düzeyinde yaşar.

Reklam Setini Oluşturun. Günlük bütçe: 1000 (cent = $10/gün). Optimizasyon: LANDING_PAGE_VIEWS. Teklif stratejisi: LOWEST_COST_WITHOUT_CAP. Hedefleme: ülkeler ["US", "GB", "CA"], yaş 25 ila 55, dil İngilizce. Yerleşimler: feed, instagram_reels, stories, marketplace. Hedefleme otomasyonu: {"advantage_audience": 1}.

Yaratıcıları Oluşturun. Üç görsel yaratıcı ve üç video yaratıcı — toplam altı reklam. Görseller için kendi EMAX Studio çıktımızı kullandık (kendi köpek mamanızı yiyin): üç hook, üç marka renkli arka plan, hepsi 1080×1080. Videolar için, sözcük sözcük altyazılı ve AI sesli üç 15 saniyelik dikey reel, kendi pipeline'ımız aracılığıyla oluşturuldu (Adım Adım AI Pazarlama Kampanyası Nasıl Oluşturulur'de adım adım anlatıldı). Her video yaratıcı, küçük resim için bir image_hash gerektirir — ffmpeg ile 1.5 saniyede bir kare çıkarın, /adimages'a yükleyin ve döndürülen hash'i video_data bloğu içinde kullanın.

Etkinleştirin. Kampanyayı, ardından Reklam Setini, ardından altı Reklamın hepsini ACTIVE'e çevirin. Meta incelemesi genellikle 15 ila 30 dakika içinde sonuçlanır. Reddedilen reklamlar ad.get('effective_status') aracılığıyla reklam başına yüzeye çıkar.

Günlük Rapor. meta_daily_report.py script'i Berlin saatiyle 7:00'de cron aracılığıyla çalışır. Insights çeker, harcama / CTR / CPM / dönüşümleri Telegram mesajına biçimlendirir ve 100+ gösterimden sonra CTR'si %0.5'in altında olan reklamları otomatik duraklatır. İlk 48 saat 4.200 gösterim, 78 tıklama (CTR %1.86) ve dönüşüm başına $1.67'den 12 Quick Scan tamamlama üretti — üçüncü günde optimizasyonu Landing Page Views'tan QuickScanComplete Custom Conversion'a karşı OFFSITE_CONVERSIONS'a geçirmek için yeterli sinyal.

Kaçınılması Gereken Tuzaklar

Birkaç şey sizi yakar. Bunların her birini zor yoldan öğrendik.

Token'ları git'e hard-code etmeyin. Özel depolar bile. Token'lar CI günlükleri, yanlışlıkla herkese açık fork'lar ve bir deponun görünürlüğü değişmeden önce yapılan commit'ler aracılığıyla sızar. Her zaman ortam değişkenlerinden veya depo dışındaki chmod-600 yapılandırma dosyasından okuyun.

Adım 5'teki Page Manage iznini atlamayın. Aldığınız hatalar Reklam Hesabı veya token hakkındaymış gibi görünür. Değildirler. Yaratıcı oluşturmada belirsiz bir "permission denied" gördüğünüzde her zaman önce Sayfa varlık iznini yeniden kontrol edin.

Geliştirici uygulaması hala Development Mode'dayken dağıtım yapmayın. Token onu oluşturan kullanıcı için çalışır ama herhangi bir başka System User bağlamı için sessizce başarısız olur. Bir sunucuda herhangi bir şey çalıştırmadan önce Live Mode'a geçin.

Video yaratıcılar için image_hash'i unutmayın. O olmadan, tüm Reklam oluşturma video_data hakkında yanıltıcı bir hatayla başarısız olur.

Ölçeklendirmeyi planlıyorsanız CAPI'yi atlamayın. Tarayıcı pixel'leri iOS ATT, reklam engelleyiciler ve izleme önleme nedeniyle olayların %30 ila %50'sini kaybeder. Sunucu tarafı Conversions API çoğunu yeniden yakalar — reklam harcamasını ölçeklendirdiğiniz ilk haftada kendini ödeyen bir hafta sonu işi.

Sıkça Sorulan Sorular

Meta Ads CLI'yi kurmanın maliyeti nedir?

Kurulumun kendisi ücretsizdir. Marketing API, System User token'ları, Business Manager ve tüm geliştirici araçları sıfır maliyetlidir — yalnızca gerçekten yürüttüğünüz reklamlar için ödeme yaparsınız. İlk seferinde 4 ila 6 saatlik kurulum süresi ve sonrasında her seferinde 30 dakika planlayın.

Bir CLI kurulumu üzerinden birden fazla reklam hesabı çalıştırabilir miyim?

Evet ve bu, ajansların System User token'larını kullanmasının ana nedenlerinden biridir. İş Ayarları'nda her Reklam Hesabını varlık olarak ekleyin ve yapılandırmanızdaki ad_account_id'yi değiştirerek veya parametre olarak ileterek herhangi birini hedefleyebilirsiniz. Bir System User token'ı, izinler yerindeyse birden fazla Business Manager'da yüzlerce Reklam Hesabını yönetebilir.

Peki bir Google Ads CLI — kurulum benzer mi?

Kavram benzerdir ancak Google'ın kurulumu daha sertdir. Google, 7 ila 21 gün sürebilen bir geliştirici token onayı, periyodik olarak süresi dolan OAuth2 yenileme token'ları ve ek bir MCC (Yönetici Hesabı) izinleri katmanı gerektirir. Meta'nın System User token'ı, iki sistemden gerçekten daha basit olanıdır. Her iki platformu da çalıştırırsanız, kalıpları öğrenmek için önce Meta'yı kurun.

Bir token tehlikeye girerse güvenli bir şekilde nasıl rotate ederim?

Yeni bir System User token oluşturun (aynı izinler, aynı "Never" süre dolması), yapılandırmanızı güncelleyin, yeni token'ın çalıştığını test edin, ardından eski olanı iptal edin. Meta, aynı System User için birden fazla aktif token'ı aynı anda tutmanıza izin verir, böylece kesinti olmadan rotate edebilirsiniz. Bir token sızdırılırsa, hemen iptal edin ve yetkisiz kampanyalar için API üzerinden son reklam harcamasını denetleyin.

Conversions API (CAPI) bu kuruluma nasıl uyar?

CAPI ayrı ancak tamamlayıcı bir sistemdir. Meta Ads CLI kampanyaları, reklam setlerini ve reklamları yönetir. CAPI, bu reklamların karşı optimize ettiği sunucu tarafı dönüşüm olayları gönderir. Her ikisi de aynı Pixel ID'sini kullanır. CAPI olayları, herhangi bir tarayıcı pixel'inden bağımsız olarak akar — çerez içermediği ve PII iletim öncesi hash'lendiği için GDPR-temiz izlemenin temelidirler. AI ajanlarıyla AI Facebook Reklamları genel bakışı CAPI'nin daha büyük otomasyon yığınına nasıl uyduğunu kapsar.

Dürüst Alt Çizgi

Meta Ads CLI sihir değildir. İş akışınızdan üç şeyi kaldırmanın disiplinli bir yoludur: OAuth token yenilemeleri, manuel Ads Manager girişleri ve bir reklam başlattığınız her seferinde 14 ayarda tıklamanın insan hatası maliyeti. Çalıştığında, eskiden 30 dakika süren işi 90 saniyede yaparsınız.

Kurulum, Meta'nın araçları zor olduğu için zorludur. Ancak adımlar belirleyicidir. 7 adımlı kurulumu tam olarak takip edin, tablodaki 8 hataya dikkat edin ve öğleden sonranın sonunda üretim sınıfı bir reklam yığınına sahip olacaksınız. CLI'nin AI yaratıcılarına ve günlük raporlamaya nasıl bağlandığının daha geniş resmi için AI ajanlarıyla Facebook Reklamları ve bu yıl reklam ekosisteminde nelerin değiştiğine bakmak için 2026'nın 18. haftasında AI haberleri genel bakışımıza bakın.

CLI canlıya geçtiğinde, soru ona hangi yaratıcıları besleyeceğiniz olur. Açılış sayfanızı emax.studio'da ücretsiz 90 saniyelik bir AI-hazırlık taramasından geçirin — iki dakikanın altında bir puan, dönüşüm boşluklarının listesi ve çalışmaya hazır bir kampanya brief'i alırsınız.

EMAX Studio'yu takip edin: Instagram | YouTube | Facebook