Importarea conversiilor offline urmărește conversiile offline din importări, cu ajutorul GCLID. În situațiile în care parametrul GCLID nu este disponibil, utilizatorii importării conversiilor offline se pot baza pe alți identificatori, cum ar fi datele oferite de utilizatori indexate prin hashing, wbraid / gbraid sau session_attributes.
În această pagină
Despre session_attributes
session_attributes este un câmp care oferă context și semnale suplimentare despre interacțiunea utilizatorului cu site-ul dvs., ceea ce poate îmbunătăți precizia măsurării conversiilor, a raportării (inclusiv detalierea pe același dispozitiv/pe mai multe dispozitive) și a licitării. Puteți folosi scriptul de mai jos din interfața noastră pentru a crea șirul codificat în base64 pentru session_attributes, pentru a-l seta în baza dvs. de date / CRM și pentru a-l trimite la Google în importările API. Dacă nu puteți folosi scriptul din interfață, folosiți câmpul session_attributes_key_value_pairs pentru a trimite individual fiecare pereche cheie-valoare.
Vă recomandăm să trimiteți toate câmpurile secundare, dar puteți alege să trimiteți oricâte doriți. Toate câmpurile secundare sunt opționale. Dimensiunea spațiului de stocare recomandată pentru câmpul session_attributes este de 5 KB. Pentru majoritatea utilizărilor, nu se va depăși această dimensiune. Dacă session_attributes este mai mare decât această dimensiune, fie colaborați cu furnizorul CRM pentru a modifica dimensiunea câmpului (recomandat), fie eliminați parametrii landing_page_url și landing_page_referrer din funcția helper a JavaScript.
Iată câmpurile secundare din cadrul câmpului session_attributes:
gad_source: un parametru agregat inclus în adresa URL pentru a identifica sursa traficului provenit din anunțuri. Aflați mai multe despre parametrii URL gad_*;gad_campaignid: codul campaniei publicitare care a generat clicul pe anunț. Aflați mai multe despre parametrii URL gad_*;landing_page_url: adresa URL completă a paginii de destinație de pe site. Acesta indică pagina pe care a accesat-o utilizatorul prima dată;session_start_time_usec: marcajul temporal al momentului în care a început sesiunea utilizatorului pe site-ul dvs. Astfel, puteți să urmăriți durata vizitelor utilizatorilor. Este important să folosiți un format de timp consecvent în microsecunde din perioada Unix a marcajului temporal;landing_page_referrer: adresa URL a paginii web care a direcționat utilizatorul către site-ul dvs. Astfel, puteți să înțelegeți sursele de trafic care trimit către site-ul dvs. Pentru mai multe informații despre sursele de recomandare, consultați acest articol. Deși se axează pe Analytics, conceptul de sursă de recomandare este universal pe web;landing_page_user_agent: un șir care identifică browserul și sistemul de operare al utilizatorului. Aceste informații pot fi utile pentru a înțelege mediul tehnic al utilizatorilor.
Cum să preluați session_attributes
Puteți folosi funcția helper JavaScript și formularul HTML de mai jos în pagina de destinație pentru a prelua și a păstra session_attributes.
Acest exemplu de cod păstrează datele în localStorage. Înainte de a-l implementa pe site, asigurați-vă că respectați cerințele privind consimțământul și păstrarea datelor specifice site-ului dvs., după caz.
Formular HTML
- Trebuie să modificați fiecare pagină de trimitere a formularului și să adăugați un câmp ascuns pentru
session_attributes. Astfel,session_attributesse va transmite sistemului dvs. backend. Mai jos este un exemplu de cod pentru a demonstra acest lucru.<form action="" name="myForm">
Nume: <input type="text" name="name">
<input type="hidden" id="session_attributes_field" name="session_attributes_field" value="">
<input type="submit" value="Trimiteți formularul" name="btnSubmit">
</form> - Exemplu de script pentru a prelua
session_attributes_encodedși a-l seta în câmpul formularului. Acest exemplu de cod păstrează datele în 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>
Cum să trimiteți datele la Google Ads
1. Câmpul session_attributes_encoded din API-ul Google Ads
Pentru utilizatorii existenți ai importării conversiilor offline care folosesc JavaScript, trimiteți aceste date setând identificatorii session_attributes codificați preluați din codul JavaScript oferit într-un câmp nou numit ClickConversion.session_attributes_encoded în schema de încărcare existentă. Continuați să folosiți procesul de importare a conversiilor offline actual, dar setați acest câmp nou când faceți importări. Google Ads va folosi session_attributes când ceilalți identificatori nu sunt prezenți.
Toți utilizatorii noi trebuie să folosească API-ul Manager de date. În cazul în care un cont nu a fost inclus pe lista cu acces permis pentru a transmite adresele IP sau atributele sesiunii prin API-ul Google Ads, veți primi un mesaj de eroare pentru conversiile respective.
Avansat
Dacă nu puteți folosi JavaScript, puteți să preluați perechile cheie-valoare individuale și să le trimiteți împreună cu importările conversiilor offline.
Pentru utilizatorii existenți ai importării conversiilor offline care nu folosesc JavaScript, puteți seta și câmpul pentru perechile cheie-valoare numit ClickConversion.session_attributes_key_value_pairs în schema de încărcare existentă. Vă recomandăm să trimiteți perechi cheie-valoare cu aceste câmpuri când apelați API-ul. Consultați documentația pentru dezvoltatori, în care se explică modul de adăugare a perechilor cheie-valoare individuale la ClickConversion.
2. Câmpul session_attributes folosind Managerul de date
Puteți trimite câmpul session_attributes și folosind Managerul de date.
- Interfața de utilizare a Managerului de date: folosiți codul JavaScript oferit pentru a crea câmpul
session_attributesși încărcați-l prin intermediul interfeței de utilizare a Managerului de date. - API-ul Data Manager: puteți face integrarea cu API-ul Manager de date pentru a încărca datele automat. Consultați documentația Managerului de date pentru instrucțiuni specifice și detalii despre schemă.
Dacă trimiteți datele potrivite, permiteți ca Google Ads să poată folosi aceste informații pentru a atribui conversiile la campaniile corecte și pentru a vă oferi rapoarte mai cuprinzătoare privind conversiile.