מיפוי פרמטרים של ValueTrack לשדות בדוחות

פרמטרים של ValueTrack הם פרמטרים של כתובות URL שאפשר להוסיף לכתובות דפי הנחיתה של המודעות. הם אוספים מידע לגבי המקור שממנו מגיעים הקליקים על המודעות. כדאי להשתמש בהם אם אתם רוצים לקבל מידע נוסף על הקליקים על המודעה שלכם, או אם אתם מתחילים להשתמש במעקב.

כשמפעילים תיוג אוטומטי, מספר הקליק ב-Google‏ (GCLID) מתווסף באופן אוטומטי לכל כתובת URL. בהמשך אפשר להשתמש בו כדי למפות קליק על מודעה לשורה בדוח.

סקירה כללית לגבי אופן הפעולה של פרמטרים של ValueTrack זמינה במאמר מידע על פרמטרים של ValueTrack. רשימה מלאה של הפרמטרים של ValueTrack מופיעה בקטע פרמטרים זמינים של ValueTrack במאמר הגדרה של מעקב עם פרמטרים של ValueTrack.

‫Google Analytics וממשק ה-API שלו מספקים אפשרות נוספת לאיסוף מדדים לגבי קליקים.

בדוחות של Google Ads API יש משאבים ותצוגות שבהם אפשר לשלוח שאילתות לגבי שדות שתואמים לפרמטרים של ValueTrack. עם זאת, ערך הטקסט של השדה הממופה לא בהכרח זהה. לדוגמה, כש-{matchtype} שווה ל-e (קיצור של התאמה מדויקת), בשדה הדוח התואם, כמו ad_group_criterion.keyword.match_type, מוצג הערך EXACT. בטבלה הבאה מוצגות כמה דוגמאות למיפויים.

איך הפרמטרים של ValueTrack ממופים לשדות בדוחות

פרמטר ValueTrack	שדות במשאבי הדוח	תיאור
{adgroupid}	ad_group.id	מזהה קבוצת המודעות (הפרמטר הזה מתאים אם הגדרתם את פרטי המעקב ברמת החשבון או הקמפיין, ואתם רוצים לדעת מתוך איזו קבוצת מודעות המודעה שלכם הוצגה).
{adposition}	מיפוי לשילוב של: click_view.page_number segments.slot אין שדה שממפה את מיקום המודעה, כמו "למעלה" או "בצד".	המיקום בדף שבו המודעה שלכם הופיעה, עם ערך כמו "1t2" (שפירושו דף 1, ראש הדף, מיקום 2).
{advanced_booking_window}	segments.hotel_booking_window_days	מספר הימים שחלפו בין התאריך שבו בוצע הקליק על המודעה לבין תאריך הצ'ק-אין שהוצג בה. לדוגמה, "3" אם הקליק על המודעה התרחש ב-5 ביוני ותאריך הצ'ק-אין שמוצג במודעה הוא 8 ביוני.
{campaignid}	campaign.id	מזהה הקמפיין (הפרמטר הזה מתאים אם הגדרתם את פרטי המעקב ברמת החשבון, ואתם רוצים לדעת במסגרת איזה קמפיין המודעה שלכם הוצגה).
{creative}	ad_group_ad.ad.id	המזהה הייחודי של המודעה.
{device}	segments.device	סוג המכשיר שממנו הגיע הקליק.
{feeditemid}	אין (הוצאה משימוש, צריך להשתמש ב- asset.id עם {extensionid})	המזהה של התוסף מבוסס הפיד שהמשתמש לחץ עליו. הערה: תוספים שמבוססים על פיד הוצאו משימוש ואין להם משאב דיווח תואם בגרסאות הנתמכות של Google Ads API. תוספים שמבוססים על נכסים משתמשים ב-{extensionid}, שממופה ל-asset.id.
{extensionid}	asset.id	המזהה של התוסף שמבוסס על נכס דיגיטלי שהמשתמש לחץ עליו.
{hotelcenter_id}	segments.hotel_center_id	המזהה של חשבון Hotel Center שמקושר לקמפיין שאליו שייכת המודעה שהוצגה (הקישור בין החשבון לקמפיין נבדק נכון לרגע של הקליק על המודעה).
{hotel_id}	segments.partner_hotel_id	מזהה המלון מתוך פיד המלון של החשבון המשויך.
{keyword}	segments.keyword.ad_group_criterion שימו לב שאפשר למצוא את שאילתת הטקסט באמצעות שם המשאב של הקריטריון.	ברשת החיפוש: מילת המפתח מהחשבון שלכם שתואמת לשאילתת החיפוש. ברשת המדיה: מילת המפתח מהחשבון שלכם שתואמת לתוכן.
{loc_interest_ms}	click_view.area_of_interest.most_specific	מזהה המיקום הרלוונטי שסייע להפעלת המודעה. (אפשר לחפש מזהה קריטריון באמצעות GeoTargetConstantService.SuggestGeoTargetConstants.)
{loc_physical_ms}	click_view.location_of_presence.most_specific	המזהה של המיקום הגיאוגרפי שבו בוצע הקליק. (אפשר לחפש מזהה קריטריון באמצעות GeoTargetConstantService.SuggestGeoTargetConstants.)
{lpurl}	ad_group_ad.ad.final_urls ad_group_criterion.final_urls	כתובת ה-URL הסופית. אם לא תוסיפו את הפרמטר {lpurl} בתחילת תבנית המעקב, המערכת תסמן את הכתובת הזאת בתו בריחה (escape). אם הפרמטר {lpurl} לא מופיע בתחילת תבנית המעקב, המערכת מסמנת את הכתובת בתווי המילוט (escape) האלה: ?,‏ =,‏ ",‏ #,‏ \t,‏ ' וגם [space].
{matchtype}	ad_group_criterion.keyword.match_type shared_criterion.keyword.match_type segments.search_term_match_type	סוג ההתאמה של מילת המפתח שהקפיצה את המודעה. (מידע נוסף על סוגי התאמה)
{merchant_id}	segments.product_merchant_id	המזהה של חשבון Google Merchant Center שהוא הבעלים הישיר של מודעת השופינג שעליה לחץ המשתמש.
{placement}	ad_group_criterion.placement.url group_placement_view.display_name	האתר שבו בוצע הקליק (לקמפיינים שמטורגטים לפי מילות מפתח) או הקריטריונים שתואמים לטירגוט לפי מיקום המודעה באתר שבו בוצע הקליק על המודעה (לקמפיינים שמטורגטים לפי מיקום מודעה).
{product_channel}	segments.product_channel	סוג ערוץ השופינג שדרכו נמכר המוצר שמוצג במודעת פרטי המוצר שלחצו עליה.
{product_country}	segments.product_country	מדינת המכירה של המוצר שמוצג במודעה שעליה לחץ המשתמש.
{product_id}	segments.product_item_id	מזהה המוצר שמוצג במודעה שעליה לחץ המשתמש, כפי שצוין בפיד הנתונים ב-Merchant Center.
{product_language}	segments.product_language	השפה של פרטי המוצר, כפי שצוין בפיד הנתונים שלכם ב-Merchant Center.
{product_partition_id}	ad_group_criterion.criterion_id	המזהה הייחודי של קבוצת המוצרים שאליה שייכת המודעה למוצר שעליה לחץ המשתמש.
{rate_rule_id}	segments.hotel_rate_rule_id	המזהה של כל מחיר מיוחד שמשתמשים לחצו עליו. מפרסמים בתחום הנסיעות יכולים להגדיר תעריפים בלעדיים למשתמשים מסוג ספציפי (לדוגמה, חברי מועדון), למכשירים מסוימים (לדוגמה, הנחה למשתמשים בניידים) ולמדינות ספציפיות.
{store_code}	segments.product_store_id	בקמפיין שמשתמש בערוץ הקניות המקומי, יוצג המזהה הייחודי של החנות המקומית.
{targetid}	ad_group_criterion.criterion_id segments.keyword.ad_group_criterion segments.webpage	המזהה של מילת המפתח (מסומנת כ-kwd), התאמה לחיפוש בלי מילות מפתח באמצעות AI למיקסום ביצועים (kwl), מודעה דינמית לרשת החיפוש (dsa) או יעד של רשימת רימרקטינג (aud) שהקפיצו מודעה. לדוגמה, אם מוסיפים רשימת רימרקטינג לקבוצת המודעות (מזהה קריטריון "456") ומטרגטים את המזהה של מילת המפתח "123", הפרמטר {targetid} יוחלף בערך "kwd-123:aud-456".
{travel_start_day} {travel_start_month} {travel_start_year}	segments.hotel_check_in_date	תאריך הצ'ק-אין המוצג במודעה (יום/חודש/שנה).

איך הפרמטרים של ValueTrack ממופים בין ממשק המשתמש של Google Ads לבין Google Ads API

בטבלה הזו ממופים הפרמטרים של ValueTrack בין ממשק המשתמש של Google Ads לבין Google Ads API, ובמיוחד לערכי ה-enum של AdNetworkType.

שם ממשק המשתמש	טיפוסים בני מנייה (enum) של API	פרמטר ValueTrack	הערות
רשת המדיה של Google	CONTENT	d	לגבי שותפי וידאו של Google עם הפרמטר ValueTrack vp, הוא מופיע גם בתור CONTENT ב-API.
Google TV	GOOGLE_TV	gtv
ברשת אחרת	MIXED	x	חשוב לזכור שלא תמיד יש פרמטר ValueTrack.
חיפוש Google	SEARCH	g
שותפי חיפוש	SEARCH_PARTNERS	s או a	a מייצג התאמה של AI למיקסום ביצועים, שבדרך כלל משויכת לתנועה ללא מילות מפתח.
לא רלוונטי	UNKNOWN	לא רלוונטי	השגיאה הזו מוחזרת כשערך של רשת בממשק המשתמש של Google Ads לא נתמך בגרסה של Google Ads API ששלחתם אליה שאילתה.
לא רלוונטי	UNSPECIFIED	לא רלוונטי
YouTube	YOUTUBE	ytv
ערוצים בבעלות Google	UNKNOWN		קמפיינים ליצירת ביקוש לא מחזירים פרמטר ValueTrack של רשת.