Importowanie konwersji offline pozwala śledzić importowane konwersje offline za pomocą identyfikatora kliknięcia Google GCLID. W przypadku, gdy identyfikator GCLID jest niedostępny, użytkownicy korzystający z importowania konwersji offline mogą użyć innych identyfikatorów, np. zaszyfrowanych danych przekazywanych przez użytkowników, parametrów wbraid lub gbraid albo parametru session_attributes.
Na tej stronie
- Informacje o parametrze session_attributes
- Jak rejestrować parametr session_attributes
- Jak wysyłać dane do Google Ads
Informacje o parametrze session_attributes
session_attributes to pole, które zawiera dodatkowe informacje o kontekście i sygnałach dotyczących interakcji użytkownika z Twoją witryną. Pozwalają one zwiększyć dokładność pomiaru konwersji, raportowania i określania stawek. Za pomocą poniższego skryptu frontendu możesz utworzyć zakodowany w formacie base64 ciąg znaków parametru session_attributes, przekazać go do bazy danych lub systemu CRM i przesłać do Google w ramach importu interfejsu API. Jeśli nie możesz użyć skryptu frontendu, użyj pola session_attributes_key_value_pairs do wysyłania poszczególnych par klucz/wartość.
Zalecamy wysyłanie wszystkich pól podrzędnych, ale możesz wysyłać dowolną ich liczbę. Wszystkie pola podrzędne są opcjonalne. W przypadku pola session_attributes zalecany rozmiar miejsca na dane to 5 KB. Większość przypadków użycia nie przekroczy tego rozmiaru. Jeśli pole session_attributes wymaga więcej miejsca, skontaktuj się z dostawcą systemu CRM, aby zmodyfikować rozmiar pola (zdecydowanie zalecane). Możesz też usunąć parametry landing_page_url i landing_page_referrer z funkcji pomocniczej JavaScript.
Oto pola podrzędne należące do pola session_attributes:
gad_source: parametr zbiorczy w adresie URL, który służy do identyfikowania źródła ruchu pochodzącego z reklam. Dowiedz się więcej o parametrach URL gad_*.gad_campaignid: identyfikator konkretnej kampanii reklamowej, która spowodowała kliknięcie reklamy. Dowiedz się więcej o parametrach URL gad_*.landing_page_url: pełny adres URL strony docelowej w witrynie. Wskazuje konkretną stronę, na którą użytkownik trafił jako pierwszą.session_start_time_usec: sygnatura czasowa rozpoczęcia sesji użytkownika w witrynie. Pomaga śledzić czas wizyt użytkowników. Ważne jest, aby używać spójnego formatu czasu w mikrosekundach według epoki uniksowej.landing_page_referrer: adres URL strony internetowej, która odesłała użytkownika do witryny. Pozwala lepiej poznać źródła wizyt w Twojej witrynie. Więcej informacji o stronach odsyłających znajdziesz w tym artykule, który dotyczy Analytics, ale zawiera ogólne informacje o stronach odsyłających.landing_page_user_agent: ciąg znaków identyfikujący przeglądarkę i system operacyjny użytkownika. Te informacje umożliwiają poznanie środowiska technicznego użytkowników.
Jak rejestrować parametr session_attributes
Aby rejestrować i przechowywać parametr session_attributes, możesz użyć funkcji pomocniczej języka JavaScript i poniższego formularza HTML na stronie docelowej.
Ten przykładowy kod zapisuje dane w pamięci lokalnej localStorage. Przed zaimplementowaniem tego kodu w witrynie upewnij się, że zostały spełnione wszystkie wymagania dotyczące zgody i przechowywania danych, które są istotne w przypadku Twojej witryny.
Formularz HTML
- Zmodyfikuj każdą stronę przesyłania formularza, aby dodać do formularza ukryte pole do przekazywania parametru
session_attributes. Dzięki temu parametrsession_attributesbędzie przekazywany do Twojego systemu backendu. Poniżej znajduje się przykładowy kod.<form action="" name="myForm">
Name: <input type="text" name="name">
<input type="hidden" id="session_attributes_field" name="session_attributes_field" value="">
<input type="submit" value="Submit Form" name="btnSubmit">
</form> - Przykładowy skrypt do rejestrowania wartości parametru
session_attributes_encodedi ustawiania jej w polu formularza. Ten przykładowy kod zapisuje dane w pamięci lokalnej localStorage.<script>
function getSessionAttributes() {
const searchParams = new URLSearchParams(window.location.search);
if (Array.from(searchParams.keys()).some(key => key.startsWith('gad_')) ||
searchParams.has('gclid') || searchParams.has('gbraid')) {
const params = {};
searchParams.forEach((value, key) => {
if (key.startsWith('gad_')) params[key] = value;
});
params['session_start_time_usec'] =
(new Date().getTime() * 1000).toString();
params['landing_page_url'] = window.location.href;
params['landing_page_referrer'] = document.referrer;
params['landing_page_user_agent'] = navigator.userAgent;
const sessionAttributesEncoded = btoa(JSON.stringify(params))
.replace(/\+/g, '-')
.replace(/\//g, '_')
.replace(/=+$/, '');
localStorage.setItem('google_session_attributes', sessionAttributesEncoded);
return sessionAttributesEncoded;
}
return localStorage.getItem('google_session_attributes') || '';
}
function addSessionAttributes() {
const sessionAttributesEncoded = getSessionAttributes();
var sessionAttributesFormField =
document.getElementById('session_attributes_field');
if (sessionAttributesFormField && sessionAttributesEncoded != '') {
sessionAttributesFormField.value = sessionAttributesEncoded;
}
}
window.addEventListener('load', addSessionAttributes);
</script>
Jak wysyłać dane do Google Ads
1. Pole session_attributes_encoded w interfejsie Google Ads API
W przypadku dotychczasowych użytkowników importowania konwersji offline, którzy korzystają z JavaScriptu, najprostszym sposobem rozpoczęcia wysyłania tych danych jest ustawienie zakodowanego parametru session_attributes zarejestrowanego na podstawie wartości JavaScript podanej w nowym polu o nazwie ClickConversion.session_attributes_encoded w aktualnym schemacie przesyłania. Możesz nadal używać bieżącego procesu importowania konwersji offline, ale podczas importowania danych ustaw wartość w tym nowym polu. W przypadku braku innych identyfikatorów Google Ads użyje parametru session_attributes.
Zaawansowane
Jeśli nie możesz użyć JavaScriptu, możesz rejestrować indywidualne pary klucz-wartość i wysyłać je za pomocą importowania konwersji offline.
W przypadku dotychczasowych użytkowników importowania konwersji offline, którzy nie korzystają z JavaScriptu, możesz też ustawić wartość w polu pary klucz-wartość o nazwie ClickConversion.session_attributes_key_value_pairs w aktualnym schemacie przesyłania. Zalecamy wysyłanie par klucz-wartość podczas wywoływania interfejsu API za pomocą tych pól. W dokumentacji dla deweloperów znajdziesz informacje o dodawaniu indywidualnych par klucz-wartość do zdarzenia ClickConversion.
2. Pole session_attributes za pomocą Menedżera danych
Możesz też wysyłać pole session_attributes za pomocą Menedżera danych.
- UI Menedżera danych: użyj podanego kodu JavaScript, aby utworzyć pole
session_attributesi przesłać je za pomocą UI Menedżera danych. - UI Data Manager API: możesz zintegrować interfejs Data Manager API, aby automatycznie przesyłać dane. Szczegółowe instrukcje i informacje o schematach znajdziesz w dokumentacji Menedżera danych.
Wysyłając odpowiednie dane, umożliwiasz Google Ads wykorzystanie z tych informacji do przypisywania konwersji do odpowiednich kampanii i dostarczania bardziej kompleksowych raportów o konwersjach.