گزارش ها

شما می‌توانید با ارسال یک کوئری زبان جستجوی گوگل ادز (GAQL) به سرویس گوگل ادز، فهرستی از دارایی‌ها و ویژگی‌های آنها را دریافت کنید. دارایی‌ها توسط موجودیت asset نمایش داده می‌شوند که تعدادی فیلد خاص مربوط به دارایی را در معرض نمایش قرار می‌دهد.

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

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

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

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

برای مثال، کوئری زیر با فیلتر کردن مقدار asset.type ، شناسه‌های ویدیوی یوتیوب را برای همه اشیاء YoutubeVideoAsset در یک حساب کاربری فهرست می‌کند. برای مشاهده لیست مقادیر نوع ممکن برای 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 به performance_label را نمایش می‌دهد که بینشی در مورد ویژگی‌های عملکردی این جفت‌سازی خاص asset-ad ارائه می‌دهد. جدول زیر مقادیر ممکن فیلدهای 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 Assets از AdGroupAdAsset.source استفاده کنید.