Zachytávajte zdroje návštevnosti s modulom AutoROICalc pre JavaScript

Zachytávajte zdroje návštevnosti s modulom AutoROICalc pre JavaScript

Návštevník príde na váš web z newslettera, pozrie si cenník a požiada o ukážku produktu. Ak spolu s touto udalosťou uchováte aj zdroj návštevnosti, ľahšie zistíte, odkiaľ prichádzajú dopyty.

Sledovací modul AutoROICalc pre JavaScript je dostupný ako balík npm aj ako skript pre prehliadač. Dokáže zachytiť označenia zdrojov návštevnosti, uchovávať ich obmedzenú históriu v prehliadači a pridávať ich k vlastným udalostiam.


Na čo ho môžete využiť?

  • Reportovanie zdrojov dopytov: priraďte k potvrdeným dopytom alebo registráciám zachytené marketingové zdroje.
  • Porovnávanie kampaní: rozlišujte newsletter, platené vyhľadávanie, návštevy z odkazujúcich webov alebo vlastné označenia zdrojov.
  • Odovzdanie údajov backendu: pridajte zachytené zdroje k údajom z formulára alebo do svojho procesu v CRM, aby sa tieto informácie pri vytváraní dopytu nestratili.

Zachytávajte zdroje návštevnosti s modulom AutoROICalc pre JavaScript

Vyberte si požadované označenia zdrojov

Automatické rozpoznávanie predvolene kontroluje najprv arc_source, potom utm_campaign a nakoniec rozpoznaný zdroj alebo dvojicu zdroj/médium. Ak metóde appendNewSource() odovzdáte konkrétny zdroj, použije sa namiesto automatického rozpoznávania.

Ak uprednostňujete označenia ako newsletter / email alebo google / cpc, nastavte ignoreUtmCampaign na true. Názov kampane tak nebude mať prednosť pred zdrojom a médiom. Hodnota arc_source však má naďalej prednosť. Pri odkazoch v kampaniach používajte jednoznačné UTM parametre.

https://example.com/pricing?utm_source=newsletter&utm_medium=email&utm_campaign=launch

Pri tomto nastavení a splnení podmienok na zachytenie zdroja sa z uvedenej URL adresy uloží newsletter / email. Pri predvolenom nastavení kampane sa uloží launch.


Jednoduché nastavenie cez npm

Táto ukážka je určená pre verziu 3. V časti Integrácie v AutoROICalc skopírujte svoje ID sledovania webových udalostí. Ide o ID na zber udalostí, nie o servisný token.

npm install auto-roi-calc-web-events-tracking@^3
import { AutoRoiCalc } from 'auto-roi-calc-web-events-tracking';

// Inicializujte raz vo svojej aplikácii v prehliadači.
const arc = new AutoRoiCalc('YOUR_TRACKING_ID');

// Uprednostnite zdroj / médium pred označením utm_campaign.
arc.setConfig('ignoreUtmCampaign', true);

// Prepojte túto funkciu so správcom súhlasov pri každom načítaní stránky
// aj pri každej zmene volieb návštevníka.
export function applyTrackingConsent(consent) {
  arc.setConsent({
    analytics: consent.analytics === true,
    marketing: consent.marketing === true
  });
  arc.appendNewSource();
}

// Zavolajte po potvrdení aplikáciou, že požiadavka o ukážku bola uložená.
export function onDemoRequestSaved() {
  return arc.sendEvent(
    'lead',
    'Demo request confirmed',
    1,
    true,
    'arc_demo_request_sent'
  );
}

// Voliteľne: pridajte toto pole k údajom svojho dopytu.
export function getLeadSources() {
  return arc.getSources();
}

Funkciu applyTrackingConsent() prepojte so správcom súhlasov. Pri každom načítaní stránky aj pri zmene súhlasu jej odovzdajte skutočné voľby návštevníka. Vo verzii 3 sú operácie priraďovania zdrojov predvolene zakázané. Funkciu onDemoRequestSaved() volajte až po tom, ako aplikácia potvrdí úspešné uloženie požiadavky, nie už pri kliknutí na tlačidlo Odoslať.

Vlastný kľúč časového limitu oddeľuje obmedzovanie odosielania tejto udalosti od ostatných typov udalostí. Pri predvolenom limite ukážka potlačí ďalšiu udalosť požiadavky o ukážku produktu v tom istom prehliadači na 60 minút. Ak chcete započítať každú potvrdenú požiadavku, nastavte štvrtý argument sendEvent() na false. Návratová hodnota true znamená, že požiadavka bola zaradená na odoslanie. Nepotvrdzuje uloženie záznamu na serveri.


Využite zdroje aj mimo udalosti odoslanej z prehliadača

Pri zostavovaní údajov svojho dopytu zavolajte getLeadSources(). Keď sa pri návštevách za splnenia podmienok zachytia príslušné zdroje, výsledok môže byť napríklad ["newsletter / email", "google / cpc"]. Ide o zachytené súvislosti. Samotný zoznam nedokazuje, že každý uvedený zdroj spôsobil konverziu.

Alternatívne môžete použiť arc.setSourcesCookie(). Po udelení súhlasu zapíše aktuálny zoznam do nastavenej cookie pre zdroje, aby k nemu mal prístup server. Do označení zdrojov nevkladajte mená, e-mailové adresy ani iné osobné údaje.

Ak používate samostatný skript pre prehliadač, namiesto inštancie z npm použite window.AutoRoiCalc. K dispozícii sú rovnaké metódy na prácu so zdrojmi.


Často kladené otázky

Ktorý zdroj návštevnosti modul zachytí?

Ak metóde appendNewSource() odovzdáte konkrétny zdroj, použije sa namiesto automatického rozpoznávania. V opačnom prípade modul najprv skontroluje arc_source, potom utm_campaign a nakoniec rozpoznaný zdroj alebo dvojicu zdroj/médium. Ak chcete uprednostniť zdroj/médium pred názvom kampane, nastavte ignoreUtmCampaign na true. Hodnota arc_source má aj vtedy prednosť.

Zaznamenáva modul každú reláciu alebo návštevníka?

Nie. Modul predvolene uchováva v prehliadači najviac šesť rôznych označení zdrojov. Nevytvára úplný záznam návštev, identifikátory relácií ani identity prepájajúce viacero zariadení. Predvolený 60-minútový časový limit obmedzuje frekvenciu zachytávania zdrojov. Jeho uplynutím sa uložená história nevymaže.

Môžem modul používať aj bez npm?

Áno. Načítajte skript pre prehliadač vo verzii 3 a namiesto vytvárania inštancie z npm použite window.AutoRoiCalc. Nastavte ID sledovania, prepojte modul so správcom súhlasov a používajte rovnaké metódy na prácu so zdrojmi a udalosťami.

Môžem zachytené zdroje odovzdať backendu alebo CRM?

Áno. Pomocou getSources() načítajte pole zdrojov a priložte ho k údajom dopytu, ktoré odosiela vaša aplikácia. Metóda setSourcesCookie() prípadne po udelení súhlasu zapíše aktuálny zoznam do nastavenej cookie pre zdroje. Samotné prepojenie s backendom alebo CRM musí zabezpečiť vaša aplikácia.

Čo sa stane po odvolaní súhlasu?

Odovzdajte aktualizované voľby tak, aby boli kategórie Analytics aj Marketing vypnuté. Verzia 3 potom zablokuje ďalšie operácie priraďovania zdrojov a vráti prázdny zoznam zdrojov. Predtým uložené údaje o zdrojoch sa automaticky nevymažú. Ich odstránenie zabezpečte podľa spôsobu správy súhlasov a uchovávania údajov na vašom webe.

Začnite jednou zmysluplnou udalosťou, jednou kampaňou s jednotným označovaním odkazov a reportom zoskupeným podľa zdroja. Podrobnosti o implementácii nájdete v dokumentácii balíka npm a v návode na sledovanie webových udalostí.


Posted

in