דוחות

כדי לקבל רשימה של נכסים והמאפיינים שלהם, שולחים שאילתה בשפת השאילתות של Google Ads ‏(GAQL) אל GoogleAdsService. נכסים מיוצגים על ידי הישות asset, שחושפת מספר שדות ספציפיים לנכס.

מאפייני הנכס

השאילתה הבאה ב-GAQL מציגה את כל הנכסים בחשבון Google Ads, יחד עם שם המשאב והסוג שלהם.

SELECT
  asset.id,
  asset.name,
  asset.resource_name,
  asset.type
FROM asset

אתם יכולים להוסיף לשאילתה הזו מאפיינים ספציפיים לסוג מודעה כדי לקרוא מאפיינים ספציפיים לנכסים כמו ImageAsset או YoutubeVideoAsset.

לדוגמה, השאילתה הבאה מציגה את מזהי הסרטונים ב-YouTube של כל האובייקטים מסוג YoutubeVideoAsset בחשבון Google Ads, על ידי סינון הערך asset.type. רשימת הערכים האפשריים של asset.type

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

המאפיין ad_group_ad_asset_view חושף את המאפיין הספציפי לתצוגה performance_label, שמספק תובנות לגבי מאפייני הביצועים של השילוב הספציפי הזה בין נכס למודעה. בטבלה הבאה מפורטים הערכים האפשריים של השדות performance_label.

performance_labelתיאור
BESTהנכסים שמניבים את הביצועים הטובים ביותר.
GOODנכסים עם ביצועים טובים.
LOWהנכסים עם הביצועים הכי גרועים.
LEARNINGהנכס התחיל לקבל חשיפות, אבל הנתונים הסטטיסטיים לא מובהקים סטטיסטית מספיק כדי לקבל תווית לציון רמת הביצועים של הנכס.
PENDINGעדיין אין מידע לגבי הביצועים של הנכס. יכול להיות שהסיבה לכך היא שהסרטון עדיין בבדיקה.
UNKNOWNמייצג ערך לא ידוע בגרסה הזו.
UNSPECIFIEDלא צוין.

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

כדי לראות את המקור של נכסי RSA, משתמשים ב-ad_group_ad_asset_view.source.