معیارهای معیار
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
در Google Ads API، هر گزارش معیار توسط یک منبع جداگانه نشان داده می شود. مگر اینکه در غیر این صورت لازم باشد، منابع *_view فقط حاوی یک قسمت resource_name است.
مشتریان API Google Ads باید فیلدهای ad_group_criterion یا campaign_criterion مربوطه را مشخص کنند، در صورت نیاز به واکشی داده‌های خاصی از معیارها. این به مشتریان API Google Ads اجازه می‌دهد تا فیلدهای ad_group_criterion یا campaign_criterion و منبع *_view را در همان درخواست به روش GoogleAdsService.SearchStream درخواست کنند.
نمونه درخواست پرس و جو
SELECT
ad_group_criterion.keyword.text,
ad_group.name,
campaign.name,
metrics.impressions,
metrics.clicks,
metrics.ctr,
metrics.average_cpc
FROM keyword_view
WHERE segments.date DURING LAST_30_DAYS
برای بازیابی داده های عملکرد (متریک ها) برای یک نوع معیار خاص، منبع مشاهده متناظر آن را در عبارت FROM مشخص کنید. به عنوان مثال، از keyword_view در بند FROM و برخی از فیلدهای metrics در بند SELECT برای بازیابی معیارهای کلمه کلیدی استفاده کنید.
می‌توانید فیلدها را از منابع اصلی تا customer از نمای معیار انتخاب کنید. برای مثال، هنگام انتخاب FROM keyword_view ، می‌توانید فیلدهایی را از همه منابع زیر درخواست کنید:
-
ad_group_criterion -
ad_group -
campaign -
customer
برای کشف منابعی که می توان از این طریق برای یک منبع خاص درخواست کرد، ردیف منابع ویژگی صفحه مرجع آن را بررسی کنید. برای مثال، برای keyword_view ، می‌توانید منابع آن را در صفحه مرجع آن پیدا کنید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-08-26 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-26 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eEach criteria report in the Google Ads API is a separate resource, and clients need to specify \u003ccode\u003ead_group_criterion\u003c/code\u003e or \u003ccode\u003ecampaign_criterion\u003c/code\u003e fields to fetch specific criteria data.\u003c/p\u003e\n"],["\u003cp\u003eTo get performance data for a criteria type, use its corresponding view resource (e.g., \u003ccode\u003ekeyword_view\u003c/code\u003e) in the \u003ccode\u003eFROM\u003c/code\u003e clause of your query.\u003c/p\u003e\n"],["\u003cp\u003eYou can retrieve data from parent resources, like \u003ccode\u003ead_group\u003c/code\u003e, \u003ccode\u003ecampaign\u003c/code\u003e, and \u003ccode\u003ecustomer\u003c/code\u003e, when querying a criteria view.\u003c/p\u003e\n"],["\u003cp\u003eThe "Attribute Resources" section on a resource's reference page shows which related resources can be included in your queries.\u003c/p\u003e\n"]]],[],null,["# Criteria Metrics\n\nIn the Google Ads API, each criteria report is represented by a separate resource.\nUnless otherwise necessary, `*_view` resources contain only a `resource_name`\nfield.\n\nGoogle Ads API clients must specify corresponding `ad_group_criterion` or\n`campaign_criterion` fields if any criteria specific data needs to be fetched.\nThis lets Google Ads API clients request `ad_group_criterion` or `campaign_criterion`\nfields and the `*_view` resource in the same request to the\n[`GoogleAdsService.SearchStream`](/google-ads/api/reference/rpc/v21/GoogleAdsService/SearchStream)\nmethod.\n\nSample query request\n--------------------\n\n SELECT\n ad_group_criterion.keyword.text,\n ad_group.name,\n campaign.name,\n metrics.impressions,\n metrics.clicks,\n metrics.ctr,\n metrics.average_cpc\n FROM keyword_view\n WHERE segments.date DURING LAST_30_DAYS\n\nTo retrieve performance data (metrics) for a specific criteria type, specify its\ncorresponding view resource in the `FROM` clause. For example, use\n`keyword_view` in the `FROM` clause and some `metrics` fields in the `SELECT`\nclause to retrieve keyword metrics.\n\nYou can select fields from parent resources all the way up to `customer` from a\ncriteria view. For example, when selecting `FROM` the `keyword_view`, you can\nrequest fields from all of the following resources:\n\n- `ad_group_criterion`\n- `ad_group`\n- `campaign`\n- `customer`\n\nTo discover the resources that can be requested in this way for a given\nresource, check the **Attribute Resources** row of its reference page. For\nexample, for `keyword_view`, you can find its resources on its [reference\npage](/google-ads/api/fields/v21/keyword_view)."]]
