Tag łączący

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:

  1. W domenie źródłowej wszystkie adresy URL wskazujące domenę docelową zawierają identyfikator klienta domeny źródłowej.
  2. 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.

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']);