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