Native Ad Data API: Ohjelmallinen pääsy tallennettuihin natiiveihin mainosluoviin

Jos olet koskaan yrittänyt tehdä todellista analyysiä natiivimainonnasta, tiedät seinän. Tiedustelu on olemassa, mutta se on loukussa kojetaulun takana. Voit selata yhtä luovaa kerrallaan, silmäillä kourallisen mainostajia, ehkä viedä CSV:n, joka on jo vanhentunut latauksen päätyttyä. Mitä et voi tehdä, on kohdella natiivi-mainosdataa kuten jokaista muuta datajoukkoa pinossasi: hakea sitä, yhdistää sitä, ajoittaa sitä, syöttää sitä malliin.

Tämä opas on niille, jotka haluavat datan, eivät kojetaulua. Analyytikoille, jotka rakentavat kilpailuseurantaa. Datatiimeille, jotka rikastuttavat CRM:ää. Kvanteille, jotka testaavat luovia kulmia taaksepäin. Ja yhä useammin tekoälyagenteille, jotka tekevät tuota työtä ilman ihmistä silmukassa. Kysymys on yksinkertainen. Miten saat tallennetut natiivit luovat, niiden takana olevan toimitusketjun ja niihin osoittavat kohdesivut puhtaina, rakenteellisina tietueina API:n kautta?

Taustaksi: kesäkuun 2026 tilannekuva OpenAdLibraryn kokoelmasta sisälsi 589 036 luovaa, 5,4 miljoonaa mainoshavaa, 25 933 erillistä mainostajaa ja 926 259 tallennettua kohdesivua 42 verkossa. Se on historiallinen mittari siitä, mitä olimme tallentaneet, ei natiivimarkkinan koko eikä nykyinen lukumäärä. API:n tehtävä on antaa sinulle ne tietueet, joita pyysit.

Mitä natiivi-mainosdata-API todella palauttaa#

Natiivi-mainosdata-API on päätepiste, joka palauttaa natiivimainonnan tiedustelun koneellisesti luettavina tietueina verkkosivun sijaan. Tietue voi niputtaa luovan (kuvan ja otsikon), sen julkaisijan ja palvelevan verkon, sijainnin takana olevat toimitusketjun hypyt, klikkauksen kohdesivun sekä ajoitussignaalit, kuten ensimmäisen ja viimeisen näkemisen päivämäärät. Suodatat, liität ja aggregoit sitä kuin mitä tahansa tietokantataulukkoa.

Tuo siisti määritelmä piilottaa paljon tekniikkaa. Toisin kuin hakumainos tai Meta-mainos, joka istuu virallisessa kirjastossa, natiivi-sijoitus renderöidään natiivi-mainoswidgetillä, "Suositeltua sinulle" tai "Ympäri verkkoa" -raidalla artikkelien alareunassa. Nämä widgetit ovat dynaamisia, maantieteellisesti kohdennettuja ja personoituja. Siksi yksittäinen staattinen kaappaus voi jättää väliin mainoksia, jotka muut kävijät näkevät. Todellisen datajoukon on tallennettava eri maantieteiden yli ja ajan mittaan, sitten deduplikoitava vakaaseen luovaan.

Yllä oleva mainos on tyypillinen esimerkki genrestä tallennuksissamme: määräaika, epämääräinen auktoriteetti ja dollariarvo. Olimme havainneet sitä 13 päivän ajan, kun viimeksi näimme sen. Se kertoo, kuinka kauan näimme sen, ei sitä, oliko se kannattava tai oliko sen väite paikkansapitävä.

Natiivi-mainosdatajoukon neljä datakerrosta#

Ajattele natiivi-mainosdataa neljänä pinottuna kerroksena. Jotkin työkalut nostavat esiin vain ylimmän kerroksen. Arvo kasvaa kerroksittain, kun menet alemmas.

Hyppy kerroksesta kaksi kerrokseen neljä on koko peli. Sijoituksen palvelee verkko (Taboola, Outbrain, MGID, Revcontent, Teads, Yahoo, MSN), mutta verkko ei ole mainostaja. Mainostaja on se, joka istuu klikkauksen päässä. Luovien laskeminen verkoittain ei kerro, kuka todella ostaa. Uudelleenohjausketjun seuraaminen, palvelinpuolella ja ilman todellisen klikkauksen käynnistämistä live-kampanjassa, on se, mikä muuttaa kasaan anonyymejä widget-luovia kilpailulliseksi tiedusteluksi, jolla voi toimia.

Välissä olevan reitityksen mekaniikoista, katso natiivi-mainostoimitusketju. Todennäköisen ostajan selvittämiseksi palvelevan verkon takaa, lue kuinka tunnistaa todennäköinen verkko natiivi-mainoksen takana.

Kesto on hyödyllinen sarake, jota on helppo ylitulkita#

Aikaleima on yksi natiivi-mainosdatajoukon hyödyllisimmistä kentistä, koska sen avulla voit mitata, kuinka kauan mainosta havaittiin.

Et voi nähdä kenenkään kuluja natiivissa, eikä kesto korvaa niitä. Luova, joka pysyy yllä monilla sivustoilla viikkoja, voi olla kannattava, mutta se voi olla myös brändikampanja, testi, jossa on budjettia jäljellä, tai mainos, jota kukaan ei ole tarkistanut. Tässä artikkelissa mainituissa kesäkuun 2026 tallennuksissa pisimpään jatkuvasti havaitut luovat olivat pyörineet noin 28 päivää, mikä oli havaintoikkunamme raja tuolloin, joten pidempiä ajoja ei voitu nähdä. Otsikot, jotka saavuttivat tuon rajan, kannattaa katsoa esimerkkeinä.

SmartAssetin "How Can I Avoid Paying Taxes on IRA Withdrawals?" oli 28 päivän listalla. Samoin useat "What's Your IQ Level?" -tietokilpailumainokset My IQ:lta Microsoft Audience Networkissä, ja kuulolaitemainos Hidden Hearingiltä, jossa kaksi eri luovaa oli samassa rajassa. Mainostaja, jonka useita muunnelmia havaittiin koko ikkunan ajan, ajoi niitä edelleen. Emme voi sanoa, oliko tarjous kannattava, oliko budjetti suuri vai olivatko mainosten väitteet paikkansapitäviä.

Yksi varoitus, joka kannattaa sanoa suoraan. "90 päivän voittaja", josta kuulet mainostoimistopiireissä, on alan perimätietoa, ei meidän mittauksemme. Mitä pystyimme todentamaan näissä kesäkuun 2026 tallennuksissa, olivat jatkuvat ajot enintään noin 28 päivää per luova. Käsittele 90 päivän lukua kansanperinteenä, kunnes oma datajoukko aikaleimaa sen.

API vs kojetaulu: sovella työkalua tehtävään#

Kojetaulussa ei ole mitään vikaa ad-hoc-tutkimusta varten. Kaksi käyttöliittymää on rakennettu eri tehtäviin, ja niiden sekoittaminen voi johtaa siihen, että tiimit maksavat työkaluista, joita he tuskin käyttävät.

• Käytä kojetaulua, kun ihminen tekee tutkivaa työtä: silmäilee kilpailijan kulmaa, hakee muutaman luovan esitystä varten, skannaa mikä on kuuminta tällä viikolla. Tämä on klassinen mainosvakoilutyökalu -työnkulku.
• Käytä API:a, kun kuluttaja on järjestelmä: ajoitettu työ, dbt-malli, ominaisuusvarasto, Slack-hälytys tai tekoälyagentti. Haluat tietueita, ei pikseleitä, ja haluat ne cronilla.

Käytännön merkki on toisto. Jos huomaat viemäsi manuaalisesti saman näkymän joka maanantai, sinulla ei ole tutkimusongelmaa. Sinulla on integraatio-ongelma, ja API ratkaisee sen. Tämä on myös suunta, johon laajempi mainostiedustelu -ala on menossa: vähemmän manuaalista selailua, enemmän ohjelmallisia syötteitä kytkettynä suoraan kilpailullisiin ja luoviin työnkulkujen.

Konkreettinen putki#

Tässä on, kuinka datatiimi todella kytkee natiivi-mainosdatan johonkin hyödylliseen. Kaava pätee, seuraatko koko vertikaalia vai yhtä kilpailijaa.

1. Määritä tarkkailulista. Joukko mainostajia, kohdesivualueita tai julkaisijasivustoja, joista välität. Hakupäätepiste dokumentoi suodattimet, kuten advertiserDomain, landingDomain ja publisher, joten haet vain sen, mitä seuraat.
2. Hae ajoituksen mukaan. Yötyö pyytää mainoksia, jotka on nähty viimeksi eilisen jälkeen (hakupäätepiste dokumentoi lastSeenFrom-suodattimen, ja erillinen changes-päätepiste ottaa since-vesileiman) ja päivittää ne id:n perusteella, jotta samaa luovaa ei tallenneta kahdesti.
3. Yhdistä omiin tietoihisi. Sovita kohdesivualueet CRM:ääsi tai kilpailijataulukkoon. Luovat, joiden kohdesivualue täsmää, liitetään sitten yritykseen, jota seuraat jo.
4. Laske havaittu kesto ja leviäminen. Ryhmittele luovan ID:n mukaan. Mittaa havaitut päivät (viimeisen ja ensimmäisen havainnon erotus) ja erillisten julkaisijoiden määrä. Pitkään havaitut, laajalle levinneet luovat ovat ehdokkaita tarkempaan tarkasteluun, eivät vahvistettuja voittajia.
5. Toimi. Työnnä päivittäinen tiivistelmä uusista pitkään havaituista luovista Slackiin, syötä luovat klusterointimalliin tai anna rakennettu suunnitelma agentille.

Neljäs vaihe on se, missä aikaleimattu datajoukko on hyödyllinen. Luova, kuten yllä oleva Nebroon kuulolaitemainos, havaittu 26 päivää, on sellainen tietue, jonka putkesi voi liputtaa tarkistettavaksi. Kesto on luettavissa vain, jos datajoukko aikaleimaa jokaisen havainnon, minkä vuoksi kesäkuun 2026 tilannekuvassa 5,4 miljoonaa havaintoa oli 589 036 luovan takana. Havainnot ovat aikasarja. Luova on vain avain. Liputus on kehotus ihmiselle tai mallille katsoa tarkemmin, ei tuomio siitä, että mainos toimii.

Mikä erottaa käyttökelpoisen datajoukon meluisasta#

Määrä on väärä otsikkometriikka. Kymmenen miljoonaa vanhentunutta, huonosti deduplikoitua, vain verkkoon perustuvaa tietuetta on huonompi kuin pienempi joukko, joka on tuore, attribuoitu ja puhdas. Kun arvioit natiivi-mainosdatajoukkoa tai sen API:a, painotesta sitä viidellä asialla:

• Tuoreus. Tallennetaanko sijoitukset livenä, ensimmäisen ja viimeisen näkemisen päivämäärillä? Vai onko kyse jaksottaisesta dumppista, joka on jo viikkoja vanha?
• Luovan uskollisuus. Tallennetaanko varsinainen kuva täysilaatuisena vai pienennettynä pienoiskuvana, joka on hyödytön visuaalisessa analyysissä?
• Attribuointisyvyys. Pysähtyykö se verkkoon vai jäljittääkö klikkauksen lopulliseen kohdesivuun ja todelliseen mainostajaan?
• Tallennusmenetelmä. Lukeko se julkisia mainoksia ilman todellisten klikkausten käynnistämistä live-kampanjoissa? Synteettiset klikkaukset kuluttavat muiden mainostajien rahaa ja turmelevat heidän ja omat tietonsa.
• Kattavuuden laajuus. Kattako se suurimmat natiivi-verkot ja tallentaa eri maantieteiden yli vai onko se yksi julkaisija yhdessä maassa?

Huomaa yksityiskohdat tuossa aurinkoakkumainoksessa. Täysiresoluutiossa voit lukea tarjouksen, kehystyksen ja visuaalisen käsittelyn, mikä syöttää visuaalista klusterointia ja kopioanalyysiä. Pienoiskuva heittää kaiken sen pois. Nämä viisi testiä erottavat myös aidon mainosten läpinäkyvyyden kuvakaappauskirjastosta, johon on ruuvattu hakulaatikko. Natiivilla ei ole virallista kirjastoa, joka olisi verrattavissa Metan tai Googlen kirjastoon, ja oppaamme mikä natiivi-mainoskirjasto on ja miten se eroaa Metan ja Googlen kirjastoista kertoo tuon tarinan.

Miksi natiivi on vaikeampaa, ja palkitsevampaa, kuin miltä näyttää#

Meta, Google, Microsoft (Bing-mainoksille EU:ssa ja ETA:ssa) ja TikTok julkaisevat virallisia mainoskirjastoja, ja osa niistä on olemassa siksi, että EU:n digipalvelusäädös edellyttää julkista mainosarkistoa nimetyiltä erittäin suurilta verkkoalustoilta ja hakukoneilta. Euroopan komission luettelo näistä palveluista (päivitetty 31. elokuuta 2026) ei sisällä Taboolaa, Outbrain/Teadsia, MGID:tä tai Revcontentia, eikä meille ole tiedossa niiltä julkista mainoskirjastoa, joten ohjelmallisella natiivimainonnalla ei ole virallista kirjastoa, joka olisi verrattavissa Metan kirjastoon. Juuri tuo aukko on syy siihen, että riippumattomia datajoukkoja on olemassa. Mainokset näytetään julkisesti; niiden järjestäminen on eri työ.

Tallennusongelman ratkaisemisen palkinto on tallenne siitä, mitä mainostajat näyttävät julkisesti. Yhdistä se ohjelmalliseen pääsyyn ja saat natiivi-mainosdataa, jota voit käyttää infrastruktuurina, ei vain sivustona, johon kirjaudutaan. Laajemmasta kontekstista siitä, kuinka mainoskirjastot, lait ja työkalut sopivat yhteen, aloita peruspylväästä mitä mainosten läpinäkyvyys on ja kuinka sitä käytetään, ja avoimet mainoskirjastot selitettynä kattaa työkalujen maiseman.

Kuinka OpenAdLibrary sopii#

OpenAdLibrary julkaisee tämän blogin ja myy tässä kuvattua tuotetta. Se tallentaa julkisia natiivi-mainoksia Taboolalta, Outbrainilta, MGID:ltä, Revcontentilta, Teadsilta, Yahoolta ja MSN:ltä API-ensin ja selaincrawler varamenetelmänä, ja lokakuusta 2026 lähtien sen kirjasto sisältää myös Meta- ja TikTok-mainoksia. Se tallentaa luovan, luokittelee toimitusketjun ja seuraa uudelleenohjauksia kohdesivulle klikkaamatta live-mainoksia. REST API ja hostattu MCP-palvelin tarjoavat samasta kirjastosta julkista dataa analyytikolle, putkelle tai tekoälyagentille. Mainosdata ja tutkimus niiden molempien kautta kuuluvat Founders-suunnitelmaan: ilmaisen tilin avain tavoittaa vain kyseisen tilin omat päätepisteet, ja kaikki muut päätepisteet vastaavat maksuvaatimuksella. API-dokumentaation mukaan se palauttaa julkista luovaa sisältöä, pienoiskuvien URL-osoitteet, koostetut lukumäärät ja mainoksen takana olevan uudelleenohjausketjun, mukaan lukien mainostajan URL-osoitteen, johon klikkaus päättyy. Se ei palauta verkkosovelluksessa näytettävää vain Meta- ja TikTok-dataa, kuten Metan kulutusarviota ja EU-tavoittavuutta, ja sen vapaatekstihakuun vastataan 3 000 viimeksi nähdystä osumasta eikä koko aineistosta. Jokaisella avaimella on päivittäinen pyyntökiintiö (API-viite luettelee oletuksena 5 000 pyyntöä päivässä). Hakutulokset voivat sisältää Meta- ja TikTok-mainoksia, joiden id:t alkavat meta- tai tiktok-, eikä yhden mainoksen päätepisteellä ole niistä tietuetta.

Founders-suunnitelma maksaa $29.99 kuukaudessa ja sisältää REST API:n ja hostatun MCP-palvelimen. Ilmainen tili ei vaadi korttia ja näyttää sovelluksessa 20 uusinta Meta-, TikTok- ja natiivi-mainosta, joten voit tarkistaa ennen maksamista, näyttääkö datajoukko tarkkailulistasi kannalta olennaiselta; perusteellinen tarkistus ja kaikki API-käyttö vaativat Founders-suunnitelman.

Aloita ilmaiseksi ja katso dataa sovelluksessa; API-käyttö vaatii Founders-suunnitelman.