אפשר לקבל רשימה של נכסים ואת המאפיינים שלהם על ידי שליחת שאילתה ב-Google Ads
שאילתת שפה (GAQL) אל GoogleAdsService. הנכסים
מיוצגים על ידי הישות asset
, שחושפת מספר
בשדות ספציפיים לנכס.
מאפייני הנכס
בשאילתה הבאה של GAQL מפורטים כל הנכסים בחשבון של מפרסם, יחד עם את השם והסוג של המשאב.
SELECT
asset.id,
asset.name,
asset.resource_name,
asset.type
FROM asset
לתשומת ליבכם: יש מאפיינים ספציפיים לסוג מסוים שאפשר להוסיף לערכים שלמעלה
שאילתה לקריאת מאפיינים ספציפיים לנכסים כמו
ImageAsset
או
YoutubeVideoAsset
לדוגמה, השאילתה הבאה מפרטת את מזהי הווידאו ב-YouTube עבור כל
YoutubeVideoAsset
אובייקטים בחשבון מאת
לסנן את הערך asset.type
(עיינו בקטע
תיעוד לרשימה של ערכי סוגים אפשריים) עבור
YoutubeVideoAsset
SELECT
asset.id,
asset.name,
asset.resource_name,
asset.youtube_video_asset.youtube_video_id
FROM asset
WHERE asset.type = 'YOUTUBE_VIDEO'
מדדי הנכס
אפשר לקבל גישה למדדי הנכסים בכמה מקורות מידע:
בעזרת המשאבים האלה, אפשר לשלוח שאילתות לגבי מדדי הנכסים בכל רמה מתאימה.
לדוגמה, כששולחים שאילתה למשאב ad_group_asset
, הפרמטר ad_group.id
אפשר להשתמש בשדה הזה כדי לפלח את התוצאות, וכך לאחזר את המדדים של כל אחד מהם
שילוב ייחודי של ad_group
ו-asset
:
SELECT
ad_group.id,
asset.id,
metrics.clicks,
metrics.impressions
FROM ad_group_asset
WHERE segments.date DURING LAST_MONTH
ORDER BY metrics.impressions DESC
מדדים ברמת המודעה
מדדי הביצועים של הנכסים ברמת המודעה נצברים במסגרת
ad_group_ad_asset_view
התצוגה הזו אוספת
את מדדי הנכסים לכל מודעה בודדת. לכן, שליחת שאילתה על התצוגה הזו מחזירה שורה
קבוצת המודעות והמודעה.
התג ad_group_ad_asset_view
חושף את
מאפיין לתצוגה ספציפית
performance_label
שמספק תובנות לגבי מאפייני הביצועים של המודעה הספציפית הזאת
להתאים בין מכשירים. מתבצעת ספירה של הערכים האפשריים של השדות performance_label
בטבלה הבאה.
performance_label | תיאור |
---|---|
BEST | הנכסים שמניבים את הביצועים הטובים ביותר. |
GOOD | נכסים שמניבים ביצועים טובים. |
LOW | נכסים שמניבים את הביצועים הגרועים ביותר. |
LEARNING | הנכס התחיל לקבל של הופעות, אך הנתונים הסטטיסטיים אינם בעלי מובהקות סטטיסטית מספיק כדי לקבל תווית לביצועי הנכס. |
PENDING | בנכס הזה עדיין אין מידע על ביצועים. יכול להיות שהסיבה לכך היא שהוא עדיין בבדיקה. |
UNKNOWN | מייצג ערך לא ידוע בגרסה הזו. |
UNSPECIFIED | לא צוין. |
השאילתה הבאה של GAQL מחזירה חשיפות, קליקים, עלויות והמרות עבור
כל הנכסים בחשבון במהלך החודש האחרון, ממוינים לפי
performance_label
:
SELECT
ad_group_ad_asset_view.ad_group_ad,
ad_group_ad_asset_view.asset,
ad_group_ad_asset_view.field_type,
ad_group_ad_asset_view.performance_label,
metrics.impressions,
metrics.clicks,
metrics.cost_micros,
metrics.conversions
FROM ad_group_ad_asset_view
WHERE segments.date DURING LAST_MONTH
ORDER BY ad_group_ad_asset_view.performance_label