گزارش نویسی

می‌توانید فهرستی از دارایی‌ها و ویژگی‌های آن‌ها را با ارسال یک جستار 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 ، می‌توان از فیلد 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 ویژگی 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