يمكنك الحصول على قائمة بمواد العرض وسماتها من خلال إرسال طلب بحث بلغة طلبات البحث في "إعلانات 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
مصدر مادة العرض
Asset.source
دقيق فقط لمواد عرض
mutable
.
لمعرفة مصدر استخدام مواد عرض الإعلانات المتجاوبة على شبكة البحث، يُرجى الرجوع إلى
AdGroupAdAsset.source
.