Offline‑konversioiden importointi (OCI) seuraa offline-konversioita importoinneista GCLID-parametrin avulla. Jos GCLID ei ole saatavilla, OCI-käyttäjät voivat käyttää muita tunnisteita, mukaan luettuna tiivistetty käyttäjiltä saatu data, wbraid/gbraid tai session_attributes.
Sisältö:
session_attributes
session_attributes-kentästä saat lisää kontekstia ja signaaleja käyttäjän toiminnasta verkkosivustollasi. Se voi parantaa konversiomittausta, raportointia (esim. saman laitteen ja eri laitteiden erittelyä) ja hintatarjousten tarkkuutta. Alla olevan käyttöliittymäskriptin avulla voit luoda base64-koodatun session_attributes-stringin, välittää sen tietokantaasi tai CRM-järjestelmääsi ja lähettää sen Googlelle API-importoinnin yhteydessä. Jos et voi käyttää käyttöliittymäskriptiä, käytä session_attributes_key_value_pairs-kenttää avain/arvo-parien lähettämiseksi yksitellen.
Suosittelemme, että lähetät kaikki alakentät, mutta voit päättää itse, kuinka monta kenttää haluat lähettää. Kaikki alakentät ovat valinnaisia. Suositeltu tallennuskoko session_attributes-kentälle on 5 kt. Useimmat käyttötapaukset eivät ylitä tätä kokoa. Jos session_attributes on tätä suurempi, muokkaa kentän kokoa CRM-palveluntarjoajan kanssa (suositus) tai poista landing_page_url- ja landing_page_referrer-parametrit JavaScriptin apufunktiosta.
Tässä ovat session_attributes-kentän sisältämät alakentät:
gad_source: URL-osoitteeseen sisältyvä koosteparametri, joka auttaa tunnistamaan mainoksista peräisin olevan liikenteen lähteen. Lue lisää gad_*-URL-parametreistä.gad_campaignid: Mainosklikkaukseen johtaneen mainoskampanjan tunnus. Lue lisää gad_*-URL-parametreistä.landing_page_url: Verkkosivustosi laskeutumissivun koko URL-osoite. Tämä kertoo sivun, jolle käyttäjä päätyi ensimmäiseksi.session_start_time_usec: Aikaleima, joka kertoo, milloin käyttäjän istunto sivustollasi alkoi. Tämä auttaa seuraamaan sivustokäyntien kestoa. On tärkeää käyttää johdonmukaista ajan muotoa, esimerkiksi UNIX-aikaa mikrosekunteina.landing_page_referrer: Verkkosivuston URL-osoite, joka johti käyttäjän sivustollesi. Tämä auttaa ymmärtämään sivustollesi ohjaavia liikenteen lähteitä. Jos haluat lisätietoa viittaavista sivuista, lue tämä artikkeli. Siinä keskitytään Google Analyticsiin, mutta viittaavan sivun käsite on yleisesti käytössä verkossa.landing_page_user_agent: Stringi, jonka perusteella voi tunnistaa käyttäjän selaimen ja käyttöjärjestelmän. Tämä voi auttaa ymmärtämään käyttäjien teknistä ympäristöä.
Näin session_attributes tallennetaan
Voit käyttää JavaScriptin apufunktiota ja alla olevaa HTML-lomaketta laskeutumissivulla session_attributes-kentän tallentamiseen.
Esimerkkikoodi tallentaa datan localStorage-tallennustilaan. Varmista vielä ennen koodin käyttöönottoa sivustolla, että tarvittavia suostumus- ja datansäilytysvaatimuksia noudatetaan sivustollasi.
HTML-lomake
- Muokkaa jokaista lomakkeen lähetyssivua lisäämällä piilotettu kenttä
session_attributes-kentälle. Näinsession_attributesvälittyy backend-järjestelmääsi. Alla on koodinäyte.<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> - Skriptinäyte, jolla tallennetaan
session_attributes_encodedja lisätään se lomakekenttään. Esimerkkikoodi tallentaa datan localStorage-tallennustilaan.<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>
Näin lähetät dataa Google Adsiin
1. session_attributes_encoded-kenttä Google Ads APIssa
Jos käytät jo offline‑konversioiden importointia (OCI) ja JavaScriptiä, lähetä data lisäämällä koodattu session_attributes-parametri, joka on kerätty JavaScriptistä, uuteen kenttään nimeltä ClickConversion.session_attributes_encoded nykyisessä latausmallissa. Voit jatkaa nykyisen OCI-prosessin käyttöä, mutta lisää tämä uusi kenttä importointeihin. Google Ads käyttää session_attributes-kenttää, kun muita tunnisteita ei ole saatavilla.
Kaikkien uusien käyttäjien on käytettävä Data Manager APIa. Jos tiliä ei ole sallittu IP-osoitteiden tai istuntoattribuuttien lähettämiseen Google Ads APIn kautta, saat virheilmoituksen kyseisistä konversioista.
Lisäasetukset
Jos et voi käyttää JavaScriptiä, voit tallentaa yksittäiset avain/arvo-parit ja lähettää ne offline‑konversioiden importoinnilla.
Jos käytät jo Offline‑konversioiden importointia (OCI) mutta et käytä JavaScriptiä, voit vaihtoehtoisesti lisätä valmiiseen latausmalliin avain-arvo-parikentän nimeltä ClickConversion.session_attributes_key_value_pairs. Suosittelemme, että lähetät avain/arvo-parit näiden kenttien kanssa, kun kutsut APIa. Jos haluat lisätietoa yksittäisten avain/arvo-parien lisäämisestä ClickConversion-kohtaan, lue lisää kehittäjäohjeista.
2. session_attributes-kenttä Data Managerissa
Voit lähettää session_attributes-kentän myös Data Managerin avulla.
- Data Managerin käyttöliittymä: Luo
session_attributes-kenttä JavaScriptin avulla ja lataa se Data Managerin käyttöliittymän kautta. - Data Manager API: Voit ladata dataa ohjelmallisesti Data Manager APIn avulla. Lisäohjeita ja tietoja malleista saat Data Managerin käyttöohjeista.
Lähettämällä oikean datan Google Adsiin konversiot kirjautuvat oikeisiin kampanjoihin ja saat kattavampia konversioraportteja.