מיפוי פרמטרים של 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} ממופים לשילוב של:

אין שדה שממופה למיקום המודעה, כמו 'למעלה' או 'לצד'.

המיקום בדף שבו המודעה שלכם הופיעה, עם ערך כמו '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} feed_item.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} כתובת ה-URL הסופית. המערכת תוסיף לכתובת הזאת תווי escape אם לא תוסיפו את הפרמטר {lpurl} בתחילת תבנית המעקב. אם הפרמטר {lpurl} לא מופיע בתחילת תבנית המעקב, המערכת תסמן בתו בריחה (escape) את התווים הבאים: ?,‏ =,‏ ",‏ #,‏ \t,‏ ' ו-[space].
{matchtype} סוג ההתאמה של מילת המפתח שהפעילה את המודעה. (מידע נוסף על סוגי התאמה)
{merchant_id} segments.product_merchant_id המזהה של חשבון Google Merchant Center שהוא הבעלים הישיר של מודעת השופינג שעליה לחץ המשתמש.
{placement} האתר שבו בוצע הקליק (בקמפיינים שמטורגטים לפי מילות מפתח) או הקריטריונים שתואמים לטירגוט לפי מיקום המודעה באתר שבו בוצע הקליק על המודעה (בקמפיינים שמטורגטים לפי מיקום מודעה).
{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} המזהה של מילת המפתח (מסומנת כ-kwd), יעד של מודעת חיפוש דינמית (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 API לבין Google Ads API, במיוחד לערכים של AdNetworkType.

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