گزارش‌ها

با ارسال پرسمان Google Ads Query Language (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
• campaign_asset
• customer_asset

با این منابع، می‌توانید سنجه‌های دارایی را در هر سطح مربوطه پرسمان کنید. برای مثال، وقتی منبع 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 فقط برای دارایی‌های تغییرپذیر دقیق است.

برای منبع دارایی‌های «آگهی‌های جستجوی واکنش‌گرا» از ad_group_ad_asset_view.source استفاده کنید.