إعداد التقارير

كما هو الحال مع أنواع الإعلانات الأخرى، يمكنك استخدام GoogleAdsService.SearchStream لاسترداد حالة المنتج وبيانات الأداء لمنتجات Shopping.

تتوفّر التقارير المخصّصة التالية للحملات التي تدعم المنتجات:

عرض أداء التسوّق

توفّر طريقة عرض أداء Shopping إحصاءات مجمّعة عن التقارير السابقة للمنتجات حسب سمات مثل product_item_id.

تعرِض بطاقة "الأداء في Shopping" حالة المنتج في وقت تسجيل المقاييس ذات الصلة. ويشمل ذلك شرائح مثل product_title، والتي ربما تغيّرت منذ تسجيل المقياس.

في ما يلي مثال لطلب البحث الذي يسترد مرات الظهور والنقرات والتكلفة والإحالات الناجحة وكل الإحالات الناجحة للمنتجات حسب product_item_id مع عدد النقرات في آخر 30 يومًا (مرتبة بترتيب تنازلي حسب كل الإحالات الناجحة، ثم الإحالات الناجحة، ثم النقرات، ثم التكلفة، ثم مرّات الظهور):

SELECT
  segments.product_item_id,
  metrics.clicks,
  metrics.cost_micros,
  metrics.impressions,
  metrics.conversions,
  metrics.all_conversions
FROM  shopping_performance_view
WHERE segments.date DURING LAST_30_DAYS
  AND metrics.clicks > 0
ORDER BY
  metrics.all_conversions DESC,
  metrics.conversions DESC,
  metrics.clicks DESC,
  metrics.cost_micros DESC,
  metrics.impressions DESC

عرض مجموعة المنتجات

توفّر طريقة عرض مجموعة المنتجات إحصاءات إعداد تقارير مجمّعة لمجموعات بيانات Shopping (يُشار إليها باسم مجموعات المنتجات في واجهة المستخدم). اطّلِع على دليل إعداد تقارير "حملات الأداء الأفضل" للاطّلاع على أمثلة حول طريقة عرض مجموعة المنتجات ضمن مجموعة مواد العرض.

في ما يلي مثال لطلب بحث يسترد مرّات الظهور والنقرات والإحالات الناجحة وجميع الإحالات الناجحة لمجموعات بيانات Shopping حسب الحملة حسب مرّات الظهور في آخر 30 يومًا (مرتبة بترتيب تنازلي حسب كل الإحالات الناجحة، ثم الإحالات الناجحة، ثم النقرات، ثم مرّات الظهور):

SELECT
  campaign.name,
  metrics.impressions,
  metrics.clicks,
  metrics.conversions,
  metrics.all_conversions
FROM product_group_view
WHERE segments.date DURING LAST_30_DAYS
  AND metrics.impressions > 0
ORDER BY
  metrics.all_conversions DESC,
  metrics.conversions DESC,
  metrics.clicks DESC,
  metrics.impressions DESC

منتج التسوّق

يقدّم تقرير منتج Shopping السمات وإحصاءات التقارير للمنتجات الموجودة في حسابات Google Merchant Center المرتبطة بحساب "إعلانات Google". يمكن استخدام هذا التقرير لفحص الإحصاءات على مستوى العميل والحملة والمجموعة الإعلانية.

في ما يلي مثال لطلب بحث يسترد مرّات الظهور والنقرات والإحالات الناجحة وجميع الإحالات الناجحة في آخر 30 يومًا (مرتبة تنازليًا حسب كل الإحالات الناجحة، ثم الإحالات الناجحة، ثم النقرات، ثم مرّات الظهور) لجميع منتجات Shopping من جميع حسابات Google Merchant Center المرتبطة:

SELECT
  shopping_product.resource_name,
  shopping_product.item_id,
  shopping_product.feed_label,
  shopping_product.merchant_center_id,
  metrics.clicks,
  metrics.impressions,
  metrics.conversions,
  metrics.all_conversions
FROM shopping_product
WHERE segments.date DURING LAST_30_DAYS
ORDER BY
  metrics.all_conversions DESC,
  metrics.conversions DESC,
  metrics.clicks DESC,
  metrics.impressions DESC

اطّلِع على دليل إعداد التقارير لمزيد من التفاصيل حول طلبات البحث.

اعتبارات الأداء

يمكن أن يعرض تقرير منتجات Shopping كمية كبيرة من البيانات عندما يكون الحساب مرتبطًا بعدد كبير من المنتجات. يمكن أن تساعد التوصيات التالية في تحسين أداء استعلامات GAQL الخاصة بك:

  • تكون عادةً طلبات البحث على مستوى الحملة والمجموعة الإعلانية أسرع من تلك على مستوى الحساب، لأنّه من المرجّح أن تحتوي على عدد أقل من المنتجات وتتطلّب الوصول إلى بيانات أقل.
  • كلما زاد عدد الحقول والمقاييس في عبارة SELECT، كان وقت الاستجابة أبطأ. ننصح بتحديد الحقول والمقاييس التي تطلبها فقط في طلب البحث.
  • تذكَّر أنّ المنتجات التي تتضمّن مشكلة واحدة أو أكثر ستعرض المزيد من البيانات. يمكنك الفلترة حسب shopping_product.status في WHERE لمعرفة المنتجات التي من المرجّح أن تؤدي إلى مشاكل مرتبطة بالحالة ذات الصلة.

حالات استخدام تقارير منتجات Shopping

يوفر تقرير منتج Shopping إمكانية الوصول المرن إلى معلومات المنتج للحملات التي تستخدم خلاصات المنتجات. ويمكن أن يقدّم لك هذا التقرير إحصاءات عن حالة المنتجات من حسابات Google Merchant Center، كما يقدّم لك معلومات محدّدة عن الإعلانات، مثل مقاييس الأداء والمشاكل التي تمنع المنتجات من عرض الإعلانات.

يتناول هذا القسم بعض حالات الاستخدام النموذجية المشابهة لتلك المحتملة في عرض "المنتجات" ضمن واجهة مستخدم "إعلانات Google".

يتشابه حقل "المشاكل" في منتج Shopping مع الحقل الذي قدّمته في productstatuses في Content API for Shopping، بالإضافة إلى إضافة المشاكل المتعلقة بـ "إعلانات Google". للتحقّق ممّا إذا كانت المشكلة بحاجة إلى حلّ في Google Merchant Center أو "إعلانات Google"، راجِع أولاً الحقل shopping_product.issues.documentation في الردّ، والذي يتضمّن مقالة في مركز المساعدة للمساعدة.

حالات المنتجات (على مستوى الحساب)

سيؤدي تحديد التقرير بدون فلاتر للحملة أو المجموعة الإعلانية إلى عرض جميع المنتجات على مستوى الحساب.

وهي تتوافق مع المقاييس والحالة والمشاكل من جميع الحملات في الحساب من النوع:

  • Shopping
  • حملات الأداء الأفضل

يتيح لك طلب البحث هذا الاطّلاع على حالة المنتج، على سبيل المثال NOT_ELIGIBLE، وقائمة بالمشاكل المتعلقة بالمنتج والتي نتج عنها الحالة المحدّدة:

SELECT
  shopping_product.resource_name,
  shopping_product.merchant_center_id,
  shopping_product.channel,
  shopping_product.language_code,
  shopping_product.feed_label,
  shopping_product.item_id,
  shopping_product.status,
  shopping_product.issues
FROM shopping_product

حالات المنتجات (على مستوى الحملة)

سيؤدي تحديد التقرير مع مورد الحملة كجزء من عبارة WHERE إلى عرض جميع المنتجات المضمنة في الحملة المحددة.

يتوافق مع أنواع الحملات التالية التي يمكنها استخدام خلاصات المنتجات:

  • Shopping
  • حملات الأداء الأفضل
  • الحملات لزيادة الطلب
  • فيديو

يتيح لك طلب البحث هذا الاطّلاع على حالة المنتج المضمّن في حملة معيّنة. وهو يتيح لك التحقق من حالة كل منتج بما في ذلك المشكلات التي تسبب الحالة. على سبيل المثال، ستؤثّر الحملة المتوقفة مؤقتًا في حالة المنتج:

SELECT
  shopping_product.resource_name,
  shopping_product.campaign,
  campaign.name,
  shopping_product.merchant_center_id,
  shopping_product.channel,
  shopping_product.language_code,
  shopping_product.feed_label,
  shopping_product.item_id,
  shopping_product.status,
  shopping_product.issues
FROM shopping_product
WHERE
  shopping_product.campaign = "customers/<CUSTOMER_ID>/campaigns/<CAMPAIGN_ID>"

حالات المنتجات (على مستوى المجموعة الإعلانية)

سيؤدي تحديد التقرير باستخدام كلاً من مورد المجموعة الإعلانية ومورد الحملة وكجزء من عبارة WHERE إلى عرض جميع المنتجات التي تضمّنت الحملة المختارة. وستوضّح المقاييس والحالة والمشاكل المتعلقة بالمنتج ما إذا كان مضمّنًا أو مستبعَدًا من المجموعة الإعلانية المختارة.

يتيح لك طلب البحث هذا إمكانية الاطّلاع على حالة المنتج بالنسبة إلى تلك المجموعة الإعلانية. وتسمح لك هذه الميزة بالتأكّد من تطبيق فلاتر مجموعات المنتجات (على مستوى المجموعة الإعلانية) بشكلٍ صحيح والتحقّق من حالة كل منتج:

SELECT
  shopping_product.resource_name,
  shopping_product.campaign,
  campaign.name,
  shopping_product.ad_group,
  ad_group.name,
  shopping_product.merchant_center_id,
  shopping_product.channel,
  shopping_product.language_code,
  shopping_product.feed_label,
  shopping_product.item_id,
  shopping_product.status,
  shopping_product.issues
FROM shopping_product
WHERE
  shopping_product.campaign = "customers/<CUSTOMER_ID>/campaigns/<CAMPAIGN_ID>"
  AND shopping_product.ad_group = "customers/<CUSTOMER_ID>/adGroups/<AD_GROUP_ID>"

مقاييس المنتجات، تمّت فلترتها حسب التاريخ (على مستوى الحساب)

سيؤدي تحديد التقرير باستخدام تاريخ أو نطاق زمني في عبارة WHERE إلى عرض مقاييس لجميع المنتجات على مستوى الحساب (بغض النظر عمّا إذا كانت المقاييس غير صفرية) للفترة الزمنية المحدّدة.

لا يمكنك اختيار segments.date، لأنّ ذلك سيؤدي إلى خطأ UNSUPPORTED_DATE_SEGMENTATION.

يتيح لك طلب البحث هذا الاطّلاع على أداء المنتج الحالي في يوم معيّن أو قيمة تاريخ أخرى متوافقة. يمكن استخدام هذا لإنشاء ملخص لكل منتج تم إرجاعه بشكل مجمّع عبر جميع الحملات:

SELECT
  shopping_product.resource_name,
  shopping_product.merchant_center_id,
  shopping_product.channel,
  shopping_product.language_code,
  shopping_product.feed_label,
  shopping_product.item_id,
  metrics.clicks,
  metrics.impressions,
  metrics.cost_micros
FROM shopping_product
WHERE
  segments.date = '2024-01-01'

أداء المنتج استنادًا إلى بيانات سلة التسوّق

يمكن للمعلنين في مجال البيع بالتجزئة الوصول إلى مقاييس المبيعات والأرباح ذات الصلة، مثل الأرباح وإجمالي الربح وهامش إجمالي الربح والوحدات المباعة. تتوفّر هذه المقاييس لجميع المعلِنين الذين ينفِّذون الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق في جميع "حملات Shopping"، وتكون متوافقة مع التقارير التالية.

يمكن استخدام المقاييس التالية لبيانات سلة التسوّق في التقارير، مثل shopping_performance_view، لحملات Shopping.

metrics.average_cart_size
metrics.average_order_value_micros
metrics.cost_of_goods_sold_micros
metrics.cross_sell_cost_of_goods_sold_micros
metrics.cross_sell_gross_profit_micros
metrics.cross_sell_revenue_micros
metrics.cross_sell_units_sold
metrics.gross_profit_margin
metrics.gross_profit_micros
metrics.lead_cost_of_goods_sold_micros
metrics.lead_gross_profit_micros
metrics.lead_revenue_micros
metrics.lead_units_sold
metrics.orders
metrics.revenue_micros
metrics.units_sold

يوضّح المثال التالي كيفية استخدام مقاييس بيانات سلة التسوّق لتحليل الأداء على مستوى المنتج في "حملات Shopping" في آخر 30 يومًا.

SELECT
  segments.product_item_id,
  segments.product_title,
  metrics.average_cart_size,
  metrics.average_order_value_micros,
  metrics.conversions,
  metrics.conversions_value,
  metrics.gross_profit_micros,
  metrics.gross_profit_margin,
  metrics.revenue_micros,
  metrics.units_sold,
  campaign.advertising_channel_type
FROM shopping_performance_view
WHERE campaign.advertising_channel_type = 'SHOPPING'
  AND segments.date DURING LAST_30_DAYS
  AND metrics.conversions > 0
ORDER BY
  metrics.gross_profit_margin DESC,
  metrics.revenue_micros DESC,
  metrics.conversions_value DESC

أداء الحملة استنادًا إلى بيانات سلة التسوّق

يمكن استخدام مقاييس بيانات سلة التسوّق على مستوى الحملة، ويمكن دمجها مع مقاييس الأداء الأخرى، مثل مرّات الظهور والنقرات والتكلفة.

SELECT
  campaign.id,
  campaign.name,
  campaign.advertising_channel_type,
  metrics.impressions,
  metrics.clicks,
  metrics.conversions,
  metrics.cost_micros,
  metrics.average_order_value_micros,
  metrics.gross_profit_micros,
  metrics.gross_profit_margin
FROM campaign
WHERE campaign.advertising_channel_type = 'SHOPPING'
  AND segments.date DURING LAST_30_DAYS
ORDER BY
  metrics.gross_profit_margin DESC,
  metrics.average_order_value_micros DESC,
  metrics.cost_micros DESC,
  metrics.conversions DESC,
  metrics.clicks DESC,
  metrics.impressions DESC
السابق
إنشاء مجموعات بيانات