Import offline konverzií sleduje offline konverzie z importov pomocou parametra GCLID. V prípadoch, keď parameter GCLID nie je dostupný, môžu používatelia importu offline konverzií využívať iné identifikátory, ako sú hašované údaje poskytnuté používateľom, parameter wbraid alebo gbraid či údaje session_attributes.
Na tejto stránke
- Údaje session_attributes
- Ako zaznamenávať údaje session_attributes
- Ako odosielať tieto údaje do služby Google Ads
Údaje session_attributes
Pole session_attributes poskytuje ďalší kontext a signály o interakcii používateľa s vaším webom. Môže to zlepšiť presnosť merania konverzií, reportov (vrátane rozdelenia podľa rovnakého alebo rôznych zariadení) a ponúk. Pomocou nášho skriptu pre klientske rozhranie, ktorý nájdete nižšie, môžete vytvoriť reťazec údajov session_attributes s kódovaním base64, odovzdať ho do svojej databázy alebo systému riadenia vzťahov so zákazníkmi a odosielať ho Googlu v importoch cez rozhranie API. Ak nemôžete použiť skript klientskeho rozhrania, pomocou poľa session_attributes_key_value_pairs odosielajte jednotlivé páry kľúča a hodnoty osobitne.
Odporúčame odosielať všetky podradené polia, ale to, koľko ich budete odosielať, je na vás. Všetky podradené polia sú nepovinné. Odporúčaná veľkosť ukladacieho priestoru pre pole session_attributes je 5 kB. Vo väčšine prípadov použitia sa táto veľkosť neprekročí. Ak je pole session_attributes väčšie, v spolupráci s poskytovateľom systému riadenia vzťahov so zákazníkmi upravte veľkosť poľa (dôrazne to odporúčame) alebo odstráňte parametre landing_page_url a landing_page_referrer z pomocnej funkcie v jazyku JavaScript.
Zoznam podradených polí v poli session_attributes:
gad_source: agregovaný parameter zobrazovaný vo webovej adrese na identifikáciu zdroja návštevnosti pochádzajúcej z reklám. Prečítajte si viac o parametroch webovej adresy gad_*.gad_campaignid: identifikátor konkrétnej reklamnej kampane, ktorá viedla ku kliknutiu na reklamu. Prečítajte si viac o parametroch webovej adresy gad_*.landing_page_url: úplná webová adresa vstupnej stránky na vašom webe. Ide o konkrétnu stránku, na ktorú sa používateľ dostal najprv.session_start_time_usec: časová pečiatka začiatku relácie používateľa na vašom webe. Umožňuje sledovať trvanie návštev používateľov. Je dôležité používať konzistentný formát času v mikrosekundách epochy unixovej časovej pečiatky.landing_page_referrer: adresa webovej stránky, ktorá používateľa odkázala na váš web. Umožňuje zistiť zdroje návštevnosti vedúce na váš web. Ďalšie informácie o sprostredkovateľoch nájdete v tomto článku, ktorý sa síce zameriava na Analytics, ale pojem sprostredkovateľ je univerzálny naprieč internetom.landing_page_user_agent: reťazec, ktorý identifikuje prehliadač a operačný systém používateľa. Tieto informácie môžu byť užitočné na zistenie technického prostredia používateľov.
Ako zaznamenávať údaje session_attributes
Prostredníctvom pomocnej funkcie v jazyku JavaScript a formulára HTML uvedeného nižšie môžete na vstupnej stránke zaznamenávať a ukladať údaje session_attributes.
Tento ukážkový kód ukladá údaje do objektu localStorage. Pred implementáciou na svojom webe sa okrem toho podľa potreby uistite, že sú splnené všetky nevyhnutné požiadavky na súhlas a uchovávanie údajov špecifické pre váš web.
Formulár HTML
- Na každú stránku odoslania formulára musíte pridať skryté pole
session_attributes. Takto sa budú údajesession_attributesodosielať do vášho systému koncového servera. Na znázornenie uvádzame nižšie ukážkový kód.<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> - Ukážkový skript na zaznamenávanie údajov
session_attributes_encodeda ich nastavenie v poli formulára. Tento ukážkový kód ukladá údaje do objektu 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>
Ako odosielať tieto údaje do služby Google Ads
1. Pole session_attributes_encoded v rozhraní Google Ads API
V prípade existujúcich používateľov importu offline konverzií, ktorí používajú JavaScript, odosielajte tieto údaje nastavením kódovaných atribútov relácie session_attributes zaznamenaných z poskytnutého kódu v jazyku JavaScript v novom poli s názvom ClickConversion.session_attributes_encoded v existujúcej schéme nahrávania. Naďalej používajte svoj aktuálny proces importu offline konverzií, ale pri importoch nastavte toto nové pole. Keď nebudú k dispozícii iné identifikátory, Google Ads použije údaje session_attributes.
Všetci noví používatelia musia používať Data Manager API. Ak účet nebol pridaný na zoznam povolených účtov na prenos adries IP alebo atribútov relácie prostredníctvom rozhrania Google Ads API, v prípade týchto konverzií sa zobrazí chybové hlásenie.
Pre pokročilých
Ak nemôžete použiť JavaScript, môžete zaznamenávať jednotlivé páry kľúča a hodnoty a odosielať ich pomocou importov offline konverzií.
V prípade existujúcich používateľov importu offline konverzií, ktorí nepoužívajú JavaScript, by v existujúcej schéme nahrávania bolo možné nastaviť aj pole páru kľúča a hodnoty s názvom ClickConversion.session_attributes_key_value_pairs. Navrhujeme odosielať páry kľúča a hodnoty pomocou týchto polí pri volaní rozhrania API. Pozrite si dokumentáciu pre vývojárov, v ktorej je vysvetlené, ako pridať jednotlivé páry kľúča a hodnoty do objektu ClickConversion.
2. Odosielanie poľa session_attributes pomocou nástroja Data Manager
Pole session_attributes môžete odosielať aj pomocou nástroja Data Manager.
- Používateľské rozhranie nástroja Data Manager: pomocou poskytnutého kódu v jazyku JavaScript vytvorte pole
session_attributesa nahrajte ho prostredníctvom používateľského rozhrania nástroja Data Manager. - Data Manager API: môžete vytvoriť integráciu s rozhraním Data Manager API na programové nahrávanie údajov. Konkrétne pokyny a podrobnosti o schéme nájdete v dokumentácii k nástroju Data Manager.
Odosielaním správnych údajov umožňujete službe Google Ads, aby na základe týchto informácií pripisovala konverzie správnym kampaniam a poskytovala vám komplexnejšie reporty konverzií.