میتوانید فهرستی از داراییها و ویژگیهای آنها را با ارسال یک جستار 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
منبع دارایی
Asset.source
فقط برای دارایی های mutable
دقیق است.
برای منبع داراییهای RSA، AdGroupAdAsset.source
استفاده کنید.