כדי לקבל רשימה של נכסים ומאפיינים שלהם, אפשר לשלוח שאילתת Google Ads Query Language (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
, אפשר להשתמש בשדה 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
.
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
מקור הנכס הדיגיטלי
הערך Asset.source
מדויק רק לגבי נכסים מסוג mutable
.
למקור השימוש בנכסי RSA,
AdGroupAdAsset.source
.