Tarvitsenko sekä Meta-pikselin että Conversions API:n?

Meta suosittelee käyttämään molempia. Pikseli lisää selaindataa, kuten fbp-evästeen, ja Conversions API toimittaa tapahtumat, jotka selain jättää huomaamatta. Anna molemmille kopioille sama tapahtuman nimi ja tapahtuma-ID, jotta Meta laskee jokaisen tapahtuman kerran.

Kuinka kauan Meta odottaa selain- ja palvelintapahtuman deduplikointia?

Meta deduplikoi selaintapahtuman ja palvelintapahtuman, joilla on sama tapahtuman nimi ja tapahtuma-ID, kun ne saapuvat 48 tunnin sisällä toisistaan. Myöhemmin saapuva kopio lasketaan uudelleen.

Pitääkö asiakasdata hashata Conversions API:ssa?

Kyllä, yhteystietojen osalta. Sähköposti-, puhelin-, nimi- ja osoitekentät on normalisoitava ja hashattava SHA-256:lla. IP-osoite, user agent, fbp ja fbc lähetetään ilman hashausta.

Mitkä kentät ovat pakollisia verkkosivustotapahtumalle?

Jokainen tapahtuma tarvitsee event_name-, event_time- ja action_source-kentät sekä vähintään yhden asiakastietoparametrin. Verkkosivustotapahtumille Meta vaatii myös event_source_url- ja client_user_agent-kentät.

Voinko lähettää vanhoja tilauksia Conversions API:n kautta?

Vain tuoreita. Kentän event_time voi olla enintään 7 päivää menneisyydessä, ja jos yksi pyynnön tapahtuma on vanhempi, Meta hylkää koko pyynnön.

Meta Conversions API (CAPI): käytännön opas

Tärkeimmät opit

Meta Conversions API lähettää tapahtumia, kuten Purchase, palvelimeltasi, joten ne tavoittavat Metan, vaikka selainpikseli olisi estetty.
Aja sitä pikselin rinnalla ja anna molemmille kopioille sama tapahtuman nimi ja event_id; Meta laskee tapahtuman silloin kerran, jos molemmat saapuvat 48 tunnin sisällä.
Verkkosivustotapahtumat tarvitsevat parametrit action_source ja event_source_url sekä ostajan user agentin; hashattu sähköposti ja puhelinnumero, IP-osoite, fbp ja fbc ratkaisevat, kuinka hyvin Meta pystyy yhdistämään ne.
Testaa Events Managerin Test events -välilehdellä ja poista sitten testikoodi, koska testitapahtumia ei hylätä.
Useimmat ongelmat johtuvat toisistaan poikkeavista tapahtuma-ID:istä, palvelimen omasta IP-osoitteesta, kadonneesta fbclid-arvosta tai yhteystiedoista, jotka on hashattu normalisoimatta.

Meta Conversions API (CAPI) antaa palvelimesi lähettää tapahtumia, kuten Purchase, suoraan Metalle. Meta-pikseli lähettää samat tapahtumat ostajan selaimesta. CAPI lähettää ne palvelimeltasi, joten ne saapuvat perille, vaikka mainosesto pysäyttäisi pikselin, eväste olisi kadonnut tai kiitossivu ei koskaan latautuisi.

Tämä opas käsittelee, mitä Conversions API -tapahtuma sisältää, miten sitä ajetaan pikselin rinnalla yhdellä event_id-arvolla, mitä parametreja Meta vaatii ja suosittelee, miten testataan Test events -työkalulla ja mitkä virheet ovat yleisimpiä.

Mikä Meta Conversions API on?

Conversions API on osa Metan Graph API:a. Palvelimesi lähettää HTTPS POST -pyynnön osoitteeseen graph.facebook.com/VERSION/PIXEL_ID/events käyttöoikeustokenin ja data-listan kanssa, jossa on enintään 1,000 tapahtumaa. Jokainen tapahtuma kuvaa yhden toiminnon, kuten oston, kolmessa osassa: mitä tapahtui, kuka sen teki ja yksityiskohdat.

Kenttä	Mitä se sisältää
`event_name`	Toiminto, esimerkiksi `Purchase`, `AddToCart` tai `InitiateCheckout`
`event_time`	Milloin se tapahtui, Unix-aikaleimana sekunteina
`event_id`	Tapahtuman yksilöllinen tunnus, jota käytetään sen deduplikointiin pikseliin nähden
`action_source`	Missä se tapahtui: `website` verkkokaupan ostoille
`event_source_url`	Sivun URL-osoite, jossa tapahtuma tapahtui
`user_data`	Asiakastiedot yhdistämistä varten: hashattu sähköposti ja puhelinnumero, IP-osoite, user agent, fbp ja fbc
`custom_data`	Yksityiskohdat, kuten `value`, `currency` ja `content_ids`

Jokaisella Conversions API -tapahtumalla on sama rakenne: toiminto, asiakastiedot ja yksityiskohdat.

Lyhennetty Purchase-tapahtuma näyttää tältä:

Conversions API: Purchase-tapahtuma (lyhennetty)

{
  "data": [{
    "event_name": "Purchase",
    "event_time": 1792929600,
    "event_id": "order-1042",
    "action_source": "website",
    "event_source_url": "https://yourstore.com/checkouts/thank-you",
    "user_data": {
      "em": ["<SHA-256 of the normalized email>"],
      "ph": ["<SHA-256 of the normalized phone>"],
      "client_ip_address": "203.0.113.24",
      "client_user_agent": "Mozilla/5.0 (iPhone; ...)",
      "fbp": "fb.1.1792928400000.1234567890",
      "fbc": "fb.1.1792928400000.AbCdEf123"
    },
    "custom_data": { "value": 74.00, "currency": "USD" }
  }]
}

Yhteystietokentät, kuten sähköposti ja puhelinnumero, normalisoidaan ja hashataan SHA-256:lla ennen kuin ne poistuvat palvelimeltasi. IP-osoite, user agent, fbp ja fbc lähetetään sellaisinaan.

Miksi Conversions API:a kannattaa ajaa pikselin rinnalla?

Meta suosittelee ajamaan Conversions API:a pikselin rinnalla ja lähettämään samat tapahtumat molempien kautta. Kumpikin puoli näkee jotain, mitä toinen ei näe, ja yhdessä ne antavat Metalle täydellisemmän datan.

Meta-pikseli (selain)

Asettaa _fbp-evästeen ja tallentaa mainosklikkauksen fbclid-arvon _fbc-evästeeseen
Näkee sivun ja selaimen käynnin aikana
Katoaa, kun selain estää sen tai sivu ei lataudu

Conversions API (palvelin)

Lähettää maksetun tilauksen kauppasi datasta
Voi lisätä tilauksesta hashatun sähköpostin, puhelinnumeron ja osoitteen
Ei riipu selaimesta, joten mainosestot eivät pysäytä sitä

Pikseli tuo selaimen tunnisteet ja palvelin tuo tilauksen. Kumpikin yksin jättää osan kuvasta puuttumaan.

Molempien käytön hinta on, että Meta saa nyt kaksi kopiota jokaisesta tapahtumasta. Seuraava osio näyttää, miten Meta säilyttää vain yhden.

Miten deduplikointi toimii yhdellä event_id-arvolla?

Meta pitää selaintapahtumaa ja palvelintapahtumaa samana tapahtumana, kun kaksi asiaa täsmää: tapahtuman nimi ja tapahtuma-ID. Pikselissä ID annetaan eventID-asetuksessa. Conversions API:ssa sama arvo annetaan kentässä event_id.

Meta-pikseli: sama Purchase eventID:llä

fbq('track', 'Purchase', { value: 74.00, currency: 'USD' }, { eventID: 'order-1042' });

Ostaja maksaaTilaus 1042, $74.00

Pikseli lähettää Purchase-tapahtumaneventID order-1042, selaimesta

Palvelin lähettää Purchase-tapahtumanevent_id order-1042, tilauksesta

Meta laskee yhdenSama nimi ja ID 48 tunnin sisällä

Molemmilla kopioilla on sama tapahtuman nimi ja ID, joten Meta säilyttää yhden oston kahden sijaan.

Meta deduplikoi täsmäävän parin vain, kun kaksi kopiota saapuvat 48 tunnin sisällä toisistaan. Muutama sääntö saa tämän toimimaan käytännössä:

Luo ID vain kerran. Muodosta se jostakin, minkä molemmat puolet tuntevat, kuten tilausnumerosta, ja välitä se selaimelle ja palvelimelle. Kaksi järjestelmää, jotka tekevät kumpikin oman ID:nsä, eivät täsmää.
Käytä yhtä muotoa. order-1042 ja 1042 ovat eri ID:itä.
Käytä tapahtuman nimeä täsmälleen samana. Purchase ja purchase ovat eri tapahtumia.
Lähetä palvelintapahtuma viipymättä. Palvelintapahtuma, joka saapuu yli 48 tuntia selaintapahtuman jälkeen, lasketaan toisen kerran.

Meta kuvaa myös toisen menetelmän, joka yhdistää tapahtumat fbp- tai external_id-arvon perusteella. Meta sanoo sen toimivan yleensä vain, kun selaintapahtuma saapuu ennen palvelintapahtumaa, joten yhteinen event_id on luotettavampi valinta. Jos Meta raportoi edelleen enemmän ostoja kuin kaupassasi oli, päällekkäisistä ostotapahtumista kertova oppaamme listaa tavalliset syyt.

Mitkä parametrit ovat pakollisia ja mitkä suositeltuja?

Pakolliset kentät tekevät tapahtumasta kelvollisen. Suositellut kentät ratkaisevat, kuinka suuren osan tapahtumistasi Meta pystyy yhdistämään henkilöön, ja vain yhdistettyjä tapahtumia voi käyttää attribuutioon ja mainosten jakeluun.

Parametri	Verkkosivustotapahtumat	Mitä lähetetään
`event_name`	Pakollinen	Vakiotapahtuma, kuten Purchase, tai mukautetun tapahtuman nimi
`event_time`	Pakollinen	Unix-aika sekunteina, enintään 7 päivää menneisyydessä
`action_source`	Pakollinen	`website` kauppasi tapahtumille
`event_source_url`	Pakollinen	Sivun URL-osoite, jossa tapahtuma tapahtui
`client_user_agent`	Pakollinen	Ostajan selaimen merkkijono, ei palvelimesi oma
`user_data`	Pakollinen	Vähintään yksi asiakastietoparametri
`event_id`	Suositeltu	Sama ID, jota pikseli käyttää, deduplikointia varten
`em`, `ph`	Suositeltu	Sähköposti ja puhelinnumero, normalisoituna ja hashattuna SHA-256:lla
`client_ip_address`	Suositeltu	Ostajan IP-osoite, ei hashattuna
`fbp`, `fbc`	Suositeltu	Selaimen tunnus- ja klikkaus-ID-evästeet, ei hashattuina
`external_id`	Suositeltu	Oma asiakastunnuksesi, sama selain- ja palvelintapahtumissa
`value`, `currency`	Lähetä Purchase-tapahtuman mukana	Tilauksen arvo ja kolmikirjaiminen valuuttakoodi

Meta listaa action_source-, event_source_url- ja client_user_agent-kentät pakollisiksi Conversions API:n kautta lähetetyille verkkosivustotapahtumille.

Kolme yksityiskohtaa aiheuttaa suurimman osan ongelmista:

Normalisoi ennen hashausta. Meta odottaa sähköpostin leikattuna ja pienillä kirjaimilla ja puhelinnumeroiden numeroina maan suuntanumeron kanssa. Anna@Example.com ja anna@example.com antavat eri hashit, ja vain jälkimmäinen voi täsmätä.
Älä hashaa selaimen tunnisteita. fbp, fbc, IP-osoite ja user agent annetaan selkeinä arvoina.
Säilytä klikkaus-ID täsmälleen sellaisena kuin se on. fbc-arvo on fb.1., luontiaika millisekunteina, piste ja laskeutumissivun URL-osoitteen fbclid. fbclid erottaa isot ja pienet kirjaimet. Tallenna se, kun kävijä saapuu, koska se ei ole enää URL-osoitteessa kassalla.

Se, kuinka hyvin nämä kentät täsmäävät, on se, mitä Metan Event Match Quality -pistemäärä mittaa. Event Match Quality -oppaamme käsittelee jokaisen parametrin, hashaussäännöt ja tavoiteltavan pistemäärän.

Miten tapahtumia testataan Test events -työkalulla?

Events Managerissa on Test events -välilehti, joka näyttää tapahtumat niiden saapuessa. Käytä sitä, ennen kuin luotat uuteen toteutukseen.

Avaa Test events
Valitse Events Managerissa tietojoukkosi (pikseli) ja avaa Test events -välilehti. Kopioi sen näyttämä testikoodi.
Lisää koodi palvelintapahtumiisi
Lähetä se pyynnössä kentässä test_event_code. ROASaurusissa liitä se Meta-pikselin Test event code -kenttään.
Tee testitilaus
Käy kaupassa, lisää tuote ostoskoriin ja maksa, jotta sekä pikseli että palvelin lähettävät Purchase-tapahtuman.
Vertaa kahta kopiota
Molemmissa kopioissa pitäisi näkyä sama tapahtuman nimi, tapahtuma-ID, arvo ja valuutta.
Tarkista asiakastiedot
Palvelintapahtumassa pitäisi olla hashattu sähköposti ja puhelinnumero, IP-osoite, user agent ja fbp sekä fbc, jos käynti alkoi mainosklikkauksesta.
Poista testikoodi
Meta sanoo, että kenttä on tarkoitettu vain testaukseen, joten poista se, ennen kuin luotat tapahtumiin.

Purchase browser order-1042 74.00 USDPikselistä

Purchase server order-1042 74.00 USDConversions API:sta

event_name + event_id matchLasketaan yhtenä ostona

em ph fbp fbc client_ip_address client_user_agentAsiakastiedot palvelintapahtumassa

Mitä hyvä testitilaus näyttää (esimerkkiarvot): kaksi kopiota, yksi ID ja täydelliset asiakastiedot.

Yleiset Conversions API:n virheet ja niiden korjaaminen

Mitä näet	Todennäköinen syy	Korjaus
Koko pyyntö epäonnistuu eikä yhtään tapahtumaa käsitellä	Yhden erän tapahtuman event_time on yli 7 päivää vanha	Lähetä tapahtumat, kun ne tapahtuvat. Korjaa tai pudota vanhat tapahtumat pois ennen uudelleenyritystä.
Meta raportoi enemmän ostoja kuin kaupassasi oli	Eri tapahtuma-ID:t, pikselitapahtuma ilman eventID:tä tai toinen sovellus, joka lähettää saman pikselin	Käytä yhtä ID:tä molemmille kopioille ja yhtä palvelinlähettäjää pikseliä kohden.
Matala yhdistämislaatu palvelintapahtumissa	Palvelimesi lähettää oman IP-osoitteensa ja user agentinsa	Välitä ostajan selaimesta tai tilauksesta tallennettu IP-osoite ja user agent.
Vähän tapahtumia, joissa on fbc	fbclid:tä ei tallennettu laskeutumissivulla tai sitä muutettiin	Tallenna fbclid täsmälleen siinä muodossa kuin se saapuu ja muodosta fbc siitä.
Sähköposti ja puhelinnumero eivät täsmää	Arvot hashattiin normalisoimatta tai ne lähetettiin hashaamatta	Poista sähköpostista ylimääräiset välilyönnit ja muuta se pieniksi kirjaimiksi, säilytä puhelinnumeron numerot ja maan suuntanumero ja hashaa sitten SHA-256:lla.
Pyynnöt epäonnistuvat virheeseen, joka kertoo tokenin vanhentuneen	Käyttöoikeustoken tuli Facebook-kirjautumisesta, ja kirjautumistokenit vanhenevat	Yhdistä uudelleen tai käytä Business Managerin System User -tokenia, jonka voi luoda ilman päättymispäivää.

Useimmat Conversions API -ongelmat näkyvät hylättyinä pyyntöinä, kaksoislaskentana tai matalana yhdistämislaatuna.

Kun reaaliliikennettä on kertynyt muutaman päivän ajalta, avaa Events Managerissa Diagnostics-välilehti. Meta listaa siellä ongelmat ja suositukset niiden korjaamiseen. Vertaa sitten Events Managerin päivittäistä Purchase-määrää kaupassasi samoina päivinä maksettuihin tilauksiin. Jos Meta on selvästi korkeampi, kaksoislaskennan estämistä käsittelevä ohjesivumme listaa tarkistettavat asetukset.

Conversions API:n käyttöönotto ROASaurusin kanssa

ROASaurus lähettää Conversions API -tapahtumat kauppasi tilausdatasta, joten palvelinpuolta ei tarvitse rakentaa itse. Klikkaa kohdassa Tracking & platforms Connect with Facebook ja valitse mainostilisi ja pikselisi tai liitä pikselin (tietojoukon) ID ja Conversions API -token. Metan käyttöönotto-opas käy läpi molemmat vaihtoehdot, ja Meta-integraatiosivu listaa kaikki lähetettävät kentät.

Yksi ID molemmilla puolilla. Selain- ja palvelintapahtumat jakavat yhden tapahtuma-ID:n. Ostolla se on order- ja sen perässä tilauksen ID.
Lyhyt odotus ennen ostoa. Palvelimen Purchase odottaa hetken tilauksen saapumisen jälkeen, jotta selaimen ostotapahtuma voidaan yhdistää ensin. Sen IP-osoite, user agent ja sivun URL lähtevät sitten palvelintapahtuman mukana kävijälle tallennettujen fbp- ja fbc-arvojen kanssa.
Asiakastiedot tilauksesta. Sähköposti, puhelinnumero, nimi ja osoite normalisoidaan ja hashataan SHA-256:lla. Kaupan asiakastunnus ja ROASaurus-kävijätunnus lähetetään hashattuina arvona external_id.
Tapahtumat, joita Meta ei voi yhdistää, ohitetaan. Tapahtumaa, jossa ei ole fbc:tä, fbp:tä, sähköpostia, puhelinnumeroa eikä IP-osoitetta, ei lähetetä.

Event log näyttää jokaisen palvelinlähetyksen pyyntöineen ja Metan vastauksineen. Jos katteesi vaihtelevat paljon tuotteiden välillä, voit lähettää myös voittoarvon jokaisen oston rinnalla: Metan arvon optimointi voitolle -oppaamme selittää, miten. Koko datapolku klikkauksesta tilaukseen on kuvattu osiossa palvelinpuolen seuranta.

Lähteet

ROASaurusissa

Lue lisää

Mainosalustat ja verkkokaupatPostiennakkotilausten konversioseuranta ja ulkoiset kassatPostiennakkotilausten konversioseuranta: miksi pikselit eivät näe postiennakko- ja ulkoisen kassan tilauksia, milloin osto kannattaa lähettää ja miten vastaanottamatta jätetyt tilaukset käsitellään.Mainosalustat ja verkkokaupatCCV Shop -konversioseuranta: käyttöönoto-opasCCV Shop -konversioseuranta: lähetä maksetut tilaukset Metalle ja TikTokille allekirjoitetulla webhookilla, yhdistä ne mainosklikkauksiin, ota seuranta käyttöön, testaa se ja hoida myöhässä tulevat maksut.Mainosalustat ja verkkokaupatGoogle Adsin Enhanced conversions ShopifyssaEnhanced conversions lisäävät Google Adsin ostoihin hashattua asiakasdataa Shopifyssa. Miten ne toimivat, miten ne eroavat offline-tuonneista ja miten ne otetaan käyttöön.