التقارير

يمكنك الحصول على قائمة بمواد العرض وسماتها عن طريق إرسال طلب بحث بلغة طلبات بحث Google Ads (GAQL) إلى GoogleAdsService. يتم تمثيل مواد العرض من خلال الكيان asset الذي يعرض عددًا من الحقول الخاصة بمواد العرض.

سمات مواد العرض

يعرِض طلب البحث التالي بلغة طلبات بحث Google Ads جميع مواد العرض في حساب أحد المعلِنين، بالإضافة إلى اسم المورد ونوعه.

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
• campaign_asset
• customer_asset

باستخدام هذه الموارد، يمكنك طلب مقاييس مواد العرض على كل مستوى من المستويات المعنيّة. على سبيل المثال، عند طلب مورد 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.

يعرِض طلب البحث التالي بلغة طلبات بحث Google Ads مرّات الظهور والنقرات والتكاليف والإحالات الناجحة لجميع مواد العرض في حساب خلال الشهر الأخير، مرتّبة حسب 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.