Mukautettujen pikselien testaaminen

Varoitus

Mukautetut pikselit on edistynyt ominaisuus, joka edellyttää JavaScript-osaamista. Sovellettavien lakien noudattaminen, suostumukset, koodin turvallisuus, vianmääritys ja päivitykset ovat sinun vastuullasi. Pikseleihin sovelletaan Shopifyn käyttöehtoja.

Shopify ei tue mukautettujen pikselien lisäämistä ja käyttöä. Jos tarvitset apua mukautetun pikselin lisäämisessä tai käytössä, voit palkata Shopify Partnerin.

Kun olet luonut mukautetun pikselin, sinun täytyy testata se varmistaaksesi, että pikselisi lähettää dataa oikein, kun sivustollasi tapahtuu tapahtumia.

Voit käyttää Shopify Pixel Helperiä testataksesi, latautuvatko pikselitapahtumasi ja oletko tilannut Shopify-tapahtumat oikein. Shopify Pixel Helperin avulla voit testata mukautettua pikseliäsi verkkokaupassasi ja tarkastella vastaanotettuja tapahtumia ja niiden dataa reaaliaikaisesti.

Jos mukautettu pikselisi integroituu kolmannen osapuolen alustaan, jolla on oma pikseliapurityökalu, voit käyttää kolmannen osapuolen pikseliapuria Shopify Pixel Helperin lisäksi testataksesi, käsitteleekö kolmannen osapuolen alusta pikselitapahtumiasi ja vastaanottaako se ne. Jos esimerkiksi lisäät kauppaasi mukautetun TikTok-pikselin, voit testata pikseliäsi sekä Shopify Pixel Helperillä että TikTokin pikseliapurilla.

Voit käyttää Shopify Pixel Helperiä ja kolmannen osapuolen pikseliapuria samassa selainistunnossa testataksesi molempien alustojen tapahtumia samanaikaisesti.

Vinkki

Jos sinulla on testikauppa, harkitse pikselien testaamista testikaupassasi varmistaaksesi, että ne toimivat odotetulla tavalla, ennen kuin lisäät ne live-tilassa olevaan verkkokauppaasi.

Tässä on mukautetun pikselin skripti, joka käynnistää kaikki vakiotapahtumat hiekkalaatikkoon ja kirjaa tapahtumadatan konsoliin. Vakiotapahtumat näkyvät Shopify Pixel Helperissä. Lisäksi voit tilata muita massatilauksia, kuten all_events, all_custom_events ja all_dom_events, tutustuaksesi kaikkeen, mitä verkkopikselit voivat tarjota. Katso lisätietoja verkkopikselien API:sta.

analytics.subscribe("all_standard_events", event => {
   console.log("Event data ", event?.data);
});

Varmista, että mukautettu pikseli on yhdistetty

Varmista ennen mukautetun pikselin testaamista, että se on yhdistetty.

Vaiheet:

1. Siirry Shopifyn ohjausnäkymässä kohtaan Asetukset > Asiakastapahtumat.

2. Varmista, että testattavan pikselin vieressä Tila-sarakkeessa näkyy tila Yhdistetty.

3. Jos pikseliä ei ole yhdistetty, napsauta ... ja napsauta sitten Yhdistä.

Mukautetun pikselin testaaminen Shopify Pixel Helperin avulla

Huomautus

Shopify Pixel Helper ei ole yhteensopiva headless-verkkokauppojen tai salasanasuojattujen kauppojen kanssa.

Jos verkkokauppasi on salasanasuojattu, harkitse verkkokaupan salasanan poistamista, jotta voit käyttää Shopify Pixel Helperiä.

Kun olet varmistanut, että mukautettu pikselisi on yhdistetty, voit testata Shopify Pixel Helperin avulla, lähettääkö ja vastaanottaako mukautettu pikselisi kauppasi dataa. Voit testata yhden mukautetun pikselin kerrallaan.

Vaiheet:

1. Siirry Shopifyn ohjausnäkymässä kohtaan Asetukset > Asiakastapahtumat.

2. Napsauta testattavaa mukautettua pikseliä.

3. Napsauta Testaa, niin mukautettu pikseli avautuu verkkosivustollasi testausta varten.

4. Valinnainen: kauppasi suostumusasetuksista ja mukautetun pikselin asiakkaan tietosuoja-asetuksista riippuen Pikseliapurin valintaikkunassa saattaa näkyä teksti Pikseli odottaa suostumusta. Jatka testausta tekemällä jokin seuraavista:

   • Hyväksy seuranta kauppasi evästebannerissa tai asetuksissa.
   • Napsauta Anna suostumus testin jatkamiseksi.
   • Jos pikselisi ei vieläkään lataudu, tarkista asiakkaan tietosuoja-asetuksesi.

5. Jos haluat nähdä, mitkä tapahtumat latautuvat, siirry jokaiselle sivulle, jolla haluat testata pikseliä, ja tarkista Pikseliapuri-valintaikkunan Vastaanotetut tapahtumat -osiosta, että tapahtuman tilaus ja takaisinsoittofunktio onnistuivat:

   • Siirry uudelle sivulle testataksesi page_viewed-tapahtuman.
   • Napsauta tuotetta testataksesi product_viewed-tapahtuman.
   • Lisää tuote ostoskoriin testataksesi product_added_to_cart-tapahtuman.
   • Siirry kassalle testataksesi checkout_started-tapahtuman.
   • Anna toimitustietosi kassalla testataksesi, että checkout_shipping_info_submitted-tapahtuma korvaa checkout_started-tapahtuman.
   • Tee tilaus loppuun kassalla testataksesi, että checkout_completed-tapahtuma korvaa checkout_shipping_info_submitted-tapahtuman. Lue lisää testitilauksen tekemisestä.

6. Jos haluat tarkastella vastaanotettua tapahtumadataa, laajenna pikseliapurin valintaikkuna napsauttamalla .

Vastaanotetut tapahtumat -osion tarkasteleminen

Kun testaat vaiheessa 5, mitkä tapahtumat latautuvat, Pikseliapuri-valintaikkunan Vastaanotetut tapahtumat -osioon tulee näkyviin yksi seuraavista tiloista:

• Vihreä piste ilmaisee, että tapahtuma on tilattu onnistuneesti ja takaisinsoittofunktio onnistui.
• Punainen piste ilmaisee, että tapahtuma on tilattu onnistuneesti, mutta takaisinsoittofunktio epäonnistui. Lue ohjeet mukautetun pikselin vianmääritykseen.
• Pikseliapuri näyttää käsittelemättömät virheet, jotka tapahtuvat ylätasolla tai takaisinsoittofunktiossa. Ylätason virheet tulevat näkyviin, kun pikseliapuri latautuu. Takaisinsoiton virheilmoitukset tulevat näkyviin, kun laajennat punaisella pisteellä merkityn tapahtuman napsauttamalla sitä.
• Seuraava koodiesimerkki sisältää takaisinkutsuvirheen ja ylätason virheen. Riippuen siitä, missä ylätason virhe sijaitsee, pikseli saattaa toimia osittain.

analytics.subscribe("all_standard_events", event => {
  console.log("Event data ", event?.data);
  throw new Error("callback error");
});

throw new Error("top level error")

Lisätietoja JavaScript-virheiden korjaamisesta on kohdassa JavaScript-vianmääritys.

Mukautetun pikselin vianmääritys

Jos pikseli ei lataudu tai käynnisty testauksen aikana ja olet jo tarkistanut tapahtumatiedot ja pikselikoodin virheiden varalta, kokeile seuraavia vianmääritystoimenpiteitä.

Tarkista asiakkaiden tietosuoja-asetukset

Jos pikseli ei lataudu tai käynnisty testauksen aikana, syynä voivat olla asiakkaiden tietosuoja-asetukset, jotka estävät sen latautumisen.

Siirry Shopifyn ohjausnäkymässä kohtaan Asetukset > Asiakkaan tietosuoja ja tarkista Shopifyn ohjausnäkymän asiakkaiden tietosuoja-asetukset, jotka saattavat koskea istuntoasi. Toimi asiakkaiden tietosuoja-asetusten mukaan seuraavasti:

• Jos sinulla on käytössäsi alueellasi suostumusta edellyttäviä asiakkaiden tietosuoja-asetuksia, varmista, että olet antanut suostumuksen evästebannerin kautta.
• Jos sinulla ei ole käytössäsi asiakkaiden tietosuoja-asetuksia, jotka estävät pikselin latautumisen, tyhjennä selaimesi evästeet nollataksesi evästebannerin ja antaaksesi suostumuksen.

Jos käytät suostumuksen hallintaan kolmannen osapuolen työkalua, ota yhteyttä kolmannen osapuolen palveluntarjoajaan saadaksesi tukea.

Vinkki

Evästebannereiden avulla voit pyytää asiakkailtasi suostumusta evästeiden käyttöön. Voit selata Shopify App Storea lisätäksesi evästebannerin kauppaasi.

Lisävianmääritys

Jos on edelleen epäselvää, onko mukautettu pikselisi tilannut asiakastapahtuman oikein, kokeile seuraavia vianmääritystoimenpiteitä:

• Tyhjennä selaimesi evästeet.
• Jos testaat vakiotapahtumaa, tarkista Shopifyn kehittäjän oppaiden vakiotapahtumien kuvauksista, että suoritat tarvittavat vaiheet tapahtuman käynnistämiseksi.

Kolmannen osapuolen pikseliavustajan testaus

Pikselin SDK (software development kit) sisältää työkalut, joiden avulla pikseli voi kerätä tietoja asiakkaiden käyttäytymisestä. Voit käyttää kolmannen osapuolen pikselipalveluntarjoajan pikseliavustajaa pikselisi seuraavien toimintojen testaamiseen ja varmistaaksesi, että pikselin SDK toimii odotetusti:

• Kolmannen osapuolen pikselin SDK:n latautumisen testaaminen
• Kolmannen osapuolen pikselin SDK:n alustamisen ja tapahtumien vastaanottamisen testaaminen

Kolmannen osapuolen pikselin SDK:n latautumisen testaaminen

Verkko-välilehden tarkistamisen vaiheet riippuvat käyttämästäsi verkkoselaimesta. Esimerkiksi Google Chromen Verkko-välilehden tarkistamista koskevat ohjeet ovat Chrome for Developers -Verkkotoiminnan tarkastelu -oppaassa.

Testataksesi, että kolmannen osapuolen pikselin SDK on ladattu, sinun on ensin noudettava kolmannen osapuolen palveluntarjoajalta SDK:n URL-osoitetta vastaava koodi, jotta voit lisätä sen pikselikoodiisi. Jos tarvitset tukea, ota yhteyttä kolmannen osapuolen pikselipalveluntarjoajaan.

Vaiheet:

1. Siirry Shopifyn ohjausnäkymässä kohtaan Asetukset > Asiakastapahtumat.

2. Napsauta testattavaa mukautettua pikseliä.

3. Syötä Koodi-osiossa kolmannen osapuolen palveluntarjoajan antama pikselin SDK pikselikoodisi loppuun.

4. Klikkaa Tallenna.

5. Siirry verkkokauppaasi ja tarkista sitten Verkko-välilehdeltä, että kolmannen osapuolen palveluntarjoajan SDK:n URL-osoite ladataan.

6. Valinnainen: Jos kolmannen osapuolen pikselin SDK ei lataudu, tarkista hiekkalaatikosta, onko siellä JavaScript-ajonaikaisia virheitä. Esimerkiksi Chromessa voit valita tietyn iFrame-kehyksen, jonka konsolilokeja tarkastelet, ja rajata sitten lokit koskemaan tiettyä testaamaasi pikseliä. Lisätietoja JavaScript-ajonaikaisten virheiden tarkistamisesta Chromella on Chromen JavaScriptin vianetsintä -oppaassa.

Jos kolmannen osapuolen pikselin SDK ei lataudu testauksen aikana, ota yhteyttä pikselin palveluntarjoajaan saadaksesi tukea.

Muu kolmannen osapuolen pikselin SDK:n testaus

Testataksesi, onko kolmannen osapuolen pikselin SDK alustettu tai kerääkö se tapahtumia, tutustu kolmannen osapuolen pikselipalveluntarjoajan oppaisiin.

Testataksesi, kerääkö pikselin SDK tapahtumia, sinua saatetaan neuvoa tarkistamaan selaimesi Verkko-välilehti. Verkko-välilehden tarkistamisen vaiheet riippuvat käyttämästäsi verkkoselaimesta. Esimerkiksi Google Chrome -selaimen Verkko-välilehden tarkistamista koskevat ohjeet ovat Chrome for Developers -Verkkotoiminnan tarkastelu -oppaassa.