דוחות

כדי לקבל רשימה של נכסים ומאפיינים שלהם, אפשר לשלוח שאילתת Google Ads Query Language (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

מקור הנכס הדיגיטלי

הערך Asset.source מדויק רק לגבי נכסים מסוג mutable.

למקור השימוש בנכסי RSA, AdGroupAdAsset.source.