Uvoz offline konverzija (OCI) prati offline konverzije iz uvoza pomoću parametra GCLID. U scenarijima u kojima GCLID nije dostupan, korisnici OCI-ja mogu se oslanjati na druge identifikatore kao što su hashirani podaci koje su naveli korisnici, wbraid/gbraid ili session_attributes.
Na ovoj stranici
- O atributu session_attributes
- Kako zabilježiti atribut session_attributes
- Kako poslati podatke u Google Ads
O atributu session_attributes
Atribut session_attributes je polje koje pruža dodatni kontekst i signale o korisnikovoj interakciji s vašom web-lokacijom, što može poboljšati točnost mjerenja konverzija, izvješćivanja (uključujući raščlambu na istom/različitim uređajima) i licitiranja. Pomoću naše skripte za sučelje u nastavku možete izraditi niz session_attributes kodiran algoritmom base64, proslijediti ga svojoj bazi podataka/CRM-u i poslati Googleu u uvozima API-ja. Ako ne možete upotrijebiti skriptu za sučelje, upotrijebite atribut session_attributes_key_value_pairs da biste pojedinačno poslali svaki par ključ/vrijednost.
Preporučujemo da pošaljete sva podpolja, ali možete poslati onoliko koliko god želite. Sva su podpolja neobavezna. Preporučena veličina pohrane za polje session_attributes iznosi 5 KB. Većina upotrebe neće premašiti tu veličinu. Ako je session_attributes veći od toga, surađujte s davateljem usluga CRM-a da biste izmijenili veličinu polja (preporučuje se) ili uklonite parametre landing_page_url i landing_page_referrer iz JavaScript pomoćne funkcije.
Slijedi popis podentiteta unutar polja session_attributes:
gad_sourceskupni parametar koji se poslužuje u URL-u radi identifikacije izvora prometa koji potječe iz oglasa. Saznajte više o parametrima URL-a gad_*.gad_campaignid:ID određene oglasne kampanje koja je dovela do klika na oglas. Saznajte više o parametrima URL-a gad_*.landing_page_url:potpuni URL odredišne stranice na vašoj web-lokaciji. To označava određenu stranicu na koju je korisnik prvi put došao.session_start_time_usec:vremenska oznaka početka korisnikove sesije na vašoj web-lokaciji. To pomaže pratiti trajanje korisničkih posjeta. Važno je upotrijebiti dosljedan format vremena u epohi mikrosekundi Unix vremenske oznake.landing_page_referrer:URL web-stranice koja je korisnika povezala s vašom web-lokacijom. To pomaže u razumijevanju izvora prometa koji vode na vašu web-lokaciju. Više informacija o preporukama potražite u ovom članku koji je usmjeren na Analytics, no koncept preporuke univerzalan je na cijelom webu.landing_page_user_agent:niz koji identificira korisnikov preglednik i operativni sustav. Te vam informacije mogu pomoći da steknete uvid u tehničko okruženje svojih korisnika.
Kako zabilježiti atribut session_attributes
Pomoću JavaScript pomoćne funkcije i HTML obrasca u nastavku na odredišnoj stranici možete zabilježiti i zadržati session_attributes.
Ovaj primjer koda trajno pohranjuje podatke u localStorage. Prije implementacije na web-lokaciju dodatno provjerite jesu li ispunjeni svi potrebni zahtjevi za pristanak i zadržavanje podataka koji se odnose na vašu web-lokaciju.
HTML obrazac
- Morate izmijeniti svaku stranicu za slanje obrasca da biste dodali skriveno polje za
session_attributes. Tako će sesession_attributesproslijediti vašem pozadinskom sustavu. U nastavku se nalazi primjer koda koji to pokazuje.<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> - Primjer skripte za bilježenje parametra
session_attributes_encodedi postavljanje u polje obrasca. Ovaj primjer koda trajno pohranjuje podatke u 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>
Kako poslati podatke u Google Ads
1. Polje session_attributes_encoded u Google Ads API-ju
Za postojeće korisnike uvoza offline konverzija (OCI) koji upotrebljavaju JavaScript pošaljite te podatke tako da postavite kodirane atribute session_attributes zabilježene iz JavaScripta navedenog u novom polju pod nazivom ClickConversion.session_attributes_encoded unutar postojeće sheme prijenosa. Nastavite upotrebljavati trenutačni postupak OCI-ja, ali postavite ovo novo polje prilikom uvoza. Google Ads upotrebljavat će session_attributes kada vaši drugi identifikatori nisu prisutni.
Svi novi korisnici moraju upotrebljavati Data Manager API. Ako račun nije dodan na popis dopuštenih za prijenos IP adresa ili atributa sesije putem Google Ads API-ja, za te ćete konverzije primiti poruku o pogrešci.
Napredno
Ako ne možete upotrebljavati JavaScript, možete zabilježiti pojedinačne parove ključ/vrijednost i poslati ih s uvozima offline konverzija.
Za postojeće korisnike uvoza offline konverzija (OCI) koji ne upotrebljavaju JavaScript možete postaviti i polje s parom ključ/vrijednost pod nazivom ClickConversion.session_attributes_key_value_pairs u postojećoj shemi prijenosa. Preporučujemo da prilikom poziva API-ja šaljete parove ključ/vrijednost s tim poljima. Pogledajte dokumentaciju razvojnog programera u kojoj se objašnjava kako dodati pojedinačne parove ključ/vrijednost u ClickConversion.
2. Slanje polja session_attributes pomoću Upravitelja podataka
Polje session_attributes možete poslati i pomoću Upravitelja podataka.
- Korisničko sučelje Upravitelja podataka: upotrijebite navedeni JavaScript za izradu polja
session_attributesi prenesite ga putem korisničkog sučelja Upravitelja podataka. - Data Manager API: možete izvršiti integraciju s Data Manager API-jem da biste programski prenosili podatke. Konkretne upute i pojedinosti o shemi potražite u dokumentaciji Upravitelja podataka.
Slanjem odgovarajućih podataka omogućujete Google Adsu da upotrebljava te informacije za atribuciju konverzija odgovarajućim kampanjama i pružanje sveobuhvatnijih izvješća o konverzijama.