يمكنك الحصول على قائمة بمواد العرض وسماتها من خلال إرسال طلب بحث بلغة طلب البحث في "إعلانات Google" إلى GoogleAdsService. يتم تمثيل مواد العرض بواسطة الكيان asset الذي يعرض عددًا من الحقول الخاصة بمواد العرض.
سمات مواد العرض
تعرض طلب بحث GAQL التالي جميع مواد العرض في حساب على "إعلانات Google" مع اسم المورد ونوعه.
SELECT
asset.id,
asset.name,
asset.resource_name,
asset.type
FROM asset
يمكنك إضافة سمات خاصة بالنوع إلى طلب البحث هذا لقراءة السمات الخاصة بمواد العرض، مثل ImageAsset أو YoutubeVideoAsset.
على سبيل المثال، يعرض طلب البحث التالي معرّفات فيديوهات YouTube لجميع عناصر YoutubeVideoAsset في حساب على "إعلانات Google" من خلال فلترة قيمة asset.type. اطّلِع على قائمة بالقيم المحتملة asset.type.
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. تجمع طريقة العرض هذه مقاييس مواد العرض لكل إعلان فردي. وبالتالي، يؤدي طلب البحث في هذا العرض إلى عرض صف واحد لكل مجموعة إعلانية وإعلان.
تعرض السمة ad_group_ad_asset_view
الخاصة بالعرض
performance_label التي
تقدّم إحصاءات حول خصائص الأداء الخاصة بهذا الاقتران المحدّد بين مادة العرض والإعلان. يسرد الجدول التالي القيم المحتملة لحقول performance_label.
performance_label | الوصف |
|---|---|
BEST | مواد العرض الأفضل أداءً |
GOOD | مواد العرض التي تحقّق أداءً جيدًا |
LOW | مواد العرض الأسوأ أداءً |
LEARNING | بدأت مادة العرض في تلقّي مرّات ظهور، ولكن الإحصاءات ليست ذات دلالة إحصائية كافية للحصول على تصنيف أداء لمادة العرض. |
PENDING | لا تتوفّر أي معلومات أداء لمادة العرض هذه حتى الآن. قد يرجع ذلك إلى أنّ الطلب لا يزال قيد المراجعة. |
UNKNOWN | تمثّل قيمة غير معروفة في هذا الإصدار. |
UNSPECIFIED | لم يتم تحديد أي قيمة. |
يعرض طلب بحث GAQL التالي مرّات الظهور والنقرات والتكاليف والإحالات الناجحة لجميع مواد العرض في حساب على "إعلانات Google" خلال الشهر الماضي، مرتّبة حسب 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 دقيق فقط لمواد العرض القابلة للتغيير.
بالنسبة إلى مصدر مواد عرض "الإعلانات المتجاوبة على شبكة البحث"، استخدِم
ad_group_ad_asset_view.source.