Meta Ad Library API Sınırları: Geri Dönmeyen Alanlar

10 min read

Reviewed by

Daily Intel Research Team

Evidence base

VSLs, ads, funnels, UTMs, transcripts, and market pattern review

Coverage

14+ languages · blackhat, greyhat, and whitehat patterns

8,000+

Videos & Ads

+50-100

Fresh Daily

$29.90

Per Month

Full Access

12+ TB database · 70+ niches · cancel anytime

Reklam Kütüphanesi API'si aslında neyi gönderir?

The API hands you creative text, delivery dates, and page identity for almost any active ad running on Facebook, Instagram, Messenger, or Audience Network. It does not hand you spend, impressions, or audience breakdowns unless Meta has classified the ad as political or a social issue. For a standard e-commerce or affiliate campaign, that means copy and timing only, nothing about budget or reach.

Yaratıcı alanlar, ana metin için ad_creative_bodies, ayrıca reklam bağlantı biçimi kullanırken bağlantı başlıkları, başlıklar ve açıklamalar içerir. Video ve karosel reklamları genellikle bu alanlardan birçoğunu boş gönderir, çünkü Meta yalnızca yaratıcı yapıdan temiz bir şekilde çekebileceği metni analiz eder. Ad_snapshot_url alanı, doğrudan indirebileceğiniz bir çiğ görüntü veya video dosyası değil, Meta tarafından barındırılan bir gösterilmiş ön görüntü sayfasını verir.

Kategoriye bakılmaksızın neredeyse her reklam türünde iki alan güvenilir bir şekilde çalışır: page_id ve ad_delivery_start_time.

AlanAPI tarafından mı döndürüldü?Kapsam uyarısı
ad_creative_ bodies (önemli metin)Evet .Sadece video veya sadece görüntü yaratıcıları null geri verebilir
Bağlantı başlıkları, başlıklar, açıklamalarEvet .Sadece bağlantı tarzında yaratıcılık için doldurulmuş; karusel ve video reklamları genellikle boş
ad_snapshot_urlEvet .Meta'de barındırılan bir ön izleme sayfasına bağlantılar, indirilebilir bir varlık değil
Yerleşim sayfası / hedef URLHayır , hayır .Hiçbir sorgu altında bir alan olarak açıklanmamış
harcamaSadece politik/sosyal konularda reklamlarTicari ve bağlı reklamlar hiç harcama alanı göndermez
izlenimlerSadece politik/sosyal konularda reklamlarHarcama ile aynı kısıtlama
demografik_paylamaSadece politik/sosyal konularda reklamlarStandart reklamlar için yaş ve cinsiyet ayrımı gizlenmiştir
teslimat_regionSadece politik/sosyal konularda reklamlarBölgesel harcama bölümü bu kategoriden dışarıda kullanılamıyor
ad_delivery_start_time / stop_timeEvet .Etkinken veya kısa bir süre sonra tüm reklam türleri için mevcuttur
page_id / page_name / bylinesEvet .Tam ve güvenilir bir kapsamlılık olan birkaç alanın biri
publisher_platformsEvet .Facebook, Instagram, Messenger, Seyirci Ağı

Cevabın neden hedef URL'si eksik?

Meta, Ad Library'in altındaki veri modelinde veya API'de hiçbir zaman hedef URL'yi bir alan olarak ortaya çıkarmaz. Ad_snapshot_url yalnızca reklamın statik, Meta'de barındırılan bir ön görüntüsüne işaret eder ve bu ön görüntüsü genellikle izleyici'nin gerçekten tıklayacağı giden bağlantıyı siler veya gizler. Bir reklamın trafiği gönderdiği URL'ye ihtiyacınız varsa, API tek başına sizi oraya ulaştırmaz.

Bu nedenle, reklamcıların reklam verişleri için bir kısım olarak kullanılabilecek bir araç olarak kullanılır. Reklamcıların her bir tıklama hedefini yayınlamak, Kütüphaneni rakiplerin teklifini araştırmak isteyen herkes için gerçek zamanlı bir fünel haritasına dönüştürür. Meta, Kütüphaneni reklam içeriği ve harcama açıklaması için şeffaflık aracı olarak, diğer reklamcılar için bir öncü nesil kısayol olarak değil çerçevelemektedir. Birçok kampanya ayrıca tıklama başına değişen yönlendirme alanları veya dönen URL'ler üzerinden yönlendirilir.

Meta'in düzeltmesi muhtemel olan bir denetim yerine yokluğu kalıcı bir politika olarak ele alın. API'nin 2019'dan bu yana nasıl geliştiği hiçbir şey bir hedef URL alanının geliştiğini ve bir kişinin diğer yeniden inşa etme yöntemlerine daha iyi harcadığı zaman kaybını bekleyen bir araştırma iş akışı oluşturduğunu göstermez.

Hangi reklamlar arşivde hiç yer almaz?

Ads that Meta rejects during review, that run only to a narrow custom or lookalike audience, or that stop delivering before the indexing pipeline catches them can disappear without ever surfacing in the archive. Political and social-issue ads are the exception, since disclosure rules force retention regardless of reach. For everything else, absence from the archive tells you nothing about whether the ad ran; it may simply have run too briefly, too narrowly, or too recently for Meta to have logged it yet.

Meta, politik olmayan reklamların yayınlanmayı bıraktıktan sonra ne kadar süre arşivde kalacağı konusunda kesin bir rakam yayınlamadı ve sayı koşullara göre değişir. Bu nedenle okuduklarınızı sabit bir kural yerine birkaç hafta ile birkaç ay arasında bir aralık olarak değerlendirin ve buna güvenmeden önce canlı bir testle doğrulayın. Siyasi ve sosyal konulardaki reklamlar, kütüphanenin 2018 başlatılmasından bu yana yaygın olarak 7 yıl aralığında alıntılanan bir çok yıllık bir tutuma taahhüdüne sahiptir, ancak bu taahhüt tipik bir bağlılık teklifi veya e-ticaret promosyonuna uzanmaz.

Bu, özel olarak bağlı araştırma için en önemli şeydir. Düşük bütçe, dar hedeflenmiş veya hızlı dönen bağlı yaratıcılar, bir analist arşivden aramaya karar vermeden önce arşivden en çok çıkmaya muhtemel olan profile tam olarak uyarlar ve politika ihlalinden dolayı bir kaldırma, reklam ile birlikte tarihi kaydı çıkarır. API'ye altı ay önce hangi bağlı ağı çalıştığını sor ve genellikle kampanyası olmadığı için değil, pencerenin zaten kapalı olduğu için hiçbir şey göstermez.

Tarif limitleri ve bölgesel kapsam kapsamınızı nasıl sınırlıyor?

Rate limitleri ve zorunlu ülke kapsamlılığı birlikte, nadiren bir geçit içinde tam bir küresel resmi çekmenizi sağlar. Her sorgu bir ad_reached_country parametre gerektirir ve Meta'nin geniş veya tüm ülkeler kapsamını yönetimi, hangi alanların nüfusunu etkileyen bir tek ülke sorgularından farklıdır. Bu nedenle, önceki bir API sürümünden belgelere güvenmek yerine kendi test çağrınıza karşı mevcut davranışı onaylayın.

  • Standart Graph API kısıtlaması geçerlidir, izin verilen arama hacminin yayınlanan bir numara yerine uygulamanızın genel kullanım seviyesine bağlı olduğu için, kendi uygulamınızda test edene kadar doğrulamadığı olarak gördüğünüz belirli saatlik rakamları değerlendirin.
  • Erişim onaylanmış bir geliştiriciler hesabı gerektirir ve çeşitli bölgelerde siyasi ve sosyal konulardaki reklam kategorilerini sormak için kimlik doğrulama gereklidir.
  • Ülke düzeyde sorgular, gerekirse demografik ve bölgesel ayrıntılar dahil olmak üzere daha zengin alanları, geniş çok ülke sorgularından daha zengin alanlar getirir, bu nedenle kapsamlı kapsam, bir ülkeyi veya küçük bir kümeni bir seferde tekrarlamayı gerektirir.
  • Cursor tabanlı sayfalama, temel oran sınırı üzerine çağrı genel maliyetini ekler ve geniş bir arama terimi tek bir sonuç kümesini tüketmek için düzinelerce sayfalama çağrı gerektirebilir.

Geri döndüğü şeylerden neyi yeniden inşa edebilirsin?

Yaratıcı dönüşüm, çalıştırma zaman pencereleri ve sayfa düzeyinde reklam hacmi makul güvenle yeniden yapılandırabilirsiniz. API'yi ne kadar yaratıcı bir şekilde sorguladığınızdan bağımsız olarak, politik olmayan bir reklam için harcama, izleyicilerin bileşimi veya hedef fantezini yeniden yapılandıramazsınız.

  • Zamanla yaratıcı değişim: bir çizelge üzerinde aynı page_id çek ve kopyalama değişiklikleri ne zaman görmek için geri gönderilen vücutları, başlıkları ve anlık görüntüleri URL'lerini farklılaştır.
  • Çalışma zaman pencereleri: ad_delivery_start_time ve stop_time size belirli bir yaratıcı ne kadar süre canlı kaldığını savunulabilir bir zaman çizgisi verir.
  • Sayfa seviyesindeki reklam sayıları: bir page_id ile karşılaştırıldığında tek bir sorgu, ona bağlı her arşivli reklamı gönderir, bir reklamverenin yaratıcılığı ne kadar agresif bir şekilde test ettiğini gösterir.
  • Yaklaşık hedef niyeti: görünür CTA metni veya bir başlık alanı bazen teklif veya marka adlarını verir ve URL'nin kendisi olmadan bir iniş sayfası kategorisini çıkarmanıza izin verir.
  • Platform karışımı: publisher_platforms size bir reklamverenin sadece Facebook, sadece Instagram veya her ikisini de çalıştıracağını söyler. Bu kendi başına anlamlı bir sinyaldir.

API web Ad Library arayüzünden nasıl farklıdır?

Web arayüzü ve API aynı altta yatan verileri çekmektedir, ancak farklı şekilde ortaya çıkarırlar: Web aracı, insan tarafından reklamları görsel olarak taramak için inşa edilmiştir ve API, bir programda yapılandırılmış alanlar çeken bir senaryo için inşa edilmiştir.

Pratik fark, derinlik değil hız ve ölçektir. Bir araştırmacı web arşivini yirmi dakika tarar ve aynı page_id'i API'den çeken bir senaryo aynı eksik alanlara çarpar; API sadece tarama bir sayfa yerine bin sayfa üzerinden gerçekleşmesine izin verir.

YeteneklilikWeb Reklam KütüphanesiAPI
Anahtar kelime veya reklamcıya göre taramaİçinde yerleştirilmiş arama UIArama terimini veya page_id'i zaten bilmenizi gerektirir
Yaratıcılık gösterdiDüzsel, kaydırılabilirSadece anlık fotoğraf sayfasına bağlantı yoluyla
Siyasi olmayan reklamlar için harcama/tutumlarGösterilmemişGeri verilmedi
Toplu ihracatEl kitabı, bir seferde bir reklamYapılandırılmış JSON, ölçekte yazılabilir
Erişim GerekliliğiHiç, kamuoyu sayfası.Geliştiricilerin hesabı ve erişim tokenları, bazı kategoriler için inceleme
Siyasi olmayan reklamlar için tutma sınırıAynı sınırlar geçerlidir.Aynı sınırlar geçerlidir.

API ne zaman kablolamaya değer ve ne zaman bir çıkmaz yol?

API, birçok sayfa veya arama teriminde tekrarlanabilir, yapılandırılmış izlemeye ihtiyaç duyduğunuzda mühendislik maliyetini kazanır: günlük yaratıcı değişiklik uyarıları, neyin ve ne zaman çalıştığı tarihi bir veritabanı veya bir kezde düzinelerce rakip sayfasını izleyen bir donanım tablosu. Gerçek sorunuz politik olmayan bir reklamcı için harcama, kitle veya hedef URL olduğunda bir çıkmaz yol. Çünkü hiçbir sorgu yapısı bir alan üretmez Meta geri dönmez.

İşte doğrudan tartışmaya değer bir bölüm: Çoğu bağlılık ve e-ticaret araştırması için, Ad Library etrafında bir API boru hattı oluşturmak genellikle haftada birkaç kez web arşivini elle kontrol etmekten daha kötüdür. Otomatik çekim, tutuma penceresinden çıkan her reklamı, her dar hedeflenen testi ve her reddedilen yaratıcılığı gerçekten kaybedebildiğinde, tam, sistematik kapsamlılık izlenimini yaratır.

  • Bağlayın: zaman içinde bilinen bir sayfa_id listesi boyunca yaratıcı değişiklikleri izlemek.
  • Meta'in reklamlar için saklama penceresi kapanmadan önce iç bir arşiv oluşturun.
  • Durum: rekabetçinin politik olmayan bir teklif için reklam harcamalarının tahmin edilmesi.
  • Durum: herhangi bir reklamın arkasındaki hedef URL veya fünel yapısını kurtarmak.
  • Sıkı bir API sonucu varsaymak, bir sayfanın hiç çalıştırdığı her reklamı gördüğünüz anlamına gelir.

Hızlı karar kontrol listesini

Bu sayfayı genel bir blog yazısı değil karar yardımcılığı olarak kullanın. Pratik soru, okuyucuya VSL yönlendirilmiş doğrudan tepki konusunda, özellikle nutrik, takviyeler, GLP-1, kilo kaybı, kan şekeri ve bitişik yüksek niyetli sağlık pazarlarında zaten neyin çalıştığını daha hızlı kanıtlamaya ihtiyaç olup olmadığını göstermektir.

Daily Intel Service, bir sonraki kararın aktif piyasa örneklerine bağlı olduğu durumlarda en önemlisi: hangi kanca denemek için, hangi iddia tarzı riskli, hangi fünel yapısı yaygın, hangi dil pazarı hareket ediyor ve bir rakipinin yaratıcılığının erken, ölçeklendirilmesi veya zaten doymuş olup olmadığı.

  • Eğer doğrudan cevaba ihtiyacınız varsa TL;DR ile başlayın.
  • Çatışmayı hızlıca karşılaştırmak için tabloyu kullanın.
  • Cevap motoruna hazır özetler için FAQ'yi kullanın.
  • Kararın teorinin yerine canlı VSL ve reklam örnekleri gerektiğinde CTA'yı kullanın.

Daily Intel'in kapsam avantajı

Daily Intel Service, kategoride önde gelen çeşitlilik ve etkinlik etrafında konumlandırılmıştır: VSLs ve reklam yaratıcılarının en geniş doğrudan yanıt kataloglarından biri, siyah şapka, gri şapka ve beyaz şapka reklam kalıpları boyunca, reklamverenin görülebilir yaratıcılıktan öte ne yaptığını anlamak için yeterli bağlam ile. Pratik fark, üyelerin sadece bir ekran görüntüsü görmemesidir; VSL, reklam, fünel yolu, transkript, UTM bağlamı ve varlığı bir karara dönüştüren araştırma notlarını görüyorlar.

Bu önemli çünkü doğrudan yanıt bağlı şirketler temiz bir kategoride çalışmaz. Bir kilo kaybı kampanyası beyaz hat uyum reklamı, gri şapka ön iniş, daha agresif bir VSL ve yükseltme ve kurtarma etrafında tasarlanmış bir çekme yolu kullanabilir. Bir yararlı istihbarat platformu, her kazanan kampanyayı kamu markası reklamı gibi görüyormuş gibi yapmaktansa bu spektrumyu yakalamak gerekir.

Kara şapka, beyaz şapka ve çok dilli sinyal kapsamı

Daily Intel, hem siyah şapka hem de beyaz şapka tarzındaki kampanyalarda kalıpları takip eder, böylece operatörler riskleri körü körü körü kopyalamadan piyasayı anlayabilirler.

Kataloğ ayrıca küresel operatörler için de inşa edilmiştir. VSL ve 14+ dil ve farklı yerel dilleri kapsayan reklam referansları ile. Bu, sadece ABD İngilizce reklamlarını incelemek yerine aynı pazar arzusunun kültürler arasında nasıl tercüme edildiğini görmesi gereken Brezilya, LATAM, Avrupa, MENA, Hindistan ve doğma olmayan İngilizce bağlı şirketler için önemli bir avantajdır.

Araştırma ihtiyacıGenel reklam arşivleriDaily Intel Service
Yaratıcılık hacmiKarışık bir önemi olan büyük ham veri tabanlarıVSL kurasyonlu ve doğrudan cevap kullanımı için seçilen reklam örnekleri
Kara Şapka ve Beyaz Şapka BilinmesiGenellikle ekran görüntüleri veya URL'ler olarak düzleştirilmiştirUyumlulık spektruma, gizleme riskine ve talep tarzına açıkça dikkat edin
Tıklama sonrası bağlamGenellikle sınırlı veya tutarlı değildirVSL, transkript, fünel yolu, çekme, yükseltme, UTM ve mevcut olduğunda kurtarma notları
Dil kapsamıArama filtreleri olabilir, ama bağlam inceKüresel bağlı araştırma için 14+ dil ve uluslararası dil kapsamı
En iyi kullanım durumuGeniş tarama ve tarihsel aramaNutra, takviyesi, GLP-1, VSL ve doğrudan tepki kampanya kararları

Bilgiyi nasıl sorumlu bir şekilde kullanabiliriz

Hedef kopyalama değil, modellerleme. Daily Intel'i kullanarak yapıyı anlamak için: kanca, mekanizma, kanıt, talep yoğunluğu, fünel derinliği, teklif ekonomisi ve doymuşluk aşaması.

Güçlü bir iş akışı, hareket etmeden önce birden fazla örneği karşılaştırır. Aynı mekanizma birkaç dilde, birkaç reklamveren ve birkaç fünel variantında görünürse, bu kalıcı bir piyasa sinyali olabilir. Örneği sadece bir kez görünürse veya saldırgan bir iddiaya bağlıysa, onu bir kampanya şablonu yerine bir araştırma ipucu olarak ele alın.

  • Model yapı, korunmuş yaratıcı varlıklar değil.
  • Beyaz şapka dayanıklılığını siyah şapka ikna basıncından ayır.
  • ABD İngilizce örneklerini LATAM, Avrupa ve diğer dil çeşitleriyle karşılaştırın.
  • Orijinal kısa yazılar oluşturmak için transkriptleri ve trenik notlarını kullanın.
  • Uyumluluk incelemesini piyasa araştırmasından ayrı tutun.

Metodoloji ve kaynak bağlamı

Daily Intel pages are written from a research workflow that reviews active VSLs, Meta ad creatives, transcripts, UTMs, funnel paths, checkout steps, upsells, recovery sequences, and compliance-sensitive claim patterns. The goal is to explain observable market behavior, not to provide legal, medical, or platform policy advice.

When the topic touches health claims, platform policy, or GLP-1 market research, validate the observable campaign signals against primary references such as Meta advertising standards, FTC health claims guidance, and Meta Ad Library. Daily Intel adds the proprietary direct-response layer by mapping how those rules show up in active VSLs, Meta creatives, funnels, transcripts, UTMs, and checkout paths.

For deeper evaluation, continue through Daily Intel compliance and legal disclaimer, What is Cloaking Device?, Antidetect Browser Free 10 Profile: Free Until Exactly Where, Antidetect Browser Windows 10: The Practical Version, Best Cloaker for Meta Ads: A Reference for Operators, and What is a VSL?. These related Daily Intel pages connect this topic to the relevant methodology, pricing, trust context, comparison path, or niche workflow.

Founding rate — locked forever

Seçilmiş VSL istihbaratına ayda $29.90 ile erişin

  • 50–100 manually validated VSLs every day at 11PM EST
  • major niches niches, 14+ languages, blackhat-to-whitehat pattern coverage
  • live catalog VSL/ad catalog, transcripts, UTMs, full funnel maps
  • Cancel anytime — founding rate stays yours forever

Daily Intel Service, aktif olarak ölçeklenen VSL’ler, Meta kreatifleri, UTM’ler, huniler ve nutra pazarındaki hareketler üzerine elle seçilmiş araştırma sunar.

$29.90/mo

$299/mo

Coupon LIFETIME-269-OFF auto-applied

Claim the rate

Secure checkout · Stripe

Sık sorulan sorular

  • Reklam Kütüphanesi API'si Meta'dan özel erişim gerektiriyor mu?

    Evet, onaylanmış bir geliştiriciler hesabı ve bir erişim jetonu gerektirir ve birkaç bölgede siyasi veya sosyal konulardaki reklam kategorilerini sorgulama ayrıca kimlik doğrulama gerektirir. Standart ticari reklam sorguları daha az sürtünme gerektirir, ancak hala herhangi bir erişim seviyesinde para harcama veya izlenim verileri alamazsınız.
  • Bir reklamverenin API'den toplam reklam harcamalarını alabilir miyim?

    Reklam sadece Meta sınıflandırması altında siyasi veya sosyal konular içerik olarak kabul edilirse. Standard ticari ve bağlı reklamlar, sorunun nasıl yapılandırıldığına bakılmaksızın, harcama alanını asla geri göndermez. Bu nedenle bu kategoriler için herhangi bir harcama tahmininin tamamen API'nin dışında gelmesi gerekir.
  • API, reklamın hangi hedef sayfasını gösterdiğini gösteriyor mu?

    Hayır, hedef URL herhangi bir sorgu altında bir alan olarak gösterilmez. En yakın mevcut veri noktası, gerçek tıklama yoluyla hedef yerine gösterilen bir ön izleme sayfasına bağlantı veren ad_snapshot_url'dir.
  • Reklam Kütüphanesi API'nin tarihi verileri ne kadar eski?

    Siyasi ve sosyal konulardaki reklamlar, genellikle Kütüphanenin 2018'de başlatılmasından bu yana yaklaşık 7 yıl sonra alıntılanan, çok yıllık bir tutma taahhüdüne sahiptir. Siyasi olmayan reklamlar, belirli bir rakamdan önce canlı bir testle doğrulayın.
  • API verileri web Reklam Kütüphanesi arama ile aynı mı?

    Hayır, aynı altta yatan verileri kullanırlar ama farklı biçimlerde farklı miktarlarda ortaya çıkarlar. Web aracı, kişisel reklamların manuel, görsel taramalarına uygun olurken API, birçok sayfada scriptli, yapılandırılmış çekimlere uygun olur, ancak her ikisi de aynı harcama ve hedef URL kısıtlamalarını tutmaktadır.
  • Bağlı pazarlamacılar API'yi rakiplerin dalgalarını izlemek için kullanabilir mi?

    Partly, ve sadece funnel yaratıcı yarısını. Reklam kopyasını, rotasyon zamanlamasını ve hangi sayfaların yeni yaratıcılıkları aktif olarak test ettiğini izleyebilirsiniz, ancak harcama, izleyici hedefleme ve gerçek nişan sayfası sorunun nasıl inşa edildiğine bakılmaksızın erişilemez kalır.

Araştırma yoluna devam edin

İlgili sayfalar

Next in complianceMeta Reklam reddetme nedenleri çözüldü: 12 Ortak KodMeta'nin reddetme etiketleri kasıtlı olarak geniş. İşte en yaygın on iki tanenin her biri aslında hangi öğeyi haritasıyor ve hangi öğeyi değiştirmek.

Lock $29.90/mo forever

Coupon LIFETIME-269-OFF · Cancel anytime

Get Access