מיפוי פרמטרים של 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 הסופית. המערכת תוסיף לכתובת הזאת תווי escape אם לא תוסיפו את הפרמטר {lpurl} בתחילת תבנית המעקב. אם הפרמטר {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 של רשת.