Asennusoppaat

Meta Pixelin käyttöönotto ja Conversions API

Kerromme, miten Meta Pixel lisätään sivustolle, vakiotapahtumat määritellään, palvelinpuolen Conversions API otetaan käyttöön ja tapahtumat testataan.

Aurora YazılımToimitustiimi 6 min lukuaika
Meta Pixelin käyttöönotto ja Conversions API
Miten Meta Pixel asennetaan?

Meta Pixelin asennusta varten luot Metan Tapahtumienhallintaan uuden verkkodatalähteen (pikselin) ja lisäät peruskoodin sivustosi head-osaan tai Google Tag Manageriin. Sen jälkeen määrittelet vakiotapahtumat, kuten oston ja ostoskoriin lisäämisen, yhdistät Conversions API:n mittauksen vahvistamiseksi ja varmistat tapahtumat Testitapahtumat-näkymässä.

Mikä on Meta Pixel ja miksi sitä tarvitaan?

Meta Pixel (aiemmin Facebook-pikseli) on sivustollesi lisättävä JavaScript-koodi, joka ilmoittaa Metalle kävijöiden tekemät toiminnot. Sen avulla näet, minkä myynnin, lomakkeen tai jäsenyyden Facebook- ja Instagram-mainokset toivat.

Pikselin todellinen voima ulottuu mittausta pidemmälle. Metan mainosjärjestelmä oppii tapahtumista, kuten ostoista, ja näyttää mainoksen ihmisille, joilla on suuri todennäköisyys konvertoitua. Myös mukautetut kohderyhmät, joilla tavoitat sivustollasi vierailleet tai tuotteita katselleet uudelleen, luodaan pikselidatalla.

Selainpohjainen mittaus voi jättää joitakin tapahtumia huomaamatta mainosten estäjien, selaimen tietosuoja-asetusten ja yhteyskatkosten takia. Tämän aukon täyttämiseksi pikseliä käytetään yhdessä palvelimelta lähetettävän Conversions API:n kanssa.

Valmistelu ennen asennusta

Luo pikseli ja mainostili yrityksen omaan portfolioon; anna toimistolle vain jaettu käyttöoikeus. Näin kertynyt mittausdata ja kohderyhmät jäävät yritykselle, vaikka yhteistyö muuttuisi. Meta Pixel ei korvaa GA4:ää; jos haluat käyttää molempia yhdessä, tutustu myös Google Analytics 4 -asennus -oppaaseemme.

  • Yrityksen oma Meta-yritysportfolio (Business Manager) ja mainostili
  • Käyttöoikeus sivustoon tai tunnisteidenhallintaan
  • Luettelo mitattavista tapahtumista: tuotteen katselu, ostoskoriin lisäys, kassan aloitus, osto, lomakkeen lähetys
  • Tieto siitä, sitooko evästesuostumusratkaisusi mittauskoodit suostumukseen

Pikselin luominen ja peruskoodi

Avaa Metan Tapahtumienhallinta, valitse Yhdistä datalähteet -vaiheessa Web ja anna pikselillesi nimi. Sen jälkeen valitset asennustavan: koodin lisääminen käsin, kumppaniintegraation käyttö tai asennus Google Tag Managerin kautta.

Käsin asennettaessa lisää Metan antama peruskoodi jokaisen sivun head-osaan. Koodi lähettää PageView-tapahtuman aina, kun sivu latautuu. Alla olevassa esimerkissä PIXEL_ID:n tilalle tulee oma pikselitunnuksesi; kopioi koodi aina Tapahtumienhallinnasta.

html
<!-- Meta Pixel Code -->
<script>
!function(f,b,e,v,n,t,s)
{if(f.fbq)return;n=f.fbq=function(){n.callMethod?
n.callMethod.apply(n,arguments):n.queue.push(arguments)};
if(!f._fbq)f._fbq=n;n.push=n;n.loaded=!0;n.version='2.0';
n.queue=[];t=b.createElement(e);t.async=!0;
t.src=v;s=b.getElementsByTagName(e)[0];
s.parentNode.insertBefore(t,s)}(window, document,'script',
'https://connect.facebook.net/en_US/fbevents.js');
fbq('init', 'PIXEL_ID');
fbq('track', 'PageView');
</script>
<noscript><img height="1" width="1" style="display:none"
src="https://www.facebook.com/tr?id=PIXEL_ID&ev=PageView&noscript=1"
/></noscript>
<!-- End Meta Pixel Code -->

Google Tag Managerilla

Jos käytät GTM:ää, voit lisätä peruskoodin Custom HTML -tunnisteella ja ajaa sen kaikilla sivuilla. Tapahtumien kytkeminen data layer -laukaisimiin tekee mittauksesta kestävän suunnittelumuutoksia vastaan; lisätietoja artikkelissamme Google Tag Managerin asennus.

Alustan hallintapaneelista

Jotkin alustat tukevat pikselitunnuksen hakemista paneelista ja tapahtumien lähettämistä itse. Auroran verkkokauppa-alustassa Meta-yhteys yhdistää tuotekatalogin ja mittaa konversiot ilman kaksoislaskentaa; koodit lisätään paneelista.

Vakiotapahtumat ja parametrit

Metan määrittelemien vakiotapahtumien nimien käyttö saa mainosoptimoinnin ja raportit toimimaan itsestään. Ostotapahtumassa summa ja valuutta ovat pakollisia; tuotetunnisteet auttavat luettelomainoksia näyttämään oikean tuotteen.

TapahtumaMilloin lähetetään?
ViewContentKun tuote- tai palvelusivu avataan
AddToCartKun tuote lisätään ostoskoriin
InitiateCheckoutKun kassavaihe alkaa
PurchaseKun tilaus on valmis
LeadKun lomake tai tarjouspyyntö lähetetään
CompleteRegistrationKun rekisteröityminen on valmis
javascript
fbq('track', 'AddToCart', {
  content_ids: ['URN-12'],
  content_type: 'product',
  value: 1499.90,
  currency: 'TRY'
});

// Osto: eventID tarvitaan päällekkäisyyksien poistoon
fbq('track', 'Purchase', {
  value: 1499.90,
  currency: 'TRY',
  content_ids: ['URN-12'],
  content_type: 'product'
}, { eventID: 'SIP-10045' });

Conversions API:n käyttöönotto

Conversions API lähettää tapahtumat Metalle suoraan palvelimeltasi kävijän selaimen sijaan. Mainosten estäjät eivät vaikuta siihen, ja se välittää vahvistetun datan, kuten tilaukset, suoraan lähteestä. Meta suosittelee pikselin ja API:n käyttöä yhdessä parhaan tuloksen saamiseksi.

Luo käyttöönottoa varten Tapahtumienhallinnassa pikselin asetukset-välilehdellä käyttöoikeustunniste (access token). Tämä tunniste on salasana: tallenna se vain palvelimelle äläkä koskaan laita sitä selaimen koodiin tai julkiseen arkistoon. Tämän jälkeen palvelimesi lähettää jokaisesta tärkeästä tapahtumasta pyynnön Graph API:n events-päätepisteeseen.

Pienille sivustoille, joilla ei ole omaa palvelinta, on myös vähemmän koodia vaativia vaihtoehtoja, kuten Metan kumppaniintegraatiot ja Conversions API Gateway. Laskeutumissivun suunnittelu -projektissa, joka vastaanottaa mainosliikennettä, pikselin ja API:n asennus kannattaa varmistaa testiympäristössä ennen sivun julkaisua; näin dataa ei katoa kampanjan ensimmäisestä päivästä alkaen.

  • event_time on tapahtuman Unix-aikaleima (sekunteina), ja sen pitää osoittaa hetki, jolloin tapahtuma tapahtui.
  • Henkilötiedot, kuten sähköposti ja puhelinnumero, lähetetään SHA-256-tiivisteenä; muotoile puhelinnumero ensin maatunnuksen kanssa pelkiksi numeroiksi.
  • Tarkista Graph API:n versionumero Metan kehittäjädokumentaatiosta; vanhat versiot poistuvat ajan myötä käytöstä.
bashEsimerkkipyyntö (vaihda versio ja tunnisteet omiin arvoihisi)
curl -X POST "https://graph.facebook.com/v<SURUM>/<PIXEL_ID>/events?access_token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "data": [{
      "event_name": "Purchase",
      "event_time": 1767225600,
      "event_id": "SIP-10045",
      "action_source": "website",
      "event_source_url": "https://ornek.com/tesekkurler/",
      "user_data": {
        "em": ["<SHA256_ILE_KARMALANMIS_EPOSTA>"],
        "client_ip_address": "203.0.113.10",
        "client_user_agent": "Mozilla/5.0 ...",
        "fbp": "fb.1.1767225000000.1234567890"
      },
      "custom_data": { "value": 1499.90, "currency": "TRY" }
    }],
    "test_event_code": "TEST12345"
  }'
bashSähköpostin tiivistäminen (pienet kirjaimet, ei välilyöntejä)
printf '%s' 'ornek@alanadi.com' | sha256sum

Päällekkäisyyden poisto: miksi tapahtumat lasketaan kahdesti?

Kun sama osto lähetetään sekä pikselistä että API:sta, Metan täytyy ymmärtää, että kyseessä on yksi tapahtuma. Tätä kutsutaan päällekkäisyyden poistoksi (deduplication), ja se perustuu kahteen ehtoon: tapahtuman nimen ja tapahtumatunnuksen on oltava täsmälleen samat molemmissa lähteissä.

Huomaa yllä olevissa esimerkeissä, että samaan tilausnumeroon viitataan selainpuolella eventID-kentässä ja palvelinpuolella event_id-kentässä. Jos tätä vastaavuutta ei muodosteta, myynnit näkyvät raporteissa kaksinkertaisina ja mainosjärjestelmä oppii väärästä datasta.

Näet Tapahtumienhallinnassa tapahtuman tiedoista, että päällekkäisyyden poisto toimii: sama tapahtuma on vastaanotettu sekä selaimen että palvelimen lähteestä ja listattu päällekkäisyydestä poistettuna. Pieni aikaero lähteiden välillä ei haittaa.

Tapahtumien testaus ja varmistus

Tapahtumienhallinnan Testitapahtumat-välilehti näyttää tapahtumat reaaliajassa. Nähdäksesi selaintapahtumat syötä sivustosi osoite ja tee toimintoja avautuvassa ikkunassa; palvelintapahtumia varten lisää näytöllä näkyvä testikoodi pyyntösi test_event_code-kenttään ja poista kenttä siirtyessäsi tuotantoon.

Myös Meta Pixel Helper -selainlaajennus näyttää, mikä tapahtuma toimii millä sivulla ja millä parametreilla. Muutaman päivän kuluttua käyttöönotosta katso Tapahtumienhallinnan tapahtumien vastaavuuslaadun pisteet; jos pisteet ovat matalat, palvelintapahtumiin voi olla lisättävä enemmän tiivistettyjä asiakastietoja.

OngelmaTodennäköinen syy ja ratkaisu
Tapahtuma ei näyPikselitunnus on väärä tai koodia ei ole julkaistu; tarkista Pixel Helperilla.
Myynnit kaksinkertaisiaevent_id ei täsmää tai pikseli latautuu kahdesti.
API-pyyntö antaa virheenTunniste on virheellinen, versio vanha tai event_time liian vanha; lue vastauksen virheilmoitus.
Summa on väärävalue lähetetään lukuna merkkijonon sijaan tai currency puuttuu.

Tietosuoja ja suostumus

Pikseli ja Conversions API käsittelevät henkilötietoja. Mainosmittauskoodeja ei saa ajaa ennen kuin kävijä on antanut suostumuksen, lähetettävä data on kuvattava tietosuojaselosteessasi ja jaettavaksi saa antaa vain tarpeelliset tiedot. Arkaluonteisissa kategorioissa, kuten terveydessä, Metalla on lisäksi lisärajoituksia.

Tämä artikkeli antaa yleistä tietoa. Tarkista evästesuostumusprosessisi, tietosuojaselosteesi ja ulkomaille tapahtuvan tiedonsiirron osalta ajantasainen KVKK-lainsäädäntö (Turkin tietosuojalaki, vertailukelpoinen GDPR:n kanssa) ja oikeudellinen neuvonantajasi. Jos haluat tietää, millä mittareilla mainonnan suorituskykyä luetaan, artikkelimme somen mittarit on hyvä alku.

Usein kysytyt kysymykset

01Onko Facebook-pikseli sama asia kuin Meta Pixel?

Kyllä. Kun Facebookin emoyhtiö otti nimekseen Meta, työkalusta alettiin käyttää nimeä Meta Pixel. Samaa pikseliä käytetään sekä Facebook- että Instagram-mainosten mittaamiseen.

02Riittääkö pikseli ilman Conversions API:a?

Pikseli toimii yksinään, mutta selainperäisten datahäviöiden vuoksi osa konversioista ei välttämättä näy raporteissa. Mainosbudjetin kasvaessa ja myynnin tullessa suoraan sivustolta API:n lisääminen parantaa mittauksen luotettavuutta selvästi.

03Tarvitaanko Instagram-mainosten seurantaan erillinen asennus?

Ei. Instagram-mainokset mitataan samalta mainostililtä ja samalla pikselillä. Riittää, että valitset mainosjoukossa oikean pikselin ja optimoitavan tapahtuman.

Kun pikseli ja Conversions API on otettu käyttöön yhdessä päällekkäisyyden poiston säännöillä, voit mitata mainosbudjettisi tuoton luotettavasti. Mittausinfrastruktuurin rakentamiseen ja kampanjoiden hallintaan tämän datan avulla tutustu digimarkkinointipalveluumme ja Instagramin ja Facebookin sisällön ja mainonnan hallintaan sosiaalisen median ratkaisuihimme. Raporttien tulkinnassa voit hyödyntää myös SEO ja analytiikka -tukeamme.