Facebook Conversions API: Toteutusopas vuodelle 2026

Kirjoittanut Marcus Chen

Suorituskykymarkkinoinnin asiantuntijat Kokeneiden mediaostajien tarkistama

AI-pikavastaus

Testaa 15 tai enemmän mainosvarianttia viikossa kontrolloidulla koukkumatriisilla, päivitä heti kun väsymys näkyy koukkusuhteessa, ja anna alustan DCO yhdistellä voittajia. Varianttien nopeus päihittää studiotyön laadun jokaisella maksullisella some- ja hakupaikalla, jota olemme mitanneet. Unled ajaa testauslaitteistoa ja tuotantolinjaa yhtenä operaationa.

Julkaistu 10 heinäkuuta 2026

12 min lukuaika · Asennus

Facebookin Conversions API (CAPI) on selainpikselin palvelinpuolen vastine. iOS 14.5:n romutettua selainpohjaisen seurannan CAPI:sta tuli ainoa tapa saada takaisin ne konversiot, jotka Meta menetti. Vuonna 2026 mainostajat, jotka käyttävät vain pikseliä, jättävät 30-60 % attribuoiduista konversioista pöydälle. Tämä opas kattaa puhtaan CAPI-asennuksen alusta loppuun.

Mitä CAPI oikeastaan tekee

CAPI lähettää konversiotapahtumat suoraan palvelimeltasi Metalle ohittaen selaimen kokonaan. Tämä tarkoittaa, että tapahtumat saapuvat, vaikka selainpikseli olisi estetty, käyttäjän iOS-laite rajoittaisi seurantaa tai verkkoyhteys häiritsisi pikseliä.

• Palauttaa iOS-konversiot. ATT-rajoitetut käyttäjät laukaisevat silti palvelintapahtumia.
• Ohittaa mainosblokkaajat. Palvelimelta palvelimelle -tapahtumia ei estetä.
• Korkeampi datan laatu. Palvelintapahtumat voivat sisältää omia tunnisteita (hajautettu sähköposti, puhelin, asiakastunnus) parempaa täsmäystä varten.
• Parempi deduplikointi. Yhdistettynä pikseliin event_id-tunnisteen avulla Meta deduplikoi ja laskee jokaisen konversion vain kerran.

Kolme asennustapaa

1. Alustojen natiiviliitännät (helpoin)

Shopifyssa, WooCommercessa, BigCommercessa, Magentossa, Wixissä ja Squarespacessa on kaikissa natiivit Meta CAPI -liittimet. Ota käyttöön alustasi hallintapaneelissa, liitä pääsyavain, valmista. Paras ei-kehittäjätiimeille.

2. Palvelinpuolen tag manager (suositeltu)

Käytä Stapea tai Google Tag Manager Server-Sideä lähettääksesi CAPI-tapahtumia sGTM-säiliöstä. Saat täyden tapahtumahallinnan, deduplikoinnin ja Advanced Matchingin ilman palvelinkoodin kirjoittamista. Alan standardi vakaville toimijoille.

3. Suora API-integraatio (eniten hallintaa)

Lähetä POST-pyynnöt suoraan osoitteeseen https://graph.facebook.com/v18.0/{pixel_id}/events backendistäsi. Paras SaaS:lle, mukautetuille sovelluksille ja kaikelle, mikä ei ole rakennettu suuren kaupankäyntialustan päälle.

Vaihe vaiheelta: Suora API-toteutus

1. Luo CAPI-pääsyavain. Events Manager → pikselisi → Settings → Conversions API → Generate Access Token.
2. Valitse palvelimelle lähetettävät tapahtumat. Lähetä aina Purchase, Lead ja CompleteRegistration. Valinnaiset: ViewContent, AddToCart, InitiateCheckout rikkaampaa täsmäystä varten.
3. Rakenna tapahtuman hyötykuorma. Pakolliset: event_name, event_time, action_source ("website"), event_id (deduplikointia varten) ja user_data (hajautettu sähköposti/puhelin/external_id).
4. Hajauta kaikki user_data-kentät SHA-256:lla. Sähköposti, puhelin, nimi, kaupunki, osavaltio, postinumero, kaikki hajautettu, pienellä kirjoitettu, typistetty.
5. Lähetä POST Graph API -päätepisteeseen. Sisällytä pääsyavain kyselyparametrina tai otsikkona.
6. Aseta uudelleenyrityslogiikka. Epäonnistuneet POST-pyynnöt (5xx-virheet) tulisi yrittää uudelleen eksponentiaalisella viiveellä enintään 3 kertaa.
7. Kirjaa jokainen tapahtuma tarkastusta varten. Tallenna tapahtuman hyötykuorma ja Metan vastaus, jotta voit jäljittää attribuutiota myöhemmin.

Tapahtumien deduplikointi: Kriittinen yksityiskohta

• Luo yksilöllinen event_id jokaiselle konversiolle (esim. tilausnumerosi).
• Lähetä sama event_id sekä selainpikselikutsussa että CAPI-tapahtumassa.
• Varmista, että event_name täsmää tarkalleen, "Purchase" eikä "purchase".
• Varmista, että event_time on enintään 1 minuutin sisällä kahden tapahtuman välillä puhtaan deduplikoinnin varmistamiseksi.
• Käytä Events Managerin Deduplication-raporttia varmistaaksesi, että suhteet ovat terveitä (selain+palvelin yhteensopivien tapahtumien tulisi olla hallitseva lokero).

Advanced Matching: Miksi hajautetut tunnisteet ovat tärkeitä

CAPI antaa sinun välittää käyttäjätunnisteita (hajautettu sähköposti, puhelin, nimi, kaupunki jne.) jokaisessa tapahtumassa. Meta käyttää näitä yhdistääkseen konversion takaisin mainosta klikanneeseen käyttäjään, vaikka selaineväste olisi poistettu.

• Sähköposti (em): Yksi vaikuttavin tunniste. Välitä se jokaisessa mahdollisessa tapahtumassa.
• Puhelin (ph): Numero, ilman muotoilua, maakoodilla (esim. 14155551234).
• Etunimi (fn) ja sukunimi (ln): Pienellä kirjoitettuna.
• Kaupunki (ct), osavaltio (st), postinumero (zp), maa (country): Kaikki pienellä kirjoitettuna, ilman välilyöntejä.
• Ulkoinen tunnus (external_id): Sisäinen asiakastunnuksesi, hajautettuna. Erinomainen toistuvien ostajien täsmäykseen.
• Klikkaus-ID (fbc) ja selain-ID (fbp): Ota kiinni selainevästeistä ja välitä jokaisessa palvelintapahtumassa vahvempaa täsmäystä varten.

CAPI:n toimivuuden vahvistaminen

1. Events Manager → Diagnostics-välilehti. Ei pitäisi näyttää kriittisiä varoituksia.
2. Events Manager → Event Quality / Event Match Quality. Pyri 7+ pisteeseen 10 pisteen asteikolla.
3. Events Manager → Events Received -pylväskaavio. Varmista, että sekä Browser- että Server-palkit ovat täytettyjä.
4. Test Events. Luo test_event_code, laukaise oikea konversio ja katso sen saapuvan reaaliajassa.
5. 7 päivän jälkeen: Vertaa attribuoituja konversioita Ads Managerissa ennen CAPI:a ja sen jälkeen. Yli 20 %:n nousu attribuoiduissa konversioissa vahvistaa CAPI:n palauttavan dataa.

CAPI ei ole enää valinnainen. Mainostajat, jotka käyttävät vain pikseliä vuonna 2026, kilpailevat toinen käsi selän takana. Valitse pinoosi sopiva asennustapa, deduplikoi oikein ja vahvista Event Match Qualitylla. Kahden päivän työ maksaa itsensä takaisin pysyvästi.