דיווח

אפשר לקבל רשימה של נכסים ואת המאפיינים שלהם על ידי שליחת שאילתה ב-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