Wtyczka linker upraszcza proces wdrażania pomiaru w wielu domenach zgodnie z opisem w przewodniku po pomiarze w wielu domenach dotyczącym analytics.js.
Przegląd
Pomiar w wielu domenach polega na udostępnianiu unikalnego identyfikatora klienta domenie źródłowej i docelowej. Ten proces składa się z dwóch etapów:
- W domenie źródłowej wszystkie adresy URL wskazujące domenę docelową zawierają identyfikator klienta domeny źródłowej.
- Gdy użytkownik przechodzi do adresu URL, domena docelowa musi mieć możliwość sprawdzenia, czy w adresie URL występuje identyfikator klienta.
Aby to zrobić, wtyczka tagu łączącego dodaje parametr łączący do adresów URL, które wskazują domenę docelową. Parametr łączący zawiera identyfikator klienta, a także aktualną sygnaturę czasową i zakodowane w nim metadane przeglądarki. Sygnatura czasowa i metadane pozwalają uniknąć problemów z udostępnianiem adresów URL.
Parametr tagu łączącego będzie wyglądać mniej więcej tak:
_ga=1.199239214.1624002396.1440697407
W domenie docelowej dostępne jest pole allowLinker
, które gdy true
nakazuje analytics.js sprawdzenie parametrów tagu łączącego w adresie URL. Jeśli parametr łączący zostanie znaleziony i prawidłowy, wyodrębni z niego identyfikator klienta i go zapisze.
Wtyczka Linker umożliwia automatyczne i ręczne dodawanie parametru tagu łączącego do adresów URL w linkach i formularzach na stronie. W większości przypadków zalecany jest sposób automatyczny.
Automatyczne dodawanie parametrów tagu łączącego konwersje
Aby w domenie źródłowej skonfigurować automatyczne łączenie w wielu domenach dla adresów URL wskazujących domenę docelową, musisz require wtyczki „linker” i wywołać jej metodę autoLink
.
autoLink
Metodę autoLink
można wywołać za pomocą kolejki poleceń.
Po uruchomieniu kod analytics.js będzie nasłuchiwać kliknięć linków wskazujących domenę (lub domeny) docelowej i dodać do tych linków parametr łączący tuż przed rozpoczęciem nawigacji. Oczekiwanie, aż użytkownik kliknie link, aby dodać parametr łączący, ponieważ parametry tagu łączącego wygasają po 2 minutach.
Jeśli w Twojej witrynie znajdują się formularze, które kierują do domeny docelowej, musisz określić opcjonalny parametr decorateForms
i ustawić wartość true
.
Wykorzystanie
ga('[trackerName.]linker:autoLink', domains, [useAnchor], [decorateForms]);
Parametry
Nazwa | Typ | Wymagane | Opis |
---|---|---|---|
domains |
Array[RexExp|string] |
tak | Tablica ciągów znaków lub wyrażeń regularnych do dopasowania do parametru hostname adresu URL, wskazująca domeny, do których ma być stosowane automatyczne łączenie. Jeśli ciąg zostanie przekazany, analytics.js przeprowadzi dopasowanie podłańcucha, co oznacza, że example.com dopasuje linki wskazujące na blog.example.com . |
useAnchor |
boolean |
nie | Jeśli ma wartość prawda, parametr łączący jest dodawany do części adresu URL związanej z kotwicem, a nie do części zapytania. |
decorateForms |
boolean |
nie | Jeśli ustawisz wartość prawda, wtyczka tagu łączącego będzie dodawać do przesłanych formularzy parametr łączący, który wskazuje miejsca docelowe pasujące do parametru domain . |
Przykład
// Loads the Linker plugin
ga('require', 'linker');
// Instructs the Linker plugin to automatically add linker parameters
// to all links and forms pointing to the domain "destination.com".
ga('linker:autoLink', ['destination.com'], false, true);
Ręczne dodawanie parametrów tagu łączącego konwersje
Parametr łączący możesz ręcznie dodać do określonego elementu <a>
lub <form>
, korzystając z metody decorate
. Ta metoda jest potrzebna tylko wtedy, gdy nie używasz opisanej powyżej metody autoLink
.
decorate
Metodę decorate
można wywołać za pomocą kolejki poleceń.
Metoda dekorowania powinna być wywoływana jak najbliżej momentu nawigacji, ponieważ parametry tagu łączącego wygasają po 2 minutach. Najczęściej metoda ta powinna być wywoływana w module obsługi zdarzeń.
Wykorzystanie
ga('[trackerName.]linker:decorate', element, [useAnchor]);
Parametry
Nazwa | Typ | Wymagane | Opis |
---|---|---|---|
element |
HTMLElement |
tak | Element <a> lub <form> , do którego ma być dołączony parametr tagu łączącego. |
useAnchor |
boolean |
nie | Jeśli ma wartość prawda, parametr łączący jest dodawany do części adresu URL związanej z kotwicem, a nie do części zapytania. |
Przykład
// Loads the Linker plugin
ga('require', 'linker');
// Gets a reference to a link pointing to an external domain.
var destinationLink = document.getElementById('destination-link');
// Adds click handler that decorates `destinationLink`.
destinationLink.addEventListener('click', function() {
ga('linker:decorate', destinationLink);
});
linkerParam
Oprócz metody decorate
możesz ręcznie pobrać parametr łączący, którego będzie używać tracker, w polu linkerParam
.
ga(function(tracker) {
var linkerParam = tracker.get('linkerParam');
});
Konfigurowanie witryny pod kątem akceptowania parametrów tagu łączącego konwersje
Gdy użytkownik trafia na stronę w domenie docelowej z parametrem łączącym w adresie URL, tag analytics.js musi wiedzieć, że go wyszukać.
Możesz polecić stronie docelowej wyszukiwanie parametrów tagu łączącego, ustawiając w polu allowLinker
wartość true
podczas tworzenia tagu śledzenia:
ga('create', 'UA-XXXXXX-X', 'auto', {
allowLinker: true
});
Pomiar dwukierunkowy w wielu domenach
Jest to proces, w którym użytkownicy zawsze zaczynają od domeny źródłowej, a później przechodzą do domeny docelowej. Jest to uznawane za pomiar jednokierunkowy w wielu domenach. W powyższych instrukcjach założono, że taki wzorzec przeglądania jest prosty.
Jeśli nie wiadomo, którą domenę użytkownicy odwiedzają jako pierwsze, musisz wdrożyć dwukierunkowy pomiar w wielu domenach, gdzie każda domena jest skonfigurowana jako źródło lub miejsce docelowe.
Aby wdrożyć dwukierunkowy pomiar w wielu domenach, włącz automatyczne łączenie w obu domenach i skonfiguruj je pod kątem akceptowania parametrów tagu łączącego.
source.com
:
ga('create', 'UA-XXXXX-Y', 'auto', {allowLinker: true});
ga('require', 'linker');
ga('linker:autoLink', ['destination.com']);
destination.com
:
ga('create', 'UA-XXXXX-Y', 'auto', {allowLinker: true});
ga('require', 'linker');
ga('linker:autoLink', ['source.com']);
Używanie jednego fragmentu kodu we wszystkich domenach
Aby jeszcze bardziej uprościć ten proces, możesz wymienić wszystkie możliwe domeny, które chcesz objąć pomiarem za pomocą metody autoLink
, co pozwoli Ci używać tego samego fragmentu kodu w każdej domenie:
ga('create', 'UA-XXXXX-Y', 'auto', {allowLinker: true});
ga('require', 'linker');
ga('linker:autoLink', ['source.com', 'destination.com']);