جلب سمات ومواد العرض

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

سمات مواد العرض

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