דיווח

כדי לקבל רשימה של נכסים ואת המאפיינים שלהם, אפשר לשלוח שאילתה בשפת שאילתה (GAQL) של Google Ads אל Google AdsService. הנכסים מיוצגים על ידי הישות 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