התהליך "ייבוא של נתוני המרות אופליין" (OCI) מספק מעקב אחרי ההמרות אופליין דרך GCLID. בתרחישים שבהם GCLID לא זמין, משתמשי OCI יכולים להסתמך על מזהים אחרים כמו פרטים מגובבים שהמשתמשים סיפקו (UPD), wbraid/gbraid או session_attributes.
הנושאים בדף
מידע על session_attributes
session_attributes הוא שדה שמספק הקשר ואותות נוספים על האינטראקציה של המשתמשים עם האתר שלכם. האלמנטים האלה יכולים לשפר את הדיוק של מעקב ההמרות, הדיווח (כולל פירוט לפי מכשיר אחד או מכשירים שונים) והבידינג. אתם יכולים להשתמש בסקריפט של ממשק הקצה שלנו שמופיע בהמשך כדי ליצור את המחרוזת עם קידוד base64 של session_attributes, להעביר אותה למסד הנתונים או למערכת ניהול קשרי הלקוחות (CRM) ולשלוח אותה ל-Google בפעולות הייבוא של ה-API. אם אתם לא יכולים להשתמש בסקריפט של ממשק הקצה, השתמשו בשדה session_attributes_key_value_pairs כדי לשלוח כל צמד מפתח/ערך בנפרד.
אנחנו ממליצים לשלוח את כל שדות המשנה, אבל אפשר לשלוח כמה שדות משנה שרוצים. כל שדות המשנה הם אופציונליים. הגודל המומלץ של השדה session_attributes באחסון הוא 5KB. רוב השימושים לא יחרגו מהגודל הזה. אם השדה session_attributes גדול מ-5KB, מומלץ מאוד לעבוד עם הספק של מערכת ה-CRM כדי לשנות את גודל השדה. אפשרות אחרת היא להסיר את הפרמטרים landing_page_url ו-landing_page_referrer מפונקציית העזר של JavaScript.
אלה שדות המשנה שבתוך השדה session_attributes:
-
gad_source: פרמטר מצטבר שנכלל בכתובת ה-URL ונועד לזהות את מקור התנועה שנובעת מהמודעות. מידע נוסף על פרמטרי gad_* של כתובת ה-URL -
gad_campaignid: המזהה של קמפיין הפרסום הספציפי שגרם לקליק על המודעה. מידע נוסף על פרמטרי gad_* של כתובת ה-URL -
landing_page_url: כתובת ה-URL המלאה של דף הנחיתה באתר. השדה הזה מציין את הדף הראשון שהמשתמש הגיע אליו. -
session_start_time_usec: חותמת הזמן שמציינת מתי התחיל הסשן של המשתמש באתר שלכם. הערך הזה עוזר לעקוב אחרי משך הזמן של ביקורי המשתמש. חשוב להשתמש בפורמט זמן עקבי של חותמת זמן במיקרו-שניות לפי תקופת הזמן של מערכת UNIX. -
landing_page_referrer: כתובת ה-URL של דף האינטרנט שקישר את המשתמש לאתר שלכם. הערך הזה עוזר להבין את מקורות התנועה שהובילו לאתר. לקבלת מידע נוסף על מקורות ההפניה, אפשר לקרוא את המאמר הזה שאמנם מתמקד ב-Analytics, אך המושג "מקור ההפניה (referrer)" הוא אוניברסלי באינטרנט. -
landing_page_user_agent: מחרוזת שמזהה את הדפדפן ואת מערכת ההפעלה של המשתמש. המידע הזה יכול להיות שימושי להבנת הסביבה הטכנית של המשתמשים שלכם.
איך לשלוף מידע מ-session_attributes
אתם יכולים להשתמש בפונקציית העזר של JavaScript ובטופס ה-HTML שבתחתית דף הנחיתה שלכם כדי לשלוף ולשמור נתונים מ-session_attributes.
הקוד לדוגמה שומר את הנתונים ב-localStorage. לפני ההטמעה באתר, חשוב גם לוודא שאתם עומדים בדרישות הספציפיות של האתר לגבי הסכמות ושמירת נתונים.
טופס HTML
- צריך להוסיף שדה מוסתר ל-
session_attributesבכל אחד מהדפים שבהם מגישים טופס באתר. כך נתוני ה-session_attributesיועברו למערכת הבק-אנד שלכם. בהמשך מופיע קוד לדוגמה.<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> - סקריפט לדוגמה לשליפה של נתונים מהשדה
session_attributes_encodedושיבוץ שלו בשדה הטופס. הקוד לדוגמה שומר את הנתונים ב-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>
איך לשלוח את הנתונים אל Google Ads
1. השדה session_attributes_encoded ב-Google Ads API
אם אתם כבר מייבאים נתוני המרות אופליין באמצעות JavaScript, כדי לשלוח את הנתונים האלה, אתם יכולים להגדיר את השדה המקודד session_attributes שהתקבל באמצעות קוד JavaScript שסופק בשדה חדש בשם ClickConversion.session_attributes_encoded בסכימת ההעלאות הרגילה שלכם. אתם יכולים להמשיך להשתמש בתהליך ה-OCI הקיים, אבל אתם צריכים להגדיר את השדה החדש הזה כשאתם מבצעים ייבוא. מערכת Google Ads משתמשת ב-session_attributes כשהמזהים האחרים שלכם לא נמצאים.
כל המשתמשים החדשים צריכים להשתמש ב-Data Manager API. אם חשבון לא נכלל ברשימת ההיתרים לשידור כתובות IP או מאפייני סשן דרך Google Ads API, תקבלו הודעת שגיאה לגבי ההמרות האלה.
מתקדם
אם אין לכם אפשרות להשתמש ב-JavaScript, אתם יכולים לשלוף את צמדי המפתח/ערך הנפרדים ולשלוח אותם עם הייבוא של נתוני ההמרות אופליין (OCI).
אם אתם כבר מייבאים נתוני המרות אופליין, אבל לא ב-JavaScript, אתם יכולים גם להגדיר את השדה של צמד המפתח/ערך בשם ClickConversion.session_attributes_key_value_pairs בסכימת ההעלאות הרגילה שלכם. אנחנו מציעים לשלוח צמדי מפתח/ערך עם השדות שכאן כששולחים קריאה ל-API. כדאי לעיין במאמרי העזרה למפתחים שמפרטים איך להוסיף צמדי מפתח/ערך נפרדים ל-ClickConversion.
אפשר לעיין בהמלצות הבאות ולעדכן את ההטמעה כדי לוודא שנתונים תקינים נשלחים:
-
gad_campaignid (מזהה קמפיין): חשוב לוודא שאתם שולחים באופן עקבי את מזהה הקמפיין התקין ב-Google Ads שמשויך לקליק על המודעה. זהו מזהה הקמפיין שמאוכלס בכתובת האתר לקליקים על מודעות כ-gad_campaignid=1234. זהו מאפיין מרכזי שחשוב מאוד לשיוך מדויק. -
session_start_time_usec: חשוב לשלוח את המאפיין באופן עקבי (חותמת הזמן שבה התחיל סשן המשתמש). -
landing_page_url (כתובת URL): חשוב לוודא שאתם שולחים את כתובת ה-URL המלאה והמדויקת של דף הנחיתה. אל תשלחו מחרוזות פלייסהולדר, נתיבים פנימיים של אפליקציות או כתובות URL לא מלאות.- הערה: אם כתובת ה-URL המדויקת והמלאה לא זמינה, מומלץ להסיר את השדה כולו, כי נתונים שגויים עלולים לפגוע בתהליך יצירת המודל.
-
landing_page_user_agent (סוכן משתמש): חשוב לוודא שהמחרוזת משקפת בצורה מדויקת את הדפדפן ואת מערכת ההפעלה של המשתמש, ולהימנע משליחת ערכים גנריים או כתובים בתוך הקוד.
2. שדה session_attributes שמשתמש במרכז לניהול נתונים
אפשר גם לשלוח את השדה session_attributes באמצעות המרכז לניהול נתונים.
- ממשק המשתמש של המרכז לניהול נתונים: משתמשים בקוד ה-JavaScript שסופק כדי ליצור את השדה
session_attributesומעלים אותו דרך ממשק המשתמש של המרכז לניהול נתונים. - Data Manager API: אתם יכולים להעלות נתונים באופן פרוגרמטי דרך ה-Data Manager API. כדאי לעיין במאמרי העזרה של המרכז לניהול נתונים לקבלת הוראות ספציפיות ופרטי סכימה.
חשוב שתשלחו את הנתונים הנכונים כי ככה אתם מאפשרים למערכת של Google Ads להשתמש במידע הזה כדי לייחס המרות לקמפיינים הנכונים ולספק לכם דיווח המרות מקיף יותר.