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