דוחות

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

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

השאילתה הבאה ב-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.