Facebookin Open Graph -välimuistin päivityksen pakottaminen

Voit pakottaa Facebookin Open Graph -välimuistin päivityksen, koska Facebook — yksin suurista alustoista — tarjoaa ohjelmallisen tavan pyytää sitä. Käytä joko Sharing Debuggerin Scrape Again -painiketta yksittäiselle linkille tai kutsu Graph API:n scrape-päätepistettä sovelluksen käyttöoikeustunnuksella (app access token). WhatsAppille, LinkedInille tai X:lle ei ole tapaa pakottaa päivitystä: ne eivät julkaise tällaista rajapintaa kenellekään.

Asia, joka kompastuttaa kaikki

Meta tallentaa linkkiesikatselun välimuistiin sivun URL-osoitteen perusteella ja säilyttää oman kopionsa kuvasta. Se ei lue sivua uudelleen huomatakseen, että og:image osoittaa nyt jonnekin muualle.

Tämä työnkulku epäonnistuu, ja se on yleisin yritys:

Vaihda kansikuva → og:image-URL on uusi → oleta, että Facebook poimii sen → se ei poimi.

Uusi kuvan URL rikkoo kuvien CDN-välimuistin. Se ei tee mitään Metan sivukohtaiselle välimuistille. Saadaksesi Facebookin liikkeelle sinun on kerrottava Metalta, että sivu on muuttunut.

Välimuisti	Avaimena	Tyhjennetään
Sivusi välimuisti / CDN	sivun URL	tyhjentämällä se
Metan linkkiesikatselun välimuisti	sivun URL	scrape-päätepisteellä tai Sharing Debuggerilla
Metan kopio kuvasta	kuvan URL	uudella kuvan URL-osoitteella
Kuvasi CDN	kuvan URL	uudella kuvan URL-osoitteella

Avaa developers.facebook.com/tools/debug, liitä sivun URL-osoite ja paina Scrape Again. Meta hakee sivun uudelleen ja rakentaa välimuistissa olevan esikatselun uusiksi.

Se on myös paras ilmainen validaattori, joka sinulla on, koska se kertoo, mitä Meta todellisuudessa löysi, eikä sitä, mitä toivoit siellä olevan: puuttuvat tai päällekkäiset og:image, tavoittamattomat kuvat, tuetut formaatit. Kaksi asiaa, joita se ei tee: se ei voi käsitellä WhatsAppia (erillinen välimuisti vastaanottajan sovelluksessa), eikä se ole katalogityökalu — se käsittelee yhden URL-osoitteen kerrallaan, sillä on nopeusrajoitus, ja sen edessä on ihminen.

Vaihtoehto 2 — Graph API (tätä lisäosa kutsuu)

Ohjelmallinen vastine, jota FastOG käyttää, on POST-pyyntö Graph API:lle scrape=true:

bash

curl -X POST \
  "https://graph.facebook.com/v21.0/?id=$(python3 -c 'import urllib.parse,sys;print(urllib.parse.quote(sys.argv[1],safe=""))' 'https://your-store.com/product/example')&scrape=true&access_token=${APP_ID}|${APP_SECRET}"

Neljä tärkeää yksityiskohtaa:

id on sivun URL, ei kuvan URL. Meta avaa välimuistinsa sivun perusteella, joten kuvan osoitteeseen pingaaminen ei päivitä mitään.
Tunnus vaaditaan — Meta on vaatinut sellaisen tässä päätepisteessä lokakuusta 2017 lähtien. Sovelluksen käyttöoikeustunnus muodossa {app_id}|{app_secret} riittää, eikä se vaadi käyttäjän kirjautumista, mikä tekee kutsusta mahdollisen taustatyöstä käsin.
Graph API -versiot liikkuvat. FastOG kiinnittää testatun Graph API -version; tarkista Metan nykyinen dokumentaatio ja muutosloki ennen kuin kiinnität version omaan koodiisi.
Käsittele sitä parhaan yrityksen mukaan. Meta rajoittaa kaavintakutsujen nopeutta, ja kieltäytyminen tarkoittaa vain sitä, että Facebook päivittää omalla aikataulullaan välittömän päivityksen sijaan — sivusi tunnisteet ovat jo valmiiksi oikein.

Koska sitä rajoitetaan nopeuden mukaan, älä lähetä sitä suoraan joka kerta, kun tallennat suuren luettelon. Aseta se jonoon ja poista kaksoiskappaleet URL:n perusteella, jotta saman muuttumattoman tuotteen toistuvat tallennukset eivät kuluta nopeusrajoitusta.

Vaihtoehto 3 — lisäosa, joka hoitaa sen puolestasi

Lisäosat, joita markkinoidaan "Open Graph -välimuistin päivityksenä", jakautuvat kahteen ryhmään, ja vain toinen niistä voi korjata Facebookin:

Mekanismi	Mitä se tyhjentää	Korjaako vanhentuneen Facebook-esikatselun?
Lisää muuttuvan kyselymerkkijonon kuvan URL-osoitteeseen (`?v=timestamp`)	kuvasi CDN:n	Ei — Metan välimuisti on sidottu sivuun
Kutsuu scrape-päätepistettä sivun URL-osoitteelle	Metan esikatseluvälimuistin	Kyllä

Ennen asennusta selvitä, kumpi näistä on kyseessä. Aikaleimaparametri on oikea korjaus vanhentuneelle kuvalle mutta ei korjaus vanhentuneelle Facebook-kortille.

FastOG for WooCommerce tekee jälkimmäisen, etkä määritä mitään. Lisäosa rekisteröi WooCommercen natiivit tuoteverkkokutsut (webhooks), joten tuotteen tallentaminen käynnistää Metan uudelleenhaun kyseisen tuotteen pysyvään linkkiin (permalink) — jonossa, lyhyen ajan sisällä deduplikoituna ja parhaan yrityksen periaatteella, joten kieltäytyminen ei koskaan kaada tallennusta. Se koskee tuotesivuja (product.created / product.updated); luokka- ja blogimuokkaukset eivät ole katettuina.

Kuvapuoli hoidetaan erikseen ja eri tavalla kuin kilpailijoilla: koska FastOG-kannen URL-osoite sisältää arvot, jotka tuottivat sen, hinnan tai kuvan muokkaaminen luo uuden kannen URL-osoitteen. Meta ei voi palvella uudelleen kuvaa, jonka osoitetta ei enää ole olemassa.

Kun Facebook ei riitä

Alusta	Voitko pakottaa päivityksen?	Mitä oikeasti tapahtuu
Facebook	Kyllä — debuggeri tai `scrape=true`	Pyytää uudelleenhaun; leviämisaika vaihtelee
WhatsApp	Ei	Esikatselu välimuistitetaan vastaanottajan sovelluksessa; API:ta ei ole olemassa
LinkedIn	Ei dokumentoitua ohjelmallista API:a	Lukee uudelleen omalla aikataulullaan; julkista aikarajaa ei ole luvattu
X / Twitter	Ei dokumentoitua ohjelmallista API:a	Lukee uudelleen omalla aikataulullaan; julkista aikarajaa ei ole luvattu
Slack, Discord	Ei	Lyhytikäiset välimuistit, jotka tyhjenevät itsestään minuuteissa tai tunneissa

Jos esikatselu on vanhentunut WhatsAppissa, vastaus ei ole Facebookin työkalu — vaan kaupan puolen saaminen oikein, jotta seuraava luku on oikea.

Kun onnistuneen haun jälkeen näkyy edelleen vanha kuva

Käy tämä lista läpi järjestyksessä:

Palveleeko sivu edelleen vanhaa tunnistetta? curl -s https://your-store.com/product/example | grep -i 'og:image' — välimuistissa oleva HTML-sivu, jossa on vanhentunut og:image, mitätöi haun kokonaan. Tyhjennä sivun välimuisti.
Tulostaako sivu useamman kuin yhden og:image? Jos kaksi lisäosaa tuottaa kumpikin oman, hakurobotti ottaa ensimmäisen lukemansa. Laske ne.
Onko kuva tavoitettavissa eikä estetty? curl -I <image-url> pitäisi palauttaa 200 kuvan Content-Type-tyypillä. Sosiaalisen median hakurobotit noudattavat robots.txt-ohjetta, joten kuva Disallow:-polulla epäonnistuu tavalla, joka näyttää vioittuneelta tiedostolta — eikä curl koskaan toista sitä, koska curl ohittaa robots.txt.
Muuttuiko kuvan URL oikeasti? Jos ei, ei sisältökään muuttunut — tarkista, että hinta/kuvamuokkaus päätyi siihen lähteeseen, josta kortti piirretään.
Tarkista debuggeri uudelleen. Jos se nyt raportoi uuden kuvan ja Facebook näyttää edelleen vanhan kortin, kyseessä on Facebookin oma levitys, ei sinun tunnisteesi.

UKK

Onko olemassa virallista API:a Facebookin Open Graph -välimuistin tyhjentämiseen?

FastOG käyttää scrape-päätepistettä (POST https://graph.facebook.com/{version}/?id={page-url}&scrape=true&access_token={token}). Meta dokumentoi Sharing Debuggerin ja ohjelmallisen hakuroolin; tarkka päätepisteen muoto ja Graph API -versio voivat muuttua, joten varmista ne Metan nykyisestä dokumentaatiosta ennen kuin toteutat sen itse.

Ei. Se on julkinen työkalu ja toimii mille tahansa julkiselle URL-osoitteelle. Mitä se ei voi tehdä, on toimia aikataulun mukaan tai kattaa koko tuotekatalogin.

Maksavatko uudelleenhaut minulle FastOG-renderöinnin?

Yleensä ei. Kansikuva-URL on sisältöpohjainen, joten jos sisältö ei muuttunut, ei URL-kään muuttunut, ja haku osuu välimuistiin eikä kuluta renderöintiä. Jos hinta muuttui, URL muuttui — se on yksi uusi renderöinti, ja se on juuri se renderöinti, jonka halusit.

Korjaako Facebookin uudelleenhaku WhatsApp-esikatseluni?

Ei. Ne ovat erillisiä välimuisteja. Facebookin debuggeria kannattaa silti käyttää validaattorina — se hakee sivun samalla tavalla kuin WhatsApp ja raportoi löytämänsä — mutta se ei voi päivittää WhatsAppia.

Kuinka kauan Facebook säilyttää esikatselun, jos en koskaan pingaa sitä?

Meta dokumentoi noin 24 tunnin vakiouudelleenhakujakson, mutta tarkka välitysaika voi vaihdella. Siksi debugger ja ohjelmallinen hakupolku ovat olemassa.

Pitääkö minun pingata jokainen tuote katalogituonnin jälkeen?

Sitä varten jono on olemassa. Yhden pyynnön lähettäminen tuotetta kohden suoraan osuu Metan rajoituksiin ja hidastaa kauppiaan pyyntöä; jonossa ja deduplikoituna katalogin läpikäynti tyhjenee vaarattomasti.

Entä jos Meta hylkää pyynnön?

Mikään ei rikkoudu. Hylätty tai rajoitettu ping tarkoittaa, että Facebook päivittää oman aikataulunsa mukaan eikä välittömästi — sivun tagit ovat jo oikein, minkä vuoksi kutsu on parhaan yrityksen mukaan tehty eikä kova riippuvuus.