Facebook (Meta) Reklam Kitaplığı API'si Nasıl Kullanılır

Referans verdiğimiz Facebook Reklam Kütüphanesi API'si olarak bilinen Facebook/Meta Reklam Kütüphanesi API'si, geliştiricilere Facebook, Instagram ve diğer Meta'ya ait platformlarda (örn. WhatsApp ve Threads) yayınlanan reklamlara erişim sağlayan herkese açık bir arayüzdür. Bu API aracılığıyla anahtar kelimeye, sayfa kimliğine, ülkeye veya reklam türüne göre reklam arayabilir ve reklam kreatifleri, harcama aralıkları, gösterimler, yayıncı platformları ve çok daha fazlası gibi meta verileri alabilirsiniz.

Bu API, şeffaflık araştırmaları, pazarlama denetimleri, rekabet analizi, reklam yaratıcılığı analizi veya sosyal medya reklam verileri etrafında araçlar oluşturmak için özellikle kullanışlıdır. İster aktif reklamları izlemek, ister politik veya sosyal konulu reklamları (SIEP reklamları) incelemek, ister pazarlama stratejilerini analiz etmek isteyin, Facebook Reklam Kütüphanesi API'si reklam verilerine güçlü bir kapı açar.

Facebook Reklam Kütüphanesi API'sini Neden Kullanmalısınız ve Bu Size Neler Sağlar?

Facebook Reklam Kütüphanesi API'sinin temel yeteneklerinden bazıları:

1. Anahtar kelimelere, sayfa kimliklerine, ülkeye, reklam türüne göre arama yapma — reklamları içeriklerine, yerleştirenlere, yayınlandıkları yerlere ve kampanya türlerine göre daraltabilirsiniz.
2. Duruma göre filtreleme: aktif/pasif, harcama aralıkları, gösterimler — yalnızca şu anda yayınlanan reklamları veya belirli harcama eşiklerinin üzerindeki/altındaki reklamları istediğinizde yardımcı olur.
3. Reklam meta verilerini alma — page_name, ad_snapshot_url, spend, impressions, publisher_platforms (Facebook/Instagram) gibi alanlar ve daha fazlası dahil.
4. Uzun vadeli ve geniş veri kapsamı desteği — örneğin, SIEP reklamları için küresel olarak ve genel reklamlar için birçok bölgede (2025 itibarıyla Meta'nın bölge politikalarına tabi olarak).
5. Herkese açık verilere ücretsiz erişim — doğru erişim kurulumuna sahip olduğunuz sürece herkese açık reklam verilerini almak için peşin maliyet yoktur.

Kısacası – API, reklam verilerini büyük ölçekte keşfetmek ve toplamak için yapılandırılmış, programlanabilir bir yol sunar.

Adım Adım Kılavuz: Facebook Reklam Kütüphanesi API'sine Nasıl Başlanır?

Adım 1: Facebook/Meta Hesabınızı ve Kimliğinizi Doğrulayın

• Facebook hesabınıza giriş yapın/oluşturun (kişisel veya işletme).
• Hesabınızın doğrulanmış olduğundan emin olun (Meta bazen API erişimi için kimlik doğrulaması gerektirir). (Hesap doğrulaması)
• Bu adım, özellikle bir uygulama aracılığıyla reklam kütüphanesi verilerine erişim talep etmeyi planlıyorsanız önemlidir.

Adım 2: Bir Meta Geliştirici Uygulaması Kaydedin

• Meta for Developers adresini ziyaret edin → "Başlayın" ve platforma giriş yapın. (Buraya tıklayın)

• Yeni bir Uygulama oluşturun: reklam yapmıyorsanız "Diğer" veya genel bir tür seçin.

• Pazarlama API'lerine / Reklam Kütüphanesine erişim istediğinizi seçin.

• Başlangıçta, uygulama Geliştirme modunda olacaktır — bu, temel testler ve küçük ölçekli kullanım için yeterlidir.

Adım 3: Bir Erişim Tokenı Oluşturun

• Bir kullanıcı erişim tokenı oluşturmak için Graph API Explorer'ı veya Meta'nın araçlarını kullanın.
• Tokenın gerekli izinlere sahip olduğundan emin olun (örn. ads_read, muhtemelen Meta'nın gereksinimlerine bağlı olarak ads_archive veya diğerleri). (Facebook for Developers)

Not: Erişim tokenları süresi dolar; kullanımınıza bağlı olarak bunları uzatmanız veya uzun ömürlü tokenlar oluşturmanız gerekebilir.

Adım 4: İlk API Çağrınızı Yapın

/ads_archive uç noktasını (Reklam Kütüphanesi API'sinin kökü) sorgulayabilirsiniz. En son API sürümünü kullanın (örn. v23.0 veya daha yenisi). (Facebook for Developers)

Örnek: curl kullanarak

curl -G \
  -d "search_terms=skincare" \
  -d "ad_reached_countries=['US']" \
  -d "ad_active_status=ACTIVE" \
  -d "fields=page_name,ad_snapshot_url,spend,impressions,publisher_platforms" \
  -d "access_token=YOUR_ACCESS_TOKEN" \
  "https://graph.facebook.com/v23.0/ads_archive"

Örnek: JavaScript (fetch) kullanarak

const response = await fetch(
  `https://graph.facebook.com/v23.0/ads_archive?` +
  `search_terms=skincare&ad_reached_countries=['US']&ad_active_status=ACTIVE` +
  `&fields=page_name,spend,impressions,publisher_platforms` +
  `&access_token=YOUR_ACCESS_TOKEN`
);
const data = await response.json();
console.log(data);

JSON yanıtı, her biri page_name, ad_snapshot_url, harcama aralıkları, gösterim aralığı, yayıncı platformları gibi meta veriler ve potansiyel olarak daha fazla alan içeren bir reklam nesneleri dizisi içerecektir.

Adım 5: Sayfalandırma ve Büyük Sonuçları Yönetme

Reklam Kütüphanesi birçok sonuç döndürebileceğinden, API sayfalandırma kullanır. Sonraki sayfalar arasında döngü yapmak için hazırlıklı olun — yanıtta paging veya imleç tokenlarını inceleyin ve buna göre yineleyin. Geliştiriciler genellikle büyük sonuç kümelerini toplamak için kodda döngüler oluşturur.

Adım 6: Kullanım Durumları — Bu Verilerle Neler Yapabilirsiniz?

Yaygın kullanım durumları şunlardır:

1. Rekabet analizi — bir rakibin Facebook Sayfasından (sayfa kimliği aracılığıyla) reklamlarını alarak yaratıcılıklarını, harcama tahminlerini veya hedefleme erişimini inceleyin.
2. Trend izleme ve araştırma — anahtar kelimeye, bölgeye, medya türüne veya reklam türüne (örn. politik, konut, sosyal konular) göre hangi tür reklamların aktif olduğunu takip edin.
3. Pazarlama zekası panoları — verileri (harcama aralıkları, gösterimler, reklam sıklığı) birleştirin ve zaman içinde veya bölgeler arasında görselleştirin.
4. Reklam yaratıcılığı analizi / ilhamı — ürün ilhamı veya uyumluluk denetimleri için reklam yaratıcılarını (resim/video URL'leri) alın ve arşivleyin.
5. Akademik / şeffaflık araştırması — politik reklamcılık, sosyal sorun kampanyaları veya pazar eğilimleri üzerine çalışmalar için reklam verilerini kullanın.

Bu kullanım durumları, reklam verilerine yapılandırılmış, programlı erişimin değerini vurgulamaktadır.

Facebook Reklam Kütüphanesi API'sini Apidog ile Test Etme

Facebook Reklam Kütüphanesi API'si için bir test alanı olarak Apidog'u kullanın. Apidog'da API'lerinizi test etmeye nasıl başlayacağınız aşağıda açıklanmıştır:

1. Apidog'da yeni bir API uç noktası oluşturun: metodu GET, URL'yi https://graph.facebook.com/v23.0/ads_archive olarak ayarlayın.

2. Sorgu parametreleri altına search_terms, ad_reached_countries, fields ve access_token gibi parametreleri ekleyin.

3. "Gönder"e tıklayın — Apidog verileri getirecek ve size JSON yanıtını yapılandırılmış biçimde gösterecektir.

4. Çoklu parametre kombinasyonlarıyla deneyler yapabilir, sayfalandırmayı test edebilir ve hatta dokümantasyon veya analiz için örnek yanıtları kaydedebilirsiniz.

Bu yaklaşım, hızlı reklam verisi keşfi, arama sorgularını test etme ve tam kod yazmadan entegrasyonlar oluşturma için özellikle kullanışlıdır.

Sıkça Sorulan Sorular

S1. Facebook Reklam Kütüphanesi API'sini kullanmak için özel bir Reklam hesabına veya işletme hesabına ihtiyacım var mı?
Hayır — doğrulanmış bir Meta hesabı genellikle yeterlidir. Ancak, bir Meta Geliştirici Uygulaması kaydetmeli ve uygun izinlere sahip bir erişim tokenı almalısınız (örn. ads_read, ads_archive). Bazı kullanıcıların tam erişim için kimlik doğrulamasını tamamlaması gerekebilir.

S2. Sadece politik veya sosyal konulu reklamlar değil, herhangi bir reklam için veri alabilir miyim?
Evet — API genel reklamları (sadece SIEP değil) destekler. Bölgeye ve reklamın mevcudiyetine bağlı olarak ad_type=all kullanabilir (veya filtreyi atlayabilir) siniz.

S3. Tek bir istekte kaç reklam alabilirim?
Varsayılan olarak, API istek başına sınırlı sayıda reklam döndürür (sayfalandırma). Daha fazlasını almak için, yanıtta sağlanan sayfalandırma imlecini kullanarak sayfalar arasında yineleme yapmanız gerekir.

S4. API aracılığıyla reklam kreatiflerine (görseller, videolar) erişebilir miyim?
Reklamın yaratıcı önizlemesine bağlanan ad_snapshot_url veya benzeri alanları alırsınız. Ancak, Meta her zaman doğrudan medya dosyaları sağlamaz — gerçek görselleri veya videoları almak ek adımlar gerektirebilir.

S5. Veri alımını otomatikleştirmek ve token süresi dolma sorunlarından kaçınmak mümkün mü?
Evet — Meta geliştirici araçlarında uzun ömürlü tokenlar oluşturabilir veya tokenları periyodik olarak yenileyen bir arka uç sistemi kurabilirsiniz. Büyük ölçekli veri alımı için token yönetimini sayfalandırma döngüleriyle birleştirmek yaygındır. Tokenları her zaman güvenli bir şekilde saklayın.

Sonuç

Facebook (Meta) Reklam Kütüphanesi API'si, Meta'nın platformları genelinde reklam kampanyalarını programlı bir şekilde aramayı, toplamayı ve analiz etmeyi sağlayan güçlü, yapılandırılmış bir reklam verisi ağ geçidi sunar. Bunu kullanarak panolar oluşturabilir, rekabet analizi yapabilir, şeffaflık araştırması gerçekleştirebilir veya reklam yaratıcılarını büyük ölçekte toplayabilirsiniz.

Bir Meta geliştirici uygulaması kurarak, uygun bir erişim tokenı alarak ve /ads_archive uç noktasına istekler yaparak — isteğe bağlı olarak Apidog gibi araçlar aracılığıyla test ederek — zengin reklam kütüphanesi verilerini açığa çıkarabilirsiniz. Kısıtlamalar (izinler, hız limitleri, sayfalandırma, medya alımı) olsa da, faydaları genellikle harcanan emeğe değer.

Facebook/Meta'dan herkese açık reklam verilerine ihtiyaç duyan herkes için — Reklam Kütüphanesi API'si değerli, resmi ve esnek bir seçenektir.