דיווח

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

התג 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