يمكنك الحصول على قائمة بمواد العرض وسماتها عن طريق إرسال طلب بحث في "إعلانات Google".
طلب البحث للغة (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
سمة محدّدة لطريقة العرض
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