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