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

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

تتضمّن الحملات التي تتيح المنتجات التقارير المخصّصة التالية:

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

تقدّم نظرة على أداء التسوّق إحصاءات مجمّعة للتقارير السابقة عن المنتجات حسب سمات مثل 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

يقدّم تقرير منتجات 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
السابق
إنشاء مجموعات بيانات