Kreiranje prilagođenog Google Tag Manager piksela
Google Tag Manager (GTM) možete da koristite kao prilagođeni piksel za upravljanje pikselima treće strane.
Kada budete spremni za testiranje svog GTM prilagođenog piksela, koristite alatku Shopify Pixel Helper da biste se uverili da se svi događaji koje želite da pratite dodaju u zaštićeno okruženje bez grešaka.
Možete da koristite i ekstenziju za stranicu Google Tag Assistant da biste testirali koje Google oznake se učitavaju na stranici. Međutim, funkcija Troubleshoot tag ekstenzije Google Tag Assistant nije kompatibilna sa prilagođenim pikselima i ne detektuje nikakve Google oznake u prilagođenom pikselu niti druge piksele koje učitava GTM.
Na ovoj stranici
Priprema za kreiranje prilagođenog piksela
Pre nego što kreirate prilagođeni piksel pomoću alatke Google Tag Manager, pregledajte sledeće informacije da biste bili sigurni da razumete kako da konfigurišete svoj piksel:
- Kreirajte ili otvorite Google Tag Manager nalog i preuzmite GTM ID kontejnera.
- Iz bezbednosnih razloga, menadžeri oznaka učitani u našem zaštićenom okruženju imaju ista ograničenja kao i bilo koji drugi pikseli. Saznajte više o ograničenjima zaštićenog okruženja piksela.
Kreiranje prilagođenog Google Tag Manager piksela
Možete da kreirate Google Tag Manager prilagođeni piksel da biste upravljali svojim pikselima treće strane.
Koraci:
- Otvorite svoj Google Tag Manager nalog i izaberite nalog s kojim želite da podesite prilagođeni piksel.
- Kliknite na Admin, a zatim kliknite na Install Google Tag Manager da biste otvorili instalacioni kôd.
- Kopirajte blok koda koji pripada odeljku
headstranice. - Uklonite HTML oznake iz bloka koda. Na primer,
<script></script>. - Unesite preostali kôd u novi Shopify prilagođeni piksel.
- Pretplatite se na događaje kupaca i pošaljite ih u GTM
dataLayer. - Da biste pregledali kako kôd treba da se prikaže, pogledajte primer Google Tag Manager prilagođenog piksela.
- Konfigurišite Google Tag Manager tako da prihvata događaje iz vašeg prilagođenog piksela.
- Opcionalno: Ako imate postojeće
dataLayer.push(event) pozive u svojoj datotecicheckout.liquid, onda to zamenite sa analytics.publish().
Pretplatite se na događaje kupaca i pošaljite ih u GTM sloj podataka
Možete da se pretplatite na događaje kupaca pomoću GTM objekta dataLayer u kodu vašeg prilagođenog piksela.
Podrazumevano postoji skup standardnih događaja na koje možete da se pretplatite. Međutim, ako želite da pratite događaje kupaca koji nisu deo ponude standardnih događaja, možete da objavite sopstvene prilagođene događaje iz datoteka Liquid šablona.
Ispod je primer pretplate na standardni događaj „product_viewed”, koji ukazuje na to kada neko pregleda proizvod. Kada se događaj aktivira, on šalje događaj u dataLayer.
analytics.subscribe("product_viewed", (event) => {
window.dataLayer.push({
event: "product_viewed",
product_title: event.data?.productVariant?.title,
});
});U ovom primeru, naziv proizvoda se prosleđuje u sadržaju događaja. Možete da koristite Google Tag Manager promenljivu da biste obuhvatili naziv proizvoda iz sadržaja događaja u oznaci po svom izboru.
Primer Google Tag Manager prilagođenog piksela
Primer u nastavku je pojednostavljena verzija Google Tag Manager prilagođenog piksela koja prikazuje kako se podaci šalju u Google Tag Manager. Da biste poslali više događaja u svoj dataLayer, možete da se pretplatite na više standardnih i prilagođenih događaja.
// Define dataLayer and the gtag function.
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments);}
//Initialize GTM tag
(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start':
new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],
j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src=
'https://www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f);
})(window,document,'script','dataLayer', 'GTM-XXXXXXX');
//Google Consent Mode v2
gtag('consent', 'update', {
'ad_storage': 'granted',
'analytics_storage': 'granted',
'ad_user_data': 'granted',
'ad_personalization': 'granted',
});
//subscribe to events
analytics.subscribe("checkout_completed", (event) => {
window.dataLayer.push({
event: "checkout_completed",
timestamp: event.timestamp,
id: event.id,
token: event.data?.checkout?.token,
url: event.context.document.location.href,
client_id: event.clientId,
email: event.data?.checkout?.email,
phone: event.data?.checkout?.phone,
first_name: event.data?.checkout?.shippingAddress?.firstName,
last_name: event.data?.checkout?.shippingAddress?.lastName,
address1: event.data?.checkout?.shippingAddress?.address1,
address2: event.data?.checkout?.shippingAddress?.address2,
city: event.data?.checkout?.shippingAddress?.city,
country: event.data?.checkout?.shippingAddress?.country,
countryCode: event.data?.checkout?.shippingAddress?.countryCode,
province: event.data?.checkout?.shippingAddress?.province,
provinceCode: event.data?.checkout?.shippingAddress?.provinceCode,
zip: event.data?.checkout?.shippingAddress?.zip,
orderId: event.data?.checkout?.order?.id,
currency: event.data?.checkout?.currencyCode,
subtotal: event.data?.checkout?.subtotalPrice?.amount,
shipping: event.data?.checkout?.shippingLine?.price?.amount,
value: event.data?.checkout?.totalPrice?.amount,
tax: event.data?.checkout?.totalTax?.amount,
});
});
analytics.subscribe("payment_info_submitted", (event) => {
window.dataLayer.push({
event: "payment_info_submitted",
timestamp: event.timestamp,
id: event.id,
token: event.data?.checkout?.token,
url: event.context.document.location.href,
client_id: event.clientId,
email: event.data?.checkout?.email,
phone: event.data?.checkout?.phone,
first_name: event.data?.checkout?.shippingAddress?.firstName,
last_name: event.data?.checkout?.shippingAddress?.lastName,
address1: event.data?.checkout?.shippingAddress?.address1,
address2: event.data?.checkout?.shippingAddress?.address2,
city: event.data?.checkout?.shippingAddress?.city,
country: event.data?.checkout?.shippingAddress?.country,
countryCode: event.data?.checkout?.shippingAddress?.countryCode,
province: event.data?.checkout?.shippingAddress?.province,
provinceCode: event.data?.checkout?.shippingAddress?.provinceCode,
zip: event.data?.checkout?.shippingAddress?.zip,
orderId: event.data?.checkout?.order?.id,
currency: event.data?.checkout?.currencyCode,
subtotal: event.data?.checkout?.subtotalPrice?.amount,
shipping: event.data?.checkout?.shippingLine?.price?.amount,
value: event.data?.checkout?.totalPrice?.amount,
tax: event.data?.checkout?.totalTax?.amount,
});
});
analytics.subscribe("checkout_shipping_info_submitted", (event) => {
window.dataLayer.push({
event: "checkout_shipping_info_submitted",
timestamp: event.timestamp,
id: event.id,
token: event.data?.checkout?.token,
url: event.context.document.location.href,
client_id: event.clientId,
email: event.data?.checkout?.email,
phone: event.data?.checkout?.phone,
first_name: event.data?.checkout?.shippingAddress?.firstName,
last_name: event.data?.checkout?.shippingAddress?.lastName,
address1: event.data?.checkout?.shippingAddress?.address1,
address2: event.data?.checkout?.shippingAddress?.address2,
city: event.data?.checkout?.shippingAddress?.city,
country: event.data?.checkout?.shippingAddress?.country,
countryCode: event.data?.checkout?.shippingAddress?.countryCode,
province: event.data?.checkout?.shippingAddress?.province,
provinceCode: event.data?.checkout?.shippingAddress?.provinceCode,
zip: event.data?.checkout?.shippingAddress?.zip,
orderId: event.data?.checkout?.order?.id,
currency: event.data?.checkout?.currencyCode,
subtotal: event.data?.checkout?.subtotalPrice?.amount,
shipping: event.data?.checkout?.shippingLine?.price?.amount,
value: event.data?.checkout?.totalPrice?.amount,
tax: event.data?.checkout?.totalTax?.amount,
});
});
analytics.subscribe("checkout_address_info_submitted", (event) => {
window.dataLayer.push({
event: "checkout_address_info_submitted",
timestamp: event.timestamp,
id: event.id,
token: event.data?.checkout?.token,
url: event.context.document.location.href,
client_id: event.clientId,
email: event.data?.checkout?.email,
phone: event.data?.checkout?.phone,
first_name: event.data?.checkout?.shippingAddress?.firstName,
last_name: event.data?.checkout?.shippingAddress?.lastName,
address1: event.data?.checkout?.shippingAddress?.address1,
address2: event.data?.checkout?.shippingAddress?.address2,
city: event.data?.checkout?.shippingAddress?.city,
country: event.data?.checkout?.shippingAddress?.country,
countryCode: event.data?.checkout?.shippingAddress?.countryCode,
province: event.data?.checkout?.shippingAddress?.province,
provinceCode: event.data?.checkout?.shippingAddress?.provinceCode,
zip: event.data?.checkout?.shippingAddress?.zip,
orderId: event.data?.checkout?.order?.id,
currency: event.data?.checkout?.currencyCode,
subtotal: event.data?.checkout?.subtotalPrice?.amount,
shipping: event.data?.checkout?.shippingLine?.price?.amount,
value: event.data?.checkout?.totalPrice?.amount,
tax: event.data?.checkout?.totalTax?.amount,
});
});
analytics.subscribe("checkout_contact_info_submitted", (event) => {
window.dataLayer.push({
event: "checkout_contact_info_submitted",
timestamp: event.timestamp,
id: event.id,
token: event.data?.checkout?.token,
url: event.context.document.location.href,
client_id: event.clientId,
email: event.data?.checkout?.email,
phone: event.data?.checkout?.phone,
first_name: event.data?.checkout?.shippingAddress?.firstName,
last_name: event.data?.checkout?.shippingAddress?.lastName,
address1: event.data?.checkout?.shippingAddress?.address1,
address2: event.data?.checkout?.shippingAddress?.address2,
city: event.data?.checkout?.shippingAddress?.city,
country: event.data?.checkout?.shippingAddress?.country,
countryCode: event.data?.checkout?.shippingAddress?.countryCode,
province: event.data?.checkout?.shippingAddress?.province,
provinceCode: event.data?.checkout?.shippingAddress?.provinceCode,
zip: event.data?.checkout?.shippingAddress?.zip,
orderId: event.data?.checkout?.order?.id,
currency: event.data?.checkout?.currencyCode,
subtotal: event.data?.checkout?.subtotalPrice?.amount,
shipping: event.data?.checkout?.shippingLine?.price?.amount,
value: event.data?.checkout?.totalPrice?.amount,
tax: event.data?.checkout?.totalTax?.amount,
});
});
analytics.subscribe("checkout_started", (event) => {
window.dataLayer.push({
event: "checkout_started",
timestamp: event.timestamp,
id: event.id,
token: event.data?.checkout?.token,
url: event.context.document.location.href,
client_id: event.clientId,
email: event.data?.checkout?.email,
phone: event.data?.checkout?.phone,
first_name: event.data?.checkout?.shippingAddress?.firstName,
last_name: event.data?.checkout?.shippingAddress?.lastName,
address1: event.data?.checkout?.shippingAddress?.address1,
address2: event.data?.checkout?.shippingAddress?.address2,
city: event.data?.checkout?.shippingAddress?.city,
country: event.data?.checkout?.shippingAddress?.country,
countryCode: event.data?.checkout?.shippingAddress?.countryCode,
province: event.data?.checkout?.shippingAddress?.province,
provinceCode: event.data?.checkout?.shippingAddress?.provinceCode,
zip: event.data?.checkout?.shippingAddress?.zip,
orderId: event.data?.checkout?.order?.id,
currency: event.data?.checkout?.currencyCode,
subtotal: event.data?.checkout?.subtotalPrice?.amount,
shipping: event.data?.checkout?.shippingLine?.price?.amount,
value: event.data?.checkout?.totalPrice?.amount,
tax: event.data?.checkout?.totalTax?.amount,
});
});
analytics.subscribe("product_added_to_cart", (event) => {
window.dataLayer.push({
event: "product_added_to_cart",
timestamp: event.timestamp,
id: event.id,
client_id: event.clientId,
url: event.context.document.location.href,
price: event.data?.cartLine?.merchandise?.price?.amount,
currency: event.data?.cartLine?.merchandise?.id,
product_title: event.data?.cartLine?.merchandise?.product?.title,
quantity: event.data?.cartLine?.quantity,
total_cost: event.data?.cartLine?.cost?.totalAmount?.amount,
});
});
analytics.subscribe("cart_viewed", (event) => {
window.dataLayer.push({
event: "cart_viewed",
timestamp: event.timestamp,
id: event.id,
client_id: event.clientId,
url: event.context.document.location.href,
total_cost: event.data?.cart?.cost?.totalAmount?.amount,
quantity: event.data?.cart?.totalQuantity,
cart_id: event.data?.cart?.id,
});
});
analytics.subscribe("page_viewed", (event) => {
window.dataLayer.push({
event: "page_viewed",
timestamp: event.timestamp,
id: event.id,
client_id: event.clientId,
url: event.context.document.location.href,
page_title: event.context.document.title,
});
});
analytics.subscribe("product_viewed", (event) => {
window.dataLayer.push({
event: "product_viewed",
timestamp: event.timestamp,
id: event.id,
client_id: event.clientId,
url: event.context.document.location.href,
product_id: event.data?.productVariant?.product?.id,
product_title: event.data?.productVariant?.title,
product_sku: event.data?.productVariant?.sku,
});
});
analytics.subscribe("search_submitted", (event) => {
window.dataLayer.push({
event: "search_submitted",
timestamp: event.timestamp,
id: event.id,
client_id: event.clientId,
url: event.context.document.location.href,
query: event.data?.searchResult?.query,
});
});
analytics.subscribe("collection_viewed", (event) => {
window.dataLayer.push({
event: "collection_viewed",
timestamp: event.timestamp,
id: event.id,
client_id: event.clientId,
url: event.context.document.location.href,
collection_id: event.data?.collection?.id,
collection_title: event.data?.collection?.title,
});
});Konfigurišite Google Tag Manager da prihvata događaje sa vašeg prilagođenog piksela
Nakon što kreirate svoj prilagođeni piksel, potrebno je da konfigurišete Google Tag Manager tako da prihvata događaje iz vašeg prilagođenog piksela. Da biste to uradili, u alatki Google Tag Manager su vam potrebni oznaka, okidač i promenljive dataLayer.
Neki primeri izabranih standardnih događaja kupaca i njihovih Google Tag Manager ekvivalenata su navedeni u sledećoj tabeli:
| Shopify događaj | Okidač | GTM događaj |
|---|---|---|
| payment_info_submitted | Slanje informacija o plaćanju | add_payment_info |
| checkout_address_info_submitted | Slanje informacija o isporuci | add_shipping_info |
| product_added_to_cart | Dodavanje stavke u korpu za kupovinu | add_to_cart |
| checkout_started | Pokretanje naplate | begin_checkout |
| checkout_completed | Završetak naplate | purchase |
| product_removed_from_cart | Uklanjanje stavke iz korpe | remove_from_cart |
| cart_viewed | Prikaz korpe za kupovinu | view_cart |
| product_viewed | Prikaz stranice sa detaljima o proizvodu | view_item |
| collection_viewed | Prikaz liste stavki | view_item_list |
Parametri događaja GTM oznaka moraju da odgovaraju očekivanim konvencijama imenovanja da bi se obradili događaji dataLayer za vaš prilagođeni piksel.
Neki primeri izabranih svojstava događaja dataLayer za prilagođeni piksel i njihovih ekvivalentnih parametara događaja za Google Analytics 4 (GA4) su sledeći:
Događaji dataLayer za prilagođeni piksel | Parametri GA4 događaja |
|---|---|
| event.data?.checkout?.currencyCode | currency |
| event.data?.checkout?.totalPrice?.amount | value |
| event.data?.checkout?.order?.id | transaction_id |
| event.data?.checkout?.discountAllocations | coupon |
| event.data?.checkout?.shippingLine?.price?.amount | shipping |
| event.data?.checkout?.totalTax | tax |
| event.data?.checkout?.lineItems | items |
Evo primera koji koristi sledeći događaj checkout_completed:
analytics.subscribe("checkout_completed", (event) => {
window.dataLayer.push({
event: "checkout_completed",
orderId: event.data?.checkout?.order?.id,
currency: event.data?.checkout?.currencyCode,
price: event.data.checkout.totalPrice.amount,
shippingLine: event.data.checkout.shippingLine.price.amount,
totalTax: event.data.checkout.totalTax,
});
});Okidač za Google Tag Manager je tip prilagođenog događaja čiji je naziv događaja checkout_completed. Polje Event name u okidaču mora da se podudara sa ključem event u vašem prilagođenom pikselu.
orderId i currency su promenljive koje koristite u alatki Google Tag Manager za evidentiranje podataka iz događaja. One se mogu mapirati sa promenljivom dataLayer u alatki Google Tag Manager. Svaka promenljiva događaja zahteva sopstvenu promenljivu dataLayer. Podesite okidač tako da se aktivira za sve prilagođene događaje.
Kreirajte oznaku koja koristi okidač koji ste upravo kreirali. U okviru parametara događaja, dodajte promenljive koje želite da evidentirate. U navedenom primeru, orderId, currency, price, shippingLine i totalTax bi se podesile kao promenljive dataLayer. Svaki put kada se oznaka aktivira, ona će evidentirati ove promenljive dataLayer uz događaj.
Za prenos podataka je potrebno da se podese makar jedna oznaka i okidač u alatki Google Tag Manager.
Zamena starih poziva dataLayer.push(event) pozivima analytics.publish()
Ako ste prethodno podesili Google Tag Manager, morate da zamenite pozive dataLayer.push pozivima Shopify.analytics.publish(). Pozive dataLayer.push možete da pronađete u svojim datotekama theme.liquid, u odeljku Raspored u svom uređivaču tema.
Takođe morate da zamenite pozive dataLayer.push u datoteci checkout.liquid. Međutim, pošto checkout.liquid nije kompatibilna sa funkcijom Shopify Extensions, morate da upotrebite UI ekstenziju za prosleđivanje podataka u veb-piksele.
U nastavku je pojednostavljen primer prilagođenog događaja registracije putem imejla koji se prati pomoću objekta dataLayer u datotekama theme.liquid:
<script>
dataLayer.push({ event: 'email_signup', email: customer.email });
</script>Ekvivalent za Shopify se prikazuje na ovaj način, čime se podaci prosleđuju u vaš prilagođeni piksel:
<script>
Shopify.analytics.publish('email_signup', {email: customer.email });
</script>Zatim biste u svoj kôd prilagođenog piksela dodali nešto poput ovoga:
analytics.subscribe("email_signup", (event) => {
window.dataLayer.push({
'event': 'email_signup',
'email': event.customData.email,
});
});Zamenite stari kôd dataLayer.push(data)
Google Tag Manager ima funkciju koja vam omogućava da prosledite objekat dataLayer sa stanjem pri svakom događaju. Iako okruženje za testiranje piksela na platformi Shopify nema ekvivalentnu funkciju, možete da postignete isti rezultat tako što ćete kreirati sopstveni objekat sa podacima i proslediti ga u prilagođene događaje.
Na primer, definišite objekat „customData“ pre nego što se bilo koji vaši prilagođeni događaji objave:
<script>
const customData = {email: customer.email}
</script>Zatim, kad god želite da uključite svoje prilagođene podatke, prosledite ih u svoj metod za objavljivanje:
<script>
Shopify.analytics.publish('email_signup', customData);
</script>Saveti za podešavanje alatke Google Analytics 4
Uzmite u obzir sledeće savete za podešavanje alatke Google Analytics 4 (GA4) kada koristite Google Tag Manager kao prilagođeni piksel.
Čistiji URL-ovi stranica
Kada se GA4 pokreće u okruženju za testiranje, možda ćete primetiti da URL-ovi stranica obuhvataju informacije o okruženju za testiranje u kom radi. Ako želite da uklonite informacije o okruženju za testiranje iz tih URL-ova, možete da isključite automatsko praćenje stranica u usluzi GA4 i umesto toga primenite sopstveno praćenje tako što ćete upotrebiti standardni događaj page_viewed.
analytics.subscribe('page_viewed', (event) => {
window.dataLayer.push({
'event': 'page_viewed',
'page_location': event.context.window.location.href,
'page_title': event.context.document.title,
});
});Nakon što objavite sopstveni događaj za dataLayer, možete da kreirate oznaku GA4 page_view koja se aktivira pri događaju page_viewed. Najčešće možete da koristite tip oznake Google Analytics: GA4 Event i podesite „Naziv događaja“ na page_view. Nakon što podesite tip oznake i naziv događaja, potrebno je da dodate parametar za page_location i podesite ga na istu vrednost koju ste prosledili za dataLayer iz vašeg prilagođenog piksela.
Poboljšano merenje
Prilikom učitavanja usluge GA4 u Shopify okruženju za testiranje piksela, neki događaji koji se inače automatski pretpostavljaju moraće da se podese ručno. Na primer, klikovi na izlazne linkove, kao deo podešavanja za poboljšano merenje usluge GA4, ne mogu automatski da se aktiviraju iz bezbednosnih razloga kada koristite prilagođene piksele. Međutim, moguće je da sami primenite događaje poboljšanog merenja za GA4 kao prilagođene događaje.
Kôd naveden u nastavku obuhvata pojednostavljeni primer praćenja klikova na izlazne linkove:
<script>
function detectOutboundLink() {
// add your logic for determining if a link click is outbound
// if the link click is outbound then publish it
if (isOutboundLink) {
Shopify.analytics.publish('outbound_link', { link_url: link_url });
}
}
</script>Na kraju, u usluzi GTM kreirajte GA4 oznaku koja šalje klik na link na GA4, tako što ćete se uveriti da je naziv događaja click, kako bi se podudarao sa poboljšanim imenovanjem događaja na usluzi GA4.
Isto praćenje možete postići za bilo koju od Google metrika poboljšanog merenja.
Testirajte i otklonite greške u prilagođenom pikselu
Kada budete spremni za testiranje svog GTM prilagođenog piksela, koristite alatku Shopify Pixel Helper da biste se uverili da se svi događaji koje želite da pratite dodaju u zaštićeno okruženje bez grešaka.
Možete da koristite i ekstenziju za stranicu Google Tag Assistant da biste testirali koje Google oznake se učitavaju na stranici. Međutim, funkcija Troubleshoot tag ekstenzije Google Tag Assistant nije kompatibilna sa prilagođenim pikselima i ne detektuje nikakve Google oznake u prilagođenom pikselu niti druge piksele koje učitava GTM.