מעקב אחרי מיקום המודעה והביצועים שלה

‫Google Ads API מציע כמה תצוגות לניתוח המיקומים שבהם המודעות שלכם הופיעו ורמת הביצועים שלהן: managed_placement_view, group_placement_view, detail_placement_view ו- performance_max_placement_view. כל תצוגה מספקת נקודת מבט שונה על נתוני המיקומים. בספר המתכונים לשאילתות יש שאילתות מוכנות להרצה ב-Google Ads Query Language‏ (GAQL) וב-curl, שמשכפלות את מסכי המיקומים בממשק המשתמש של Google Ads.

תצוגת מיקומי מודעות מנוהלים

  • מה מוצג: המשאב managed_placement_view מספק נתוני ביצועים שנצברו לפי קריטריונים חיוביים של מיקומי מודעות שאתם מטרגטים בקבוצות של המודעות. התצוגה הזו כוללת את כל חמשת סוגי הקריטריונים שמנוהלים בקטע תוכן > מיקומים בממשק המשתמש של Google Ads: אתרים, ערוצי YouTube, סרטונים ב-YouTube, אפליקציות לנייד וקטגוריות של אפליקציות לנייד.
  • המקבילה בממשק המשתמש: תוכן > מיקומי מודעות
  • הכלי ליצירת שאילתות: עיון בכלי ליצירת שאילתות

סוגי קריטריונים של מיקומי מודעות מטורגטים

כל שורה במשאב managed_placement_view מאכלסת את השדה AdGroupCriterion שתואם לערך ad_group_criterion.type שלה, ומשאירה את שדות המיקום האחרים לא מוגדרים:

סוג המיקום בממשק המשתמש ערך של ad_group_criterion.type שדות של פרטי הקריטריון הערות
אתרים PLACEMENT ad_group_criterion.placement.url כתובת ה-URL של האתר או הדומיין שאליו רוצים להפנות את המשתמשים.
ערוצי YouTube YOUTUBE_CHANNEL ad_group_criterion.youtube_channel.channel_id מזהה ערוץ YouTube. השדה ad_group_criterion.display_name מחזיר את שם הערוץ.
סרטונים ב-YouTube YOUTUBE_VIDEO ad_group_criterion.youtube_video.video_id מזהה הסרטון ב-YouTube. השדה ad_group_criterion.display_name מחזיר את שם הסרטון.
אפליקציות MOBILE_APPLICATION ad_group_criterion.mobile_application.app_id, ad_group_criterion.mobile_application.name מזהה האפליקציה בפורמט {platform}-{platform_native_id} (1- ל-iOS,‏ 2- ל-Android) ושם האפליקציה.
קטגוריות אפליקציות MOBILE_APP_CATEGORY ad_group_criterion.mobile_app_category.mobile_app_category_constant שם המשאב בפורמט mobileAppCategoryConstants/{mobile_app_category_id}. שמות והיררכיה של קטגוריות אפליקציות לנייד

שאילתה לדוגמה

כדי לאחזר מדדים לבדיקת ביצועים בכל סוגי מיקומי המודעות המטורגטים ב-30 הימים האחרונים, בוחרים את השדה ad_group_criterion.type לצד השדות הספציפיים לסוג:

SELECT
  campaign.id,
  ad_group.id,
  managed_placement_view.resource_name,
  ad_group_criterion.criterion_id,
  ad_group_criterion.type,
  ad_group_criterion.display_name,
  ad_group_criterion.placement.url,
  ad_group_criterion.youtube_channel.channel_id,
  ad_group_criterion.youtube_video.video_id,
  ad_group_criterion.mobile_application.app_id,
  ad_group_criterion.mobile_application.name,
  ad_group_criterion.mobile_app_category.mobile_app_category_constant,
  metrics.impressions,
  metrics.clicks,
  metrics.cost_micros
FROM managed_placement_view
WHERE segments.date DURING LAST_30_DAYS

השמות וההיררכיה של קטגוריות האפליקציות לנייד

בממשק המשתמש של Google Ads, קטגוריות אפליקציות מטורגטות לנייד מוצגות עם הנתיב המלא שלהן בחנות, למשל קטגוריות של אפליקציות > Apple App Store > חינוך. כששולחים שאילתות ל-Google Ads API, חשוב לזכור את ההתנהגויות הבאות:

  • שיוך קבועים של קטגוריות אפליקציות לנייד: המשאב mobile_app_category_constant לא משויך למשאב managed_placement_view. במקום זאת, צריך לבחור את השדה ad_group_criterion.mobile_app_category.mobile_app_category_constant (לדוגמה, mobileAppCategoryConstants/60503), או לשלוח שאילתה למשאב ad_group_criterion כשלא צריך מדדים.
  • שמות מוצגים של קטגוריות עלה בלבד: גם השדה ad_group_criterion.display_name וגם השדה mobile_app_category_constant.name מחזירים רק את שם קטגוריית העלה, כמו "Education" או "Games". אף אחד מהשדות לא כולל את הנתיב הראשי של חנות האפליקציות.
  • פתרון בעיות בנתיב של חנות האפליקציות: ב-Google Play וב-Apple App Store יש שמות זהים לקטגוריות משנה, אבל מזהי קריטריונים שונים. לדוגמה, מזהי הקריטריונים 60005 (/All Apps/Google Play/Education), 60060 (/All Apps/Google Play/Family/Education) ו-60503 (/All Apps/Apple App Store/Education) מחזירים כולם את הערך "Education" בשדות name ו-display_name. מחלצים את הסיומת {mobile_app_category_id} משם המשאב ומחפשים את נתיב ההיררכיה המלא שלו בטבלה או בקובץ ה-CSV של קטגוריות של אפליקציות לנייד.

תצוגת מיקום הקבוצה

  • מה מוצג: המשאב group_placement_view מראה איפה המודעות הוצגו בפועל ברשת המדיה וב-YouTube, בלי קשר לשאלה אם המיקומים האלה נבחרו באופן מפורש או שהמערכת של Google זיהתה אותם באופן אוטומטי. המיקומים יכולים לכלול אתרים, ערוצים או סרטונים ב-YouTube ואפליקציות.
  • המקבילה בממשק המשתמש: תוכן > איפה הוצגו המודעות
  • הכלי ליצירת שאילתות: עיון בכלי ליצירת שאילתות

שאילתה לדוגמה

השאילתה הבאה מאחזרת מדדים לבדיקת ביצועים של דומיינים, אפליקציות לנייד וערוצי YouTube שבהם הוצגו מודעות ב-30 הימים האחרונים:

SELECT
  campaign.id,
  ad_group.id,
  group_placement_view.display_name,
  group_placement_view.target_url,
  group_placement_view.placement_type,
  metrics.impressions,
  metrics.clicks,
  metrics.cost_micros
FROM group_placement_view
WHERE segments.date DURING LAST_30_DAYS

השורה "סה"כ: אחר"

כדי לזרז את יצירת הדוחות, המשאבים group_placement_view ו-detail_placement_view לא כוללים מיקומי מודעות ספציפיים שלא עומדים בסף הפעילות המינימלי של חשיפות או אינטראקציות.

  • בממשק המשתמש של Google Ads: מיקומי מודעות שלא עומדים בסף הפעילות הזה מקובצים בשורת סיכום שנקראת סה"כ: אחר.
  • ב-Google Ads API: ה-API משמיט מתוצאות הדוח מיקומי מודעות שלא עומדים בסף הפעילות, ולא מחזיר שורת סיכום שבה השדה group_placement_view.placement או detail_placement_view.placement מכיל את הערך "Other".

כתוצאה מכך, יכול להיות שסכום השורות של מיקומי המודעות הספציפיים במשאבים group_placement_view ו-detail_placement_view יהיה נמוך יותר מהמדדים הכוללים של קבוצת המודעות או הקמפיין. מידע נוסף זמין במאמר מידע על הדוח "איפה הוצגו המודעות". במאמרים הבדלים במדדים בין תצוגות של מיקומי מודעות ושורות עם פרטים לא זמינים של מיקומי מודעות מוסבר איך ערכי סף ומטא-נתונים חסרים משפיעים על השוואות בין תצוגות.

הגדרות טירגוט לפי מיקום מודעה

ההתנהגות והתועלת של group_placement_view מושפעות מ-TargetingSetting של המאפיין PLACEMENT ברמת קבוצת המודעות. ההגדרה הזו מכילה רשימה של target_restrictions, לכל אחד מהם יש שדה בוליאני bid_only שקובע אם המודעות יוצגו רק במיקומי מודעות מטורגטים או גם במיקומי מודעות אחרים. מידע על ההגדרות "טירגוט" ו "תצפית"

  • bid_only = false: הערך הזה תואם לטירגוט בממשק המשתמש של Google Ads למיקומי מודעות. אם קבוצת המודעות מוגדרת ל"טירגוט", המודעות יוצגו רק במיקומים שהוספתם באופן מפורש כקריטריונים. אתם יכולים להחיל התאמות של הצעות מחיר על המיקומים האלה. במקרה כזה, group_placement_view משקף במידה רבה את managed_placement_view, אבל עדיין כפוף לספי פעילות מינימליים.
  • bid_only = true: הערך הזה תואם לתצפית בממשק המשתמש של Google Ads למיקומים. אם קבוצת המודעות מוגדרת ל "תצפית", המודעות יכולות להופיע בכל מיקום כשיר ברשת המדיה וב-YouTube. אפשר גם להחיל התאמות של הצעות מחיר על כל מיקום מודעה שמטרגטים. במקרה כזה, group_placement_view הוא כלי חיוני לגילוי מיקומים חדשים שבהם המודעות שלכם מוצגות, ואז תוכלו לבחור אם להוסיף אותם כמיקומי מודעות מנוהלים או כהחרגות.

תצוגת מיקום מפורטת

  • מה מוצג: המשאב detail_placement_view מספק פירוט ברמה גבוהה יותר של מיקומי המודעות, מעבר לרמת הדומיין או הערוץ. לדוגמה, אפשר לראות כתובות URL ספציפיות או מזהי סרטונים ב-YouTube שבהם המודעות הופיעו.
  • המקבילה בממשק המשתמש: בחירת שורות בקטע תוכן > איפה הוצגו המודעות, ואז לחיצה על הצגת פרטים.
  • הכלי ליצירת שאילתות: עיון בכלי ליצירת שאילתות
  • שיקולים חשובים: בדומה למשאב group_placement_view, התצוגה הזו משמיטה מיקומי מודעות עם פעילות נמוכה שלא עומדים בסף הפעילות המינימלי (ראו את הקטע השורה "סה"כ: אחר").

שאילתה לדוגמה

כדי להגביל את נפח התוצאות, השאילתה הבאה מאחזרת מדדי מיקום מודעה ברמת כתובת ה-URL וברמת הסרטון בחלון של 7 ימים. בחשבונות גדולים, אפשר לסנן עוד יותר לפי השדה campaign.id או ad_group.id:

SELECT
  campaign.id,
  ad_group.id,
  detail_placement_view.display_name,
  detail_placement_view.target_url,
  detail_placement_view.group_placement_target_url,
  detail_placement_view.placement_type,
  metrics.impressions,
  metrics.clicks,
  metrics.cost_micros
FROM detail_placement_view
WHERE segments.date DURING LAST_7_DAYS

כדי להחריג שורות שבהן המטא-נתונים של מיקום המודעה לא זמינים, מוסיפים את AND detail_placement_view.target_url IS NOT NULL (ראו שורות עם פרטים לא זמינים של מיקום המודעה). כשלא צריך את השדות המוחזרים של resource_name, מוסיפים את הסעיף PARAMETERS omit_unselected_resource_names = true.

הבדלים במדדים בין תצוגות של מיקומי מודעות

סף הפעילות המינימלי נבדק בנפרד בכל רמה של פירוט:

  • המשאב group_placement_view מעריך את הסף בדומיין, באפליקציה לנייד או בערוץ YouTube המצטברים.
  • המשאב detail_placement_view מעריך את הסף בנפרד לכל כתובת URL של דף או סרטון ב-YouTube.

המשאב detail_placement_view משמיט כתובות URL של דפים ספציפיים או סרטונים ב-YouTube שלא עומדים בסף. לכן, אם מסכמים את השורות של detail_placement_view לדומיין או לערוץ YouTube (מסוננות לפי השדה detail_placement_view.group_placement_target_url), יכול להיות שיתקבלו פחות חשיפות מאשר בשורה התואמת של group_placement_view.

שורות עם פרטי מיקום מודעה לא זמינים

שאילתה במשאב group_placement_view או detail_placement_view יכולה להחזיר כמה שורות באותה קבוצת מודעות עם שדות placement,‏ display_name ו-target_url לא מוגדרים וערך resource_name זהה (לדוגמה, שמסתיים ב-~MTRf).

ההתנהגות הזו מתרחשת מהסיבות הבאות:

  • קיבוץ לפי מיקום פנימי: בשתי התצוגות, מדדי הביצועים מקובצים לפי מזהה מיקום פנימי ייחודי, ולא לפי שדות המחרוזת resource_name או placement.
  • מטא-נתונים לא זמינים של מיקומי מודעות: בממשק המשתמש של Google Ads, מיקומי מודעות בלי מטא-נתונים בטבלאות החיפוש בקצה העורפי מופיעים בתור לא ידוע, הערוץ כבר לא זמין או הסרטון כבר לא זמין. ב-API, כל מזהה מיקום מודעה נפרד עדיין מחזיר שורת מדדים, כשהשדות placement,‏ display_name ו-target_url לא מוגדרים.
  • שמות משאבים מסונתזים: הסיומת {base64_placement} בשדה resource_name מקודדת ב-Base64 מ-{type_id}_{placement}, כאשר {type_id} הוא מזהה פנימי של סוג מיקום ולא מספר ה-enum של PlacementType. כשהשדה placement_type הוא WEBSITE (מזהה פנימי 14) והשדה placement לא מוגדר, המחרוזת "14_" מקודדת ל-MTRf (באופן דומה, MOBILE_APPLICATION מקודד את "55_" ל-NTVf, YOUTUBE_VIDEO מקודד את "89_" ל-ODlf ו-YOUTUBE_CHANNEL מקודד את "90_" ל-OTBf). לכן, כמה מיקומים מאותו סוג עם מטא-נתונים לא זמינים באותה קבוצת מודעות חולקים את אותו ערך resource_name, אבל מדווחים על שורות מדדים נפרדות.

כשמעבדים תוצאות של group_placement_view או detail_placement_view בקוד הלקוח, אל תסירו כפילויות של שורות רק לפי השדה resource_name, כי פעולה כזו יכולה להחליף מדדים במיקומים שונים עם מטא-נתונים לא זמינים. כדי להחריג שורות עם מטא-נתונים לא זמינים ב-GAQL, צריך לסנן לפי השדה target_url או display_name, כי אי אפשר לסנן לפי השדות placement ו-resource_name. לדוגמה, WHERE group_placement_view.target_url IS NOT NULL או WHERE detail_placement_view.target_url IS NOT NULL.

תצוגת מיקומי מודעות בקמפיינים למיקסום הביצועים

  • מה מוצג: המשאב performance_max_placement_view מספק נתוני חשיפות (metrics.impressions) לגבי מיקומי מודעות שבהם הוצגו מודעות בקמפיינים למיקסום הביצועים. בגרסה 24 ואילך, אפשר לפלח את performance_max_placement_view לפי segments.ad_network_type (לא נתמך בגרסה 23).
  • המקבילה בממשק המשתמש: תובנות ודוחות > כלי הדוחות > מיקומי מודעות בקמפיינים למיקסום הביצועים
  • הכלי ליצירת שאילתות: עיון בכלי ליצירת שאילתות

שאילתה לדוגמה

השאילתה הבאה מאחזרת חשיפות של מיקומי מודעות מפולחות לפי סוג רשת המודעות בקמפיינים למיקסום הביצועים ב-30 הימים האחרונים:

SELECT
  campaign.id,
  performance_max_placement_view.display_name,
  performance_max_placement_view.target_url,
  performance_max_placement_view.placement_type,
  segments.ad_network_type,
  metrics.impressions
FROM performance_max_placement_view
WHERE segments.date DURING LAST_30_DAYS

בחירת תצוגת מיקום מודעה

  • אפשר להשתמש בmanaged_placement_view כדי להעריך את הביצועים של מיקומי המודעות שאתם מטרגטים באופן פעיל ומגישים עליהם הצעות מחיר.
  • כדאי להשתמש בgroup_placement_view כדי להבין את ההיקף המלא של המקומות שבהם המודעות שלכם מוצגות, במיוחד כשמשתמשים בהגדרה "תצפית", כדי לגלות הזדמנויות חדשות לטירגוט או להחרגות.
  • השתמשו ב-detail_placement_view כדי לקבל את הפרטים הכי מפורטים על כתובות URL או סרטונים ספציפיים שבהם המודעות שלכם הוצגו. בדרך כלל משתמשים בזה אחרי שמזהים דומיין או ערוץ שמעניין אתכם ב-group_placement_view.
  • כדי לבדוק את החשיפות של מיקומי המודעות בקמפיינים למיקסום הביצועים, משתמשים ב-performance_max_placement_view.