گزارش ها

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

ویژگی های دارایی

پرس و جوی GAQL زیر همه دارایی های موجود در حساب تبلیغ کننده را همراه با نام و نوع منبع آنها فهرست می کند.

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

می‌توانید ویژگی‌های نوع خاص را برای خواندن ویژگی‌های خاص دارایی‌هایی مانند ImageAsset یا YoutubeVideoAsset اضافه کنید.

برای مثال، درخواست زیر شناسه‌های ویدیوی YouTube را برای همه اشیاء YoutubeVideoAsset در یک حساب با فیلتر کردن مقدار asset.type فهرست می‌کند. فهرستی از مقادیر نوع ممکن) را برای YoutubeVideoAsset ببینید.

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 ویژگی view-specific performance_label را نشان می دهد که بینشی در مورد ویژگی های عملکرد این جفت شدن دارایی-تبلیغ خاص ارائه می دهد. جدول زیر مقادیر ممکن فیلدهای performance_label را بر می شمارد.

performance_label	توضیحات
BEST	دارایی با بهترین عملکرد
GOOD	دارایی هایی با عملکرد خوب
LOW	دارایی با بدترین عملکرد
LEARNING	دارایی شروع به دریافت نمایش کرده است، اما آمارها از نظر آماری به اندازه کافی قابل توجه نیستند تا برچسب عملکرد دارایی را دریافت کنند.
PENDING	این دارایی هنوز هیچ اطلاعات عملکردی ندارد. این ممکن است به این دلیل باشد که هنوز در حال بررسی است.
UNKNOWN	نشان دهنده مقدار ناشناخته در این نسخه است.
UNSPECIFIED	مشخص نشده است.

پرس و جوی GAQL زیر، نمایش‌ها، کلیک‌ها، هزینه‌ها و تبدیل‌ها را برای همه دارایی‌های یک حساب در طول ماه گذشته برمی‌گرداند که بر اساس 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 فقط برای دارایی های mutable دقیق است.

برای منبع دارایی‌های RSA، AdGroupAdAsset.source استفاده کنید.