إعداد التقارير

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