Először is vegye figyelembe, hogy a globális kódrészletünk már tartalmaz egy oldalmegtekintési eseményt, amely a globális kódrészlet kódja után fut:
Tehát nem kell további kódot hozzáadnia, ha csak egy oldalmegtekintést szeretne követni.
Egyszerűen illessze be az univerzális JS kódrészletünket az oldalára a szokásos módon -- amit erősen ajánlunk minden olyan oldalon, amelyet Ön kezel.
Megtekintés manuális követése
Bármikor küldhet oldalmegtekintési eseményeket a flux.track("view")
módszer használatával.
Teljes egészében a Javascript megtekintés követési módszerünk:
flux.track("view", { optional: 'arguments' }, optionalCallbackFunction)
Opcionális argumentumok
A megtekintési és konverziós eseményekhez további attribútum felülírásokat lehet küldeni a flux.track
második argumentumaként. Ezeknek egy objektumban kell lenniük.
Követési attribútumok
Az oldalakra lehet fluxDefaults
beágyazva elhelyezni a JS-ünk előtt, amely alapértelmezett követési attribútumokat állít be, mint például oldal ID, tölcsér ID, stb.
Ezenkívül közvetlenül átadhatja ezeket a megtekintési esemény kódjába. Az itt megadott értékek felülírják a JS alapértelmezetteket.
A prioritás, amelyben a követési API-nk ezeket használja:
esemény szintű argumentumok > URL paraméterek > fluxDefaults objektum
Tehát az eseménybe küldött kód a legmagasabb prioritású.
Az elérhető attribútumok:
p
- oldal IDf
- tölcsér IDn
- csomópont IDts
- forgalmi forrás IDvid
- látogató ID
Vegye figyelembe, hogy a látogató ID-t automatikusan ellenőrizzük, így a helytelen értékek küldése esetén figyelmen kívül hagyjuk azt.
Tehát például küldhet megtekintési eseményeket egy meghatározott oldal ID-val:
flux.track("view", { p: 'some_page_id' })
Vagy egy meghatározott tölcsér és csomópont ID-val:
flux.track("view", { f: 'some_funnel_id', n: 'some_node_id' })
Feloldandó tokenek
Másodszor, átadhat olyan tokeneket, amelyeket szeretne, hogy az API-nk visszaadjon, az alapértelmezett {visitor}
, {current-node-id}
és {hit}
tokeneken kívül, amelyeket mindig visszaadunk.
A tokeneket a resolveTokens név alatt kell átadni, az összes tokent egy tömbben kell elhelyezni, a tokent kapcsos zárójelekbe foglalva, ahogy azt a FunnelFlux felhasználói felületén használjuk.
Például:
flux.track("view", { resolveTokens: ['{country-name}','{isp}','{browser}'] })
Amikor elküldi, az API válaszában ezek az elemek szerepelni fognak. Ezután a flux.get()
módszerrel lehet hozzáférni, lásd a dokumentációnkat itt.
Ha ezeket a tokeneket használja, javasoljuk, hogy használjon callback függvényt vagy eseményfigyelőt, hogy csak akkor dolgozza fel és használja fel őket, amikor visszaérkeznek.
Opcionális callback függvény
A megtekintési módszer harmadik és opcionális argumentuma egy callback függvény.
flux.track("view", {}, callbackFunctionName)
Ha a második argumentumban nem küld opcionális attribútumokat, egy üres objektumot kell beletennie - ne hagyja ki. A következő kód nem fog működni:
flux.track("view", callbackFunctionName)
Mivel a függvényt a második argumentumként küldi el a harmadik helyett.
Ez bármilyen függvény lehet, amit Ön létrehoz, mindaddig, amíg létezik a kódjában a követési esemény végrehajtása előtt. Ha az eseményeket úgy indítja el, hogy a függvény még nincs definiálva, az a megtekintés sikertelenségéhez vezet.
Ez a függvény közvetlenül a fluxView
eseményfigyelőnk után fog meghívódni, így mindkettő lényegében egyenértékű sorrendi szempontból. Használja azt, amelyik Önnek a legjobban megfelel.
Az elérhető eseményfigyelőkkel kapcsolatos információkért lásd a dokumentációnkat más módszerekről/függvényekről.
Google Tag Manager használata
Ha Google Tag Manager-t használ, a következőket javasoljuk:
- Hozzon létre egy címkét Universal FunnelFlux Pro JS néven vagy hasonlóval. Állítsa a prioritását 10-re
- Az univerzális JS kódrészletben keresse meg a
lumetricv2.min.js
forráselérési útvonalát, és módosítsa eztlumetricv2gtm.min.js
-re -- létrehoztunk egy külön JS fájlt, amelyből eltávolítottunk néhány részt, hogy a GTM ne legyen elégedetlen néhány segédfüggvénnyel - Hozzon létre egy külön címkét a flux.track megtekintési és konverziós eseményekhez, és indítsa el őket ennek megfelelően. Nincs szükség a sorrendjük kényszerítésére, mivel ezek az események sorba állnak, ha a flux még nem érhető el
- Állítsa be az oldalmegtekintéseket úgy, hogy mindkét címkét elindítsák
Ha szeretné kényszeríteni az oldal ID-kat a követéshez egy összetett weboldalon, ahol az URL-egyeztetés nem működik jól, javasoljuk, hogy hozzon létre egy Keresési vagy Regex Tábla változót a GTM-ben.
Ezután leképezheti a különböző URL-eket/útvonalakat oldal ID-kra a FunnelFlux-ból, és az oldalmegtekintési esemény címkéjében átadhatja a p: {{gtm_változó}}
-t, hogy a GTM kényszerítse az oldal ID értékeket.
Megtekintések követése egyoldalas alkalmazásban
Ha manuálisan és függetlenül szeretne oldalmegtekintési eseményeket küldeni a globális kódrészletünktől (például egy egyoldalas alkalmazásban), eltávolíthatja az alapértelmezett flux.track
kódot, amelyet a globális kódrészletünk után adtunk hozzá.
Innen manuálisan indíthatja el az oldalmegtekintési eseményeket, ahogy korábban leírtuk.
Amíg az oldal URL-je megváltozik mielőtt a megtekintési eseményünk elindul, az API-nak meg kell kapnia a várt URL-t, amelyet az aktuális tölcsérben lévő oldalakkal egyeztet, hogy meghatározza a csomópont ID-t.
Ha szükséges, átadhat oldal ID értékeket argumentumként minden eseményben, hogy felülírja a használt URL-egyeztetést.
Nem kell többször betöltenie a globális kódrészletet, feltéve, hogy a flux
objektum még létezik.
A kódrészletünk már tartalmaz egy ellenőrzést arra, hogy létezik-e a flux, és ha igen, nem próbálja meg letölteni és újra beilleszteni a szkriptet.
Az API kérés és válasz
A megtekintési események egy POST kérést küldenek a https://your-custom-domain.com/js/funnel
címre, az alábbiak szerint:
A kérést szűrheti a "funnel" és Fetch/XHR kérések keresésével.
A válasz, ha sikeres, így fog kinézni:
A resolvedToken elemekhez könnyen hozzá lehet férni a flux.get()
módszerrel.
Néhány esetben hibák léphetnek fel, vagy a válasz lehet törött.
Néhány egyszerű ellenőrzés megerősíti, hogy a követési kérés sikeres volt-e:
- A fluxView esemény elindult (lásd az eseményfigyelőket)
- A POST válaszban az error értéke null
- A POST válaszban van valós érték a
resolvedTokens["{current-node-id}"]
számára