يمكنك الحصول على قائمة بمواد العرض والسمات الخاصة بها من خلال إرسال طلب بحث بلغة طلبات البحث في إعلانات Google (GAQL) إلى GoogleAdsService. يتم تمثيل مواد العرض
بواسطة عنصر asset
الذي يعرِض عددًا
من الحقول المتعلّقة بمادة العرض.
سمات مواد العرض
يسرد طلب البحث التالي في "استعلامات لغة تحليل الأداء من Google" كل مواد العرض في حساب المعلِن بالإضافة إلى اسم المورد ونوعه.
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 | غير محدّد |
يعرض طلب البحث التالي في "استعلامات لغة تحليل الأداء من 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
دقيقة إلا لمواد العرض
mutable
.
لمعرفة مصدر مواد عرض الإعلانات المتجاوبة على شبكة البحث،
AdGroupAdAsset.source
.