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