گزارش‌ها

با ارسال پرس‌وجوی Google Ads Query Language (GAQL) به GoogleAdsService می‌توانید فهرستی از دارایی‌ها و مشخصه‌های آن‌ها را دریافت کنید. دارایی‌ها با نهاد asset نشان داده می‌شوند که تعدادی فیلد مختص دارایی را نمایش می‌دهد.

مشخصه‌های دارایی

پُرسمان GAQL زیر همه دارایی‌ها را در حساب Google Ads به‌همراه نام منبع و نوع آن‌ها فهرست می‌کند.

SELECT
  asset.id,
  asset.name,
  asset.resource_name,
  asset.type
FROM asset

می‌توانید مشخصه‌های نوع خاص را به این پُرسمان اضافه کنید تا دارایی‌های خاص مثل ImageAsset یا YoutubeVideoAsset را بخوانید.

برای مثال، پُرسمان زیر با فیلتر کردن مقدار asset.type، شناسه‌های ویدیو YouTube را برای همه YoutubeVideoAsset شیء در حساب Google Ads فهرست می‌کند. فهرست مقادیر 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 را فهرست می‌کند.

پرس‌وجوی 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 استفاده کنید.