Taboola API Rehberi: Backstage Endpoint'leri, Kimlik Doğrulama ve Gerçek Kullanım Alanları

Taboola API'si — resmi olarak Backstage API — reklamverenler için Taboola'nın REST arayüzüdür. OAuth 2.0 istemci kimlik bilgileriyle kimlik doğrulaması yaparsınız, ardından Ads Konsolu'nda dokunabildiğiniz her şeyi okur ve yazarsınız: kampanyalar, reklam öğeleri, hedefleme, bütçeler ve performans raporları, hepsi https://backstage.taboola.com/backstage/api/1.0/{account_id}/… altında. Medya alıcılarının teklif ve bütçe değişikliklerini otomatikleştirmek, reklam öğelerini toplu yüklemek, harcamaları bir depoya senkronize etmek ve Taboola'nın kullanıcı arayüzünün sunmadığı kurallar motorlarını oluşturmak için kullandığı katmandır. Kasıtlı olarak açığa çıkarmadığı şey ise başkalarının verileridir — ağın rekabetçi görünümü için tamamen farklı bir API'ye ihtiyacınız vardır, bunu son bölümde ele alıyoruz.

Backstage API'sinin kapsadıkları#

Backstage, reklamveren konsolunu neredeyse bire bir yansıtır. Pratikte, işin çoğunu dört alan yapar:

• Kampanya yönetimi. Kampanyalar oluşturma, okuma, güncelleme ve duraklatma; CPC'ler, günlük ve toplam bütçeler, coğrafi/platform hedefleme ve site engelleme ayarlama. Gece sayılarını kontrol ettikten sonra sabah 7'de elle değiştireceğiniz her şey bir betik olabilir.
• Öğeler (reklamlar). Her kampanya, gerçekten sunulan — resim-artı-başlık birimleri olan — öğeler içerir. API, öğeleri toplu eklemenize, durumlarını güncellemenize ve öğe başına inceleme durumunu okumanıza izin verir; bu, büyük hesapların onlarca reklam varyantını kullanıcı arayüzüne dokunmadan nasıl gönderdiğidir. (İlk kampanyalarınızı hala manuel olarak kuruyorsanız, Taboola kampanya kurulumu adım adım rehberimizle başlayın — API, konsolun kavramlarını zaten bildiğinizi varsayar.)
• Raporlama. Boyuta göre dilimlenmiş — gün, kampanya, site, ülke, platform, öğe — toplu performans endpoint'leri, herhangi bir otomatik optimizasyon için ham malzeme.
• Sözlükler. Diğer her şeyin bağlı olduğu numaralandırmalar için arama endpoint'leri: ülke kodları, platformlar, kitle segmentleri.

Erişim, hesabınız için verilen bir istemci kimliği ve sırrı olarak gelir — tarihsel olarak Taboola hesap yöneticiniz aracılığıyla talep edilir — ve resmi Backstage referansı, güncel endpoint şekilleri ve erişim prosedürleri için kesin kaynaktır. Aşağıdaki endpoint yolları bu yazının yazıldığı tarih itibarıyla günceldir; geliştirme yapmadan önce referansla doğrulayın.

Kimlik doğrulama: istemci kimlik bilgilerinden taşıyıcı token'a#

Backstage, standart OAuth 2.0 istemci kimlik bilgileri akışını kullanır. Kimliğinizi ve sırrınızı bir token için takas edin:

curl -X POST "https://backstage.taboola.com/backstage/oauth/token" \
  -d "client_id=YOUR_CLIENT_ID" \
  -d "client_secret=YOUR_CLIENT_SECRET" \
  -d "grant_type=client_credentials"

Yanıt, her çağrıda bir taşıyıcı başlık olarak gönderdiğiniz bir access_token içerir:

curl "https://backstage.taboola.com/backstage/api/1.0/users/current/allowed-accounts" \
  -H "Authorization: Bearer YOUR_TOKEN"

Bu allowed-accounts çağrısı doğru ilk istektir: diğer tüm endpoint'lerin yolunda ihtiyaç duyduğu account_id değerlerini (sayısal kimlikler ve okunabilir isimler) döndürür. Token'ların süresi dolar — gecikme ve token isteklerinin veri isteklerinden daha agresif bir şekilde hız sınırlı olması nedeniyle, her istek için yeni bir token oluşturmak yerine bir token'ı önbelleğe alın ve 401 hatasında yenileyin.

Gerçekte kullanacağınız endpoint'ler#

Raporlama endpoint'leri start_date ve end_date sorgu parametrelerini artı isteğe bağlı filtreleri alır ve dimension segmenti (day, campaign_breakdown, site_breakdown, country_breakdown, platform_breakdown…) dilimi belirler. site_breakdown, optimizasyon için en önemli olanıdır: engelleme listesi otomasyonunu yürüten yayıncı başına performans beslemesidir.

Medya alıcılarının gerçekte otomatikleştirdikleri#

API, kurulum maliyetini dört tekrarlayan işte karşılar:

1. Kurallar motorları. Klasik: her saat, aktif kampanyalar için site_breakdown çekin; sıfır dönüşümle hedef CPA'nın N katından fazla harcama yapmış herhangi bir site, bir kampanya güncellemesi aracılığıyla kampanyanın engellenen siteler listesine eklenir. Bu, her ciddi Taboola reklamvereninin manuel olarak çalıştırdığı aynı 'kaybedenleri kes' döngüsüdür — kodlanmış, duygusuz ve gece 3'te çalışan.
2. Teklif yönetimi. Hedefi yenen günlerde ve coğrafyalarda kampanya CPC'lerini (ve mevcut olduğunda site başına teklif değiştiricilerini) yukarı, CPA saparsa aşağı çekmek — küçük, sık, sıkıcı ancak biriken ayarlamalar.
3. Toplu reklam operasyonları. Kampanya başına 30 başlık/resim varyantı yüklemek, haftalık olarak medyan CTR'nin altındaki her şeyi duraklatmak ve bir öğleden sonra tıklamadan yorulma öncesinde reklam rotasyonunu sürdürmek.
4. Harcama boru hatları. campaign-summary raporunu güne göre geceleyin depoya çeken bir iş, böylece Taboola harcaması, dönüşüm geliri ve diğer tüm kanallar bir panoda yan yana gelir.

Minimal bir entegrasyon planı#

Sıfırdan başlıyorsanız, bu sıralama sizi yaklaşık bir günlük çalışmayla faydalı otomasyona götürür, her adım bir sonrakinden önce doğrulanabilir:

1. Token gidiş-dönüşü. Kimlik bilgilerini bir token için takas edin ve allowed-accounts çağrısı yapın. Bu çalışırsa, kimlik doğrulama ve izinler çözülmüştür.

2. Salt okunur raporlama. Geçen hafta için campaign-summary raporunu güne göre çekin ve sayıları Ads Konsolu ile karşılaştırın. Okumalarınız kullanıcı arayüzünün gösterdiğiyle eşleşene kadar hiçbir şey yazmayın.

3. Tek bir güvenli değişiklik. Bir test kampanyasını PUT aracılığıyla duraklatın ve duraklatmayı kaldırın. Değişikliğin konsolda göründüğünü ve sunum durumunun takip ettiğini onaylayın.

4. Gece harcama senkronizasyonu. Rapor çekimini veritabanınıza zamanlayın. Bu tek başına, çoğu ekip için entegrasyonu haklı çıkarır.

5. Kurallar motoru, kuru çalıştırmada. Site engelleme kararlarını hesaplayın ve yazmasına izin vermeden önce bir hafta boyunca ne olacağını kaydedin. Seçimlerini elle yaptığınız seçimlerle karşılaştırmak, yapacağınız en ucuz kalite kontrol olacaktır.

Doğrudan beşinci adıma atlamak standart hatadır — canlı bir reklam hesabına karşı yazma yolu hataları pahalı derslerdir.

Hız sınırları ve pratik dikkat edilmesi gerekenler#

• Tavanı saygıyla karşılayın. Backstage hesap başına hız sınırları uygular; toplu okumalar yapın (saatte bir kampanya başına bir rapor çağrısı, dakikada bir değil) ve 429 hatalarında geri çekilin. Varsaymak yerine güncel limitler için referansı kontrol edin.
• Raporlama, sunumdan geri kalır. Son saatlerdeki veriler zamanla oturur; kuralları en az birkaç saat eski verilere karşı oluşturun yoksa eksik sayılarla kampanyaları duraklatırsınız.
• Düzenlemeler anlık değildir. Kampanya değişiklikleri sunuma gecikmeyle yayılır ve öğe düzenlemeleri incelemeyi yeniden tetikleyebilir. Otomasyon, 'başarısız' yazma işlemlerini yeniden vermek yerine bu boşluğa tolerans göstermelidir.
• İsimleri değil, kimlikleri saklayın. Kampanya ve öğe isimleri insanlar tarafından düzenlenir; sayısal kimlikler sabit birleştirme anahtarlarıdır.
• Yazma yolunu koruyun. Bir hatası olan bir kurallar motoru, bir hesabın tüm harcamasını duraklatabilir veya bir teklifi 10 katına çıkarabilir. Her değişikliği kaydedin, sağduyu sınırları ekleyin (bir teklifi bir geçişte asla %X'ten fazla değiştirmeyin) ve yeni herhangi bir kuralı kuru çalıştırma modunda başlatın.

Diğer Taboola API'si: rekabetçi veri#

Yukarıdaki her şey tam olarak bir hesabı görür: sizinkini. Backstage size hangi reklamverenlerin sektörünüzde ölçeklendiğini, hangi reklamları çalıştırdıklarını veya bir rakibin kampanyasının ne kadar süre hayatta kaldığını asla söylemeyecek — ağ kendi reklam kütüphanesini yayınlamaz ve resmi bir endpoint diğer reklamverenlerin aktivitesini açığa çıkarmaz.

Bu, OpenAdLibrary'nin geliştirici API'sinin kapattığı boşluktur. İndeks, 49 ağda 725.000'den fazla yerel reklamdan oluşan bir koleksiyon içinde 206.000'den fazla canlı Taboola reklam öğesi (Temmuz 2026) barındırır ve Taboola reklam kütüphanesinin arkasındaki aynı veri REST üzerinden sorgulanabilir: reklamveren, sektör, coğrafya ve uzun ömre göre reklam öğelerini arayın; başlıkları ve açılış sayfalarını çekin; rakiplerin kampanyaları ne zaman başlatıp sonlandırdığını takip edin. Yerel reklam verisi API rehberi endpoint'leri belgeler ve iş akışınız bir LLM ajanında yaşıyorsa, aynı koleksiyonu Claude ve ChatGPT için araçlar olarak açığa çıkaran bir MCP sunucusu vardır. Ücretsiz bir anahtar hafif kullanımı kapsar ve fiyatlandırma geri kalanı için sabit kalır; programatik reklam istihbarat erişiminin daha geniş manzarası API'si olan reklam casus araçları yazısında incelenmiştir.

İki API doğal olarak birleşir: Backstage yürütmeyi hesabınızda otomatikleştirir, istihbarat API'si araştırmayı herkesin hesabında otomatikleştirir. Otomasyondan en çok faydayı alan alıcılar her ikisini de çalıştırır — kendi kampanyalarını budanmış tutan bir kurallar motoru ve sektörlerinde yeni bir reklamveren ölçeklenmeye başladığında işaret veren, böylece bir sonraki testin asla kör seçilmediği rekabetçi bir besleme. Tarayıcıda rekabetçi koleksiyonu görmek için Taboola casus aracıyla başlayın, ardından iş akışı kanıtlandığında aynı sorguları programatik olarak alın.