Cloudflare Zaraz WooCommerce-verkkokaupalle: verkkokaupan tapahtumat, suostumus ja testaus

Cloudflare Zaraz voi välittää tuetut verkkokaupan tapahtumat analytiikka- ja mainostyökaluille, mutta WooCommerce tarvitsee silti luotettavan lähteen tuote-, ostoskori-, kassa- ja tilaustiedoille. Tuotantokäyttöön sopiva toteutus riippuu integraatiotavasta, selkeistä suostumussäännöistä ja testeistä, joissa seurantaa verrataan kaupan todellisiin tilauksiin.

Mitä Cloudflare Zaraz muuttaa WooCommercen seurannassa?

Zaraz ohjaa kolmansien osapuolten työkalujen tuetut toiminnot Cloudflaren kautta. WooCommercen tai integraation on edelleen tuotettava kaupan tapahtumat ja tiedot, ja jokainen kohdetyökalu, lisäosa ja kassaprosessi vaatii oman yhteensopivuustarkistuksensa.

Zaraz tarjoaa verkkokaupan Web API:n, jossa on nimetyt tapahtumat koko ostopolulle tuote- ja ostoskoritoiminnoista valmistuneisiin ja hyvitettyihin tilauksiin. Cloudflaren dokumentaatio luettelee 19 tuettua tapahtumanimeä, edellyttää verkkokauppaseurannan käyttöönottoa tilillä ja jokaisessa vastaanottavassa työkalussa ja varoittaa, että suuret tilaustietosisällöt voivat ylittää kohdetyökalun rajat.

WooCommerce on edelleen kaupan tilan lähde. Se tietää, minkä tuotteen asiakas valitsi, mitä ostoskorissa on ja onko tilaus saavuttanut tilan, jonka yrityksenne laskee ostoksi. Zaraz välittää tapahtumat määritetyille työkaluille.

Tapahtuma voi näkyä Zarazissa ja silti jäädä saapumatta kohdetyökaluun: sen toiminto on poistettu käytöstä, sisältö ei vastaa työkalun odotuksia, työkalu ei tue tapahtumaa automaattisesti tai suostumus esti sen.

Seurantatoimintojen siirtäminen Zarazille voi vähentää kolmansien osapuolten skriptejä, joita selain suorittaa suoraan. Useat työkalut, kuten Zarazin Facebook-työkalu, lähettävät pyyntönsä Cloudflaren reunaverkosta sen sijaan, että lataisivat palveluntarjoajan skriptin. Zarazin lataaja suoritetaan silti, ja jotkin työkalut toimivat yhä selaimessa, joten mitatkaa tuote-, ostoskori- ja kassasivut ennen muutosta ja sen jälkeen. IMADOn WordPressin nopeusoptimointi voi sisältää tämän mittauksen, kun seurannan muutokset ovat osa laajempaa suorituskyvyn arviointia.

Miten WooCommerce-tapahtumat kannattaa kohdistaa Zarazin verkkokauppatapahtumiin?

Käyttäkää yhtä dokumentoitua tapahtumasopimusta tuote-, ostoskori-, kassa- ja tilaustapahtumille niin, että tuotetunnisteet, tilausnumerot, valuutta, määrät ja arvot ovat johdonmukaisia. Lähettäkää Order Completed vasta, kun kaupan ostoehto täyttyy.

Order Completed -kutsu, jossa on Zarazin dokumentoimat kentät, näyttää vähimmillään tältä:

zaraz.ecommerce('Order Completed', {
  order_id: '10482',
  total: 349.00,
  revenue: 300.81,
  tax: 48.19,
  shipping: 0,
  currency: 'PLN',
  products: [
    { product_id: '275333', sku: 'DDS-M1', name: 'Silk scarf', variant: '63 x 63 cm', price: 349.00, quantity: 1 }
  ]
});

Päättäkää, raportoiko yritys tilauksen, kun maksu on katevarmennettu, veloitettu vai kun tilaus saavuttaa jonkin muun tilan. Tällä on merkitystä tilisiirroissa, postiennakossa, maksujen uudelleenohjauksissa ja tilauksissa, joissa kassan viimeistely ja maksun selvitys tapahtuvat eri aikaan.

Variaatiotuotteet tarvitsevat harkitun tunnistesäännön

Moni asiakas avaa variaatiotuotteen eikä koskaan valitse variaatiota. Myös tuotesyötteet eroavat: Google Merchant Center -syöte listaa usein variaatiot, kun taas Metan katalogit ryhmittelevät variaatiot päätuotteen alle. Käytännöllinen sääntö on yksi tuotenäyttö sivunlatausta kohden: lähettäkää variaation tunniste, kun oletus- tai valittu variaatio on olemassa, ja muuten päätuotteen tunniste Metalle arvolla contenttype: productgroup. Älkää lähettäkö uutta näyttöä aina, kun asiakas vaihtaa variaatiota.

Pitäkää rahakentät ja tuotetunnisteet johdonmukaisina

Käyttäkää pysyvää tilausnumeroa ostojen täsmäyttämiseen WooCommercen ja analytiikan välillä, ja käyttäkää sitä myös tapahtumatunnisteena, jotta kohdetyökalut voivat poistaa uudelleenlähetysten kaksoiskappaleet. Välittäkää valuutta erikseen. Kirjatkaa, sisältääkö oston arvo verot ja toimituskulut ja miten alennukset käsitellään, ja kohdistakaa nämä kentät samalla tavalla jokaiseen kohdetyökaluun. Jos yksi työkalu saa bruttosumman ja toinen tuotteiden nettoarvon, raportit eroavat, vaikka molemmat tietovirrat toimisivat.

Käsitelkää kassalohkot ja maksujen uudelleenohjaukset erillisinä testitapauksina

Tilaa-painikkeen klikkaus käynnistää kassan. Validointi voi epäonnistua, maksupalvelu voi hylätä veloituksen tai uudelleenohjaus voi palata ilman onnistunutta tilausta. Lähettäkää oston tulo vasta, kun WooCommerce tai maksuprosessi vahvistaa sen.

Klassinen kassa, Checkout Block, AJAX-ostoskorit, pikamaksupainikkeet ja ulkoiset maksusivut tarjoavat erilaiset tapahtumat ja paluupolut. Kuunnelkaa sen kassan lisäosapisteitä, jota todella käytätte, ja tarkistakaa tulos lopullisesta tilaustietueesta.

WooCommerce-lisäosa vai oma Zaraz-tapahtumakytkentä?

Käyttäkää ylläpidettyä integraatiota, kun se tukee kassaanne, suostumusasetuksianne, kohdetyökalujanne ja tapahtumasopimustanne. Valitkaa oma kytkentä, kun kassa tai tilaussäännöt vaativat hallintaa, jota lisäosa ei tarjoa.

Ennen kuin otatte lisäosan käyttöön, varmistakaa, että:

• Se tukee WooCommerce-versiotanne, kassatyyppiänne, maksutapojanne ja tuotetyyppejänne.
• Se lähettää tapahtumanimet ja kentät, joita kohdetyökalunne vaativat.
• Sen suostumusintegraatio toimii suostumusten hallintatyökalunne kanssa.
• Voitte tarkastella, viedä ja palauttaa Zaraz-määritykset.
• Tiimi tietää, mikä järjestelmä vastaa kustakin tapahtumasta ja mistä vikoja etsitään.

Ennen kuin tuotte generoidun Zaraz-määrityksen, käykää läpi sen muuttamat laukaisimet, toiminnot ja työkaluasetukset, testatkaa se hallitussa ympäristössä ja varmistakaa, miten muutos perutaan. WordPress-sivuston auditointi voi käydä läpi nykyiset lisäosat, seurannan ja kassaprosessin ennen kuin teette valinnan.

Oma kytkentä sopii yleensä räätälöityihin kassoihin, tilauksiin, viivästettyyn maksun vahvistukseen, monivaluuttasääntöihin, ERP-järjestelmän ohjaamiin tilaustiloihin tai selain- ja palvelinpuolen signaalien yhdistelmään. Sen avulla kehittäjät määrittävät, milloin tapahtumat laukeavat ja miten uudelleenyritykset, hyvitykset ja kaksinkertaiset callbackit käsitellään, ja se tarvitsee omistajan, kun WooCommerce, maksuyhdyskäytävät tai lisäosat muuttuvat.

Hybridiratkaisu voi toimia: lisäosa tavallisille tuote- ja ostoskoritapahtumille ja pieni oma integraatio erityiselle osto- tai hyvityssäännölle. Pitäkää kullekin tapahtumalle yksi totuuden lähde. Päällekkäiset lisäosat, Google Tag Managerin tagit ja Zaraz-toiminnot samalle pikselille voivat laskea yhden oston useaan kertaan.

Jos punnitsette näitä vaihtoehtoja kaupalle, jossa on räätälöity kassa tai useita mainosalustoja, keskustelkaa IMADOn WooCommerce-kehittäjien kanssa ennen kuin sitoudutte lähestymistapaan.

Miten Cloudflare Zarazin suostumukset kannattaa määrittää WooCommercessa?

Liittäkää jokainen kolmannen osapuolen työkalu nimenomaiseen suostumuksen käyttötarkoitukseen ja tarkistakaa sitten, että kielletty suostumus pysäyttää sen. Cloudflaren Consent Management -dokumentaation mukaan jokaisella työkalulla on yksi käyttötarkoitus, ja työkalu, jolle sitä ei ole määritetty, ohittaa suostumustarkistuksen oletuksena, joten juuri lisätty työkalu voi kiertää eston, ellei joku määritä sitä.

Tehkää suostumusten kartoituksesta osa julkaisun tarkistuslistaa: jokainen työkalu, sen käyttötarkoitus, kohde, sen vastaanottamat tapahtumat ja suostumustila, jota se tarvitsee.

Testatkaa vähintään nämä tilat:

• Ei vielä valintaa: valinnaiset työkalut eivät lähetä mitään ennen suostumusta.
• Suostumus kielletty: pyynnöt kyseiseen työkaluun loppuvat.
• Suostumus annettu: odotetut tapahtumat saapuvat työkaluun.
• Asetus muutettu: työkalu noudattaa uutta valintaa uudelleenlatauksen jälkeen.
• Palaava istunto: tallennetut asetukset ovat voimassa ilman uutta ostoskori- tai tilaustoimintoa.

Tarkistakaa erityisesti ensimmäinen sivunlataus. Zarazin suostumusrajapinta tulee yleensä käyttöön vasta, kun sivun omat skriptit on suoritettu, joten integraatio, joka tarkistaa suostumuksen heti, voi käsitellä suostumuksen antanutta kävijää kuin tämä ei olisi antanut sitä ja hylätä tapahtuman. Odottakaa rajapintaa ennen päätöstä:

function onConsentReady(callback) {
  if (window.zaraz && zaraz.consent && zaraz.consent.APIReady) callback();
  else document.addEventListener('zarazConsentAPIReady', callback, { once: true });
}

Jos Googlen työkalut toimivat Consent Mode v2:n edistyneessä tilassa, ne voivat lähettää evästeettömiä pingejä myös silloin, kun suostumus on kielletty. Päättäkää, vastaako se käytäntöjänne, ja testatkaa se erikseen.

Pitäkää kaupan toiminta riippumattomana seurannasta: ostoskorin, tilin ja maksun on toimittava, vaikka asiakas hylkäisi valinnaiset käyttötarkoitukset. Lähettäkää vain kentät, joita kohdetyökalu tarvitsee, ja pitäkää henkilötiedot poissa jaetuista tapahtumasisällöistä. Zaraz toteuttaa määrittämänne asetukset; sivuston omistaja päättää, mitkä käyttötarkoitukset ja tekstit sopivat kullekin markkinalle, joten antakaa tietosuojasta tai juridiikasta vastaavan henkilön tarkistaa ne.

Miten Cloudflare Zarazin verkkokauppatapahtumat testataan ennen julkaisua?

Varmistakaa testitilaus WooCommercesta Zarazin kautta jokaiseen kohdetyökaluun Preview-tilassa tai testiympäristössä ja verratkaa sitten tapahtumia ja arvoja WooCommerce-tilaukseen. Sivu ilman JavaScript-virheitä ei todista, että osto laskettiin kerran tai että suostumus toimi.

Seuratkaa yhtä testi-istuntoa ja kirjatkaa odotettu tapahtuma jokaisessa vaiheessa: tuotenäyttö, ostoskoriin lisäys, ostoskorin näyttö, kassan aloitus, maksun tulos, osto ja hyvitys. Tarkistakaa lähdetapahtuma, Zarazin laukaisin ja toiminto sekä vastaanottava työkalu erikseen; yhden kerroksen vika näyttää lopullisessa raportointinäkymässä yleiseltä aukolta datassa.

Testimatriisin pitää kattaa:

• Uusi istunto ilman suostumusvalintaa, sitten kielletty ja annettu suostumus, myös hyväksyntä laskeutumissivulla.
• Variaatiotuote valitulla variaatiolla ja ilman, määrän muutos ja tuotteen poisto.
• Kupongit, alennukset, toimitus, verot ja jokainen raportoimanne valuutta.
• Jokainen maksutyyppi: hylätty, odottava, uudelleenohjattu ja onnistunut.
• Onnistunut tilaus, jonka jälkeen vahvistussivu ladataan uudelleen.
• Osittainen tai täysi hyvitys, jos raportoitte hyvityksiä.
• Jokainen kaupan kassapolku: Checkout Block, AJAX, tilaus, pikamaksu.

Tallentakaa jokaisen testitilauksen numero ja etsikää sama numero kohdetyökalusta. Palveluntarjoajien testityökalut auttavat: Metan Test Events näyttää, sisälsikö palvelintapahtuma käyttäjätietoja ja tuotetunnisteita. Poistakaa testitapahtumakoodi työkalusta ennen julkaisua, koska testikoodilla lähetetyt tapahtumat eivät näy tuotannon raportoinnissa.

Käyttäkää Zaraz Monitoringia erottamaan tapahtumamäärät laukaisimista, toiminnoista ja palvelinpuolen pyyntöjen tiloista. Jos Zaraz laski tapahtuman mutta kohdetyökalu ei vastaanottanut sitä, tarkistakaa työkalun määritykset ja vastaus. Jos Zaraz ei koskaan laskenut sitä, tutkikaa WooCommerce-integraatiota ja tapahtumien ajoitusta. Kirjatkaa hyväksytyt tulokset ja määritysversio ennen julkaisua.

Mikä menee rikki tuotannossa?

Vahingollisimpia ongelmia ovat väärät ja kaksinkertaiset ostot, suostumuksen ohittaminen ja tapahtumat, jotka katoavat huomaamatta. Näitä kaavoja näemme useimmin, kun WooCommerce-kaupat siirtävät seurantansa Zarazille.

Verkkokaupan tapahtumat jaetaan kaikille työkaluille, joissa verkkokauppaseuranta on käytössä.

zaraz.ecommerce()-kutsu saavuttaa jokaisen työkalun, jossa verkkokauppaseuranta on käytössä, samalla sisällöllä, eikä kenttiä voi suodattaa työkaluittain. Älkää koskaan laittako sähköpostiosoitteita tai puhelinnumeroita verkkokaupan tapahtumiin. Työkalukohtaisia tietoja varten lähettäkää erillinen zaraz.track()-tapahtuma, jossa on ohjausominaisuus, liittäkää se vain kyseisen työkalun laukaisimeen ja käyttäkää sääntöä, jossa {{ client._zarazTrack }} on viewitem yhdistettynä ohjauslippuunne.

Koko sivun välimuisti säilyttää vanhan seurantamäärityksen.

HTML:ään tulostetut määritykset ja skriptiversiot jäävät Cloudflaren ja palvelimen välimuisteihin julkaisun jälkeen. Välimuistissa olevat tuote- ja kategoriasivut lähettävät edelleen vanhanmuotoisia tapahtumia, kun taas välimuistittomat ostoskori- ja kassasivut lähettävät uusia. Tyhjentäkää sivu-, minifioitujen tiedostojen ja Cloudflaren välimuistit jokaisen seurantamuutoksen julkaisun yhteydessä.

Palvelinpuolen työkalut tarvitsevat edelleen puhtaat tunnistetiedot.

Zarazin Facebook-työkalu lähettää tapahtumat Conversions API:n kautta ja tiivistää (hash) sähköpostin, puhelinnumeron ja muut käyttäjäkentät itse. Lähettäkää normalisoidut raaka-arvot: sähköposti pienillä kirjaimilla, puhelinnumero maatunnuksella, postinumero ilman välilyöntejä tai viivoja. Valmiiksi tiivistetyt arvot tiivistetään kahdesti, eivätkä ne enää täsmää. Pysyvä ulkoinen tunniste, kuten asiakkaan sähköpostin tiiviste ensimmäisen osapuolen HttpOnly-evästeessä, mahdollistaa palaavien asiakkaiden tunnistamisen tallentamatta henkilötietoja selaimeen.

Työkalun vaihto nollaa asiakastunnisteet.

Korvattava pikselilisäosa on todennäköisesti lähettänyt omaa ulkoista tunnistettaan vuosia. Esimerkiksi PixelYourSite luo satunnaisen tunnisteen ja tallentaa sen selainevästeeseen (pbid), asiakastiliin ja jokaisen tilauksen metatietoihin. Jos uusi toteutus alkaa sen sijaan lähettää sähköpostin tiivistettä, Meta näkee jokaisen palaavan asiakkaan uutena henkilönä, ja täsmäytyksen laatu sekä yleisöjen jatkuvuus heikkenevät. Kun suunnittelette siirtoa, selvittäkää, mitä tunnisteita nykyinen toteutus tallentaa ja minne. Käyttäkää niitä sitten kiinteässä järjestyksessä: tilaukseen tai asiakastiliin tallennettu tunniste, vanha eväste ja vasta sen jälkeen uusi sähköpostin tiiviste. Tallentakaa valittu tunniste uusiin tilauksiin ja tileihin, jotta se pysyy siitä eteenpäin samana.

Kaiken kattavat toiminnot luovat kaksoiskappaleita.

Yleinen ”kaikki muut tapahtumat” -toiminto omien toimintojen, kuten ViewCategoryn, rinnalla laukaisee molemmat, ellei yleinen laukaisin sulje pois jokaista tapahtumaa, jolla on oma toimintonsa. Zaraz rajoittaa vertailuarvot 128 merkkiin, joten pitäkää poissulkemismallit tiiviinä.

Jotkin tapahtumat eivät saavu lainkaan.

Mainosten estäjät ja evästebannerien automaattinen piilotus poistavat osan selainsignaaleista, myös WooCommercen oman tilausten attribuution. Varautukaa eroon tilausten ja attribuoitujen tilausten välillä, mitatkaa se ja käyttäkää palvelimen vahvistamia ostoja vertailukohtana.

Väärät ostot syntyvät, kun kuunnellaan painikkeen klikkausta, maksua edeltävää vaihetta tai kiitossivulla käyntiä tarkistamatta tilauksen tilaa. Käyttäkää pysyvää tilausviitettä ja idempotenttia sääntöä, jotta uudelleenyritys tai uudelleenlataus ei kirjaa tilausta uudestaan.

Jos useampi näistä kuulostaa tutulta, ongelma on yleensä integraation suunnittelussa eikä yksittäisessä asetuksessa. IMADOn WooCommerce-tiimi voi auditoida tapahtumavirran ja korjata sen testiympäristössä ennen kuin virheet päätyvät raportteihinne.

Milloin tuotantotason Zaraz-toteutus kannattaa tehdä kehittäjän tuella?

Ottakaa mukaan WooCommerce-kehittäjä, kun kassan mukautukset, maksun tila, suostumustyökalut tai päällekkäinen analytiikka vaikeuttavat sen osoittamista, että jokaista kaupan toimintoa kohden syntyy täsmälleen yksi kelvollinen tapahtuma.

Kehittäjä määrittää tapahtumasopimuksen yhdessä markkinoinnin ja talouden kanssa, valitsee lisäosan tai oman kytkennän, testaa sen todellista kassaa ja tilausten elinkaarta vasten ja dokumentoi, mikä työkalu vastaa kustakin tapahtumasta ja miten suostumus sitä ohjaa. Tämä kannattaa, kun puuttuvat tai kaksinkertaiset ostot vaikuttavat kampanjapäätöksiin, täsmäytykseen tai tiimin luottamukseen raportointiin. Julkaisun jälkeen WordPressin tuki ja ylläpito tai verkkosivuston ylläpitosopimus pitää regressiotestit osana julkaisuprosessia, kun lisäosat ja maksuyhdyskäytävät muuttuvat.

Yhteenveto

Luotettava Cloudflare Zaraz -toteutus WooCommercelle alkaa nimenomaisesta tapahtumasopimuksesta, suostumuksen käyttötarkoituksesta jokaiselle työkalulle, suostumuksen huomioivasta ajoituksesta ensimmäisellä sivulla ja testitilauksista, jotka täsmäävät kaupan kirjanpitoon. Valitkaa lisäosa tai oma kytkentä sen kassan ja raportointisääntöjen perusteella, joita todella käytätte, ja tyhjentäkää välimuistit ja testatkaa uudelleen jokaisen seurantamuutoksen yhteydessä.

Suunnitteletteko Zaraz-käyttöönottoa tai korjaatteko sellaista, jonka luvut eivät täsmää? Keskustelkaa WooCommerce-projektistanne IMADOn kanssa.