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.