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