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