على سبيل المثال، يعرض طلب البحث التالي معرّفات فيديوهات YouTube لجميع عناصر YoutubeVideoAsset في حساب من خلال فلترة قيمة asset.type. اطّلِع على قائمة
بقيم الأنواع المحتملة) للسمة YoutubeVideoAsset.
باستخدام هذه المراجع، يمكنك طلب مقاييس مواد العرض على كل مستوى من المستويات المعنية.
على سبيل المثال، عند طلب البحث عن مورد ad_group_asset، يمكنك استخدام الحقل ad_group.id لتقسيم النتائج، وبالتالي استرداد المقاييس لكل مجموعة فريدة من ad_group وasset:
يتم تجميع مقاييس الأداء على مستوى الإعلان لمواد العرض في
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:
تاريخ التعديل الأخير: 2025-09-05 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-09-05 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eRetrieve a list of assets and their attributes, including type-specific properties, using GAQL queries to the GoogleAdsService.\u003c/p\u003e\n"],["\u003cp\u003eAccess asset metrics at the ad group, campaign, and customer levels through their respective resources to analyze performance.\u003c/p\u003e\n"],["\u003cp\u003eUtilize the \u003ccode\u003ead_group_ad_asset_view\u003c/code\u003e to gain insights into ad-level performance metrics specifically for App ads assets, including a performance label.\u003c/p\u003e\n"],["\u003cp\u003eDetermine the source of mutable assets with \u003ccode\u003eAsset.source\u003c/code\u003e and the source of RSA assets with \u003ccode\u003eAdGroupAdAsset.source\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Reports\n\nYou can get a list of assets and their attributes by sending a [Google Ads Query\nLanguage (GAQL) query](/google-ads/api/docs/query/overview) to the GoogleAdsService. Assets\nare represented by the [`asset`](/google-ads/api/fields/v21/asset) entity, which exposes a number\nof asset-specific fields.\n\nAsset attributes\n----------------\n\nThe following GAQL query lists all assets in an advertiser's account along with\ntheir resource name and type. \n\n SELECT\n asset.id,\n asset.name,\n asset.resource_name,\n asset.type\n FROM asset\n\nYou can add type-specific attributes this query to read properties specific to\nassets such as [`ImageAsset`](/google-ads/api/reference/rpc/v21/ImageAsset) or\n[`YoutubeVideoAsset`](/google-ads/api/reference/rpc/v21/YoutubeVideoAsset).\n\nFor example, the following query lists the YouTube video IDs for all\n[`YoutubeVideoAsset`](/google-ads/api/reference/rpc/v21/YoutubeVideoAsset) objects in an account by\nfiltering the [`asset.type`](/google-ads/api/fields/v21/asset#asset.type) value. See a list of\npossible type values) for [`YoutubeVideoAsset`](/google-ads/api/reference/rpc/v21/YoutubeVideoAsset). \n\n SELECT\n asset.id,\n asset.name,\n asset.resource_name,\n asset.youtube_video_asset.youtube_video_id\n FROM asset\n WHERE asset.type = 'YOUTUBE_VIDEO'\n\nAsset metrics\n-------------\n\nAsset metrics are made available through a few resources:\n\n- [`ad_group_asset`](/google-ads/api/fields/v21/ad_group_asset)\n- [`campaign_asset`](/google-ads/api/fields/v21/campaign_asset)\n- [`customer_asset`](/google-ads/api/fields/v21/customer_asset)\n\nWith these resources, you can query asset metrics at each respective level.\nFor example, when you query the `ad_group_asset` resource, you can use the\n`ad_group.id` field to segment the results, thereby retrieving metrics for each\nunique combination of `ad_group` and `asset`: \n\n SELECT\n ad_group.id,\n asset.id,\n metrics.clicks,\n metrics.impressions\n FROM ad_group_asset\n WHERE segments.date DURING LAST_MONTH\n ORDER BY metrics.impressions DESC\n\nAd-level metrics\n----------------\n\n| **Key Point:** The [`ad_group_ad_asset_view`](/google-ads/api/fields/v21/ad_group_ad_asset_view) only returns information for assets that are related to App ads.\n\nAd-level performance metrics for assets are aggregated in the\n[`ad_group_ad_asset_view`](/google-ads/api/fields/v21/ad_group_ad_asset_view). This view collects\nmetrics for assets per individual ad. Thus, querying this view returns one row\nper ad group and ad.\n\nThe [`ad_group_ad_asset_view`](/google-ads/api/fields/v21/ad_group_ad_asset_view) exposes the\nview-specific attribute\n[`performance_label`](/google-ads/api/reference/rpc/v21/AdGroupAdAssetView#performance_label) that\ngives insight into the performance characteristics of this specific asset-ad\npairing. The following table enumerates the possible values of the\n`performance_label` fields.\n\n| `performance_label` | Description |\n|---------------------|-------------------------------------------------------------------------------------------------------------------------------------|\n| `BEST` | Best performing assets. |\n| `GOOD` | Good performing assets. |\n| `LOW` | Worst performing assets. |\n| `LEARNING` | The asset has started getting impressions but the stats are not statistically significant enough to get an asset performance label. |\n| `PENDING` | This asset doesn't yet have any performance information. This may be because it is still under review. |\n| `UNKNOWN` | Represents value unknown in this version. |\n| `UNSPECIFIED` | Not specified. |\n\nThe following GAQL query returns impressions, clicks, costs, and conversions for\nall assets in an account during the last month, sorted by their\n`performance_label`: \n\n SELECT\n ad_group_ad_asset_view.ad_group_ad,\n ad_group_ad_asset_view.asset,\n ad_group_ad_asset_view.field_type,\n ad_group_ad_asset_view.performance_label,\n metrics.impressions,\n metrics.clicks,\n metrics.cost_micros,\n metrics.conversions\n FROM ad_group_ad_asset_view\n WHERE segments.date DURING LAST_MONTH\n ORDER BY ad_group_ad_asset_view.performance_label\n\nAsset Source\n------------\n\n[`Asset.source`](/google-ads/api/reference/rpc/v21/AssetSourceEnum.AssetSource) is only accurate for\n[`mutable`](/google-ads/api/docs/assets/overview#asset_types_linked_to_customers_campaigns_and_ad_groups)\nAssets.\n\nFor the source of RSA Assets use,\n[`AdGroupAdAsset.source`](/google-ads/api/fields/v21/ad_group_ad_asset_view#ad_group_ad_asset_view.source)."]]