با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
میتوانید فهرستی از داراییها و ویژگیهای آنها را با ارسال یک جستار Google Ads Query Language (GAQL) به GoogleAdsService دریافت کنید. دارایی ها توسط نهاد asset نشان داده می شوند که تعدادی از زمینه های خاص دارایی را نشان می دهد.
ویژگی های دارایی
پرس و جوی GAQL زیر همه دارایی های موجود در حساب تبلیغ کننده را همراه با نام و نوع منبع آنها فهرست می کند.
میتوانید ویژگیهای نوع خاص را برای خواندن ویژگیهای خاص داراییهایی مانند ImageAsset یا YoutubeVideoAsset اضافه کنید.
برای مثال، درخواست زیر شناسههای ویدیوی YouTube را برای همه اشیاء YoutubeVideoAsset در یک حساب با فیلتر کردن مقدار asset.type فهرست میکند. فهرستی از مقادیر نوع ممکن) را برای YoutubeVideoAsset ببینید.
با استفاده از این منابع، می توانید معیارهای دارایی را در هر سطح مربوطه جستجو کنید. به عنوان مثال، هنگامی که منبع ad_group_asset را پرس و جو می کنید، می توانید از فیلد ad_group.id برای بخش بندی نتایج استفاده کنید، بنابراین معیارهایی را برای هر ترکیب منحصر به فرد ad_group و asset بازیابی کنید:
معیارهای عملکرد سطح آگهی برای داراییها در ad_group_ad_asset_view جمعآوری میشوند. این نما معیارهایی را برای داراییها در هر آگهی جمعآوری میکند. بنابراین، پرس و جو از این نما یک ردیف به ازای هر گروه تبلیغاتی و تبلیغ را برمی گرداند.
ad_group_ad_asset_view ویژگی view-specific performance_label را نشان می دهد که بینشی در مورد ویژگی های عملکرد این جفت شدن دارایی-تبلیغ خاص ارائه می دهد. جدول زیر مقادیر ممکن فیلدهای performance_label را بر می شمارد.
performance_label
توضیحات
BEST
دارایی با بهترین عملکرد
GOOD
دارایی هایی با عملکرد خوب
LOW
دارایی با بدترین عملکرد
LEARNING
دارایی شروع به دریافت نمایش کرده است، اما آمارها از نظر آماری به اندازه کافی قابل توجه نیستند تا برچسب عملکرد دارایی را دریافت کنند.
PENDING
این دارایی هنوز هیچ اطلاعات عملکردی ندارد. این ممکن است به این دلیل باشد که هنوز در حال بررسی است.
UNKNOWN
نشان دهنده مقدار ناشناخته در این نسخه است.
UNSPECIFIED
مشخص نشده است.
پرس و جوی GAQL زیر، نمایشها، کلیکها، هزینهها و تبدیلها را برای همه داراییهای یک حساب در طول ماه گذشته برمیگرداند که بر اساس performance_label آنها مرتب شدهاند:
تاریخ آخرین بهروزرسانی 2025-09-03 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","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-03 بهوقت ساعت هماهنگ جهانی."],[[["\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)."]]