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

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

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

• عرض أداء Shopping
• عرض مجموعة المنتجات
• عرض مجموعة المنتجات ضمن مجموعة مواد العرض
• منتج التسوّق

ملاحظة: بيانات كلا العرضَين لـ "أداء التسوّق" و"Shopping Product" يمكنهم إرجاع المقاييس على مستوى المنتج. "عرض أداء Shopping" سيضمن "تاريخي" حالة منتج عرض إعلانات، في حين أنّ "Shopping Product" (منتج التسوّق) الحالة الراهنة للمنتج، سواء تم عرض إعلانات أم لا. ننصح بأن يكون "منتج 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 مجموعات (يُشار إليها باسم المنتج) Google في واجهة المستخدم). اطّلِع على دليل إعداد تقارير "حملات الأداء الأفضل" عن عرض مجموعة المنتجات ضمن مجموعة مواد العرض الأمثلة.

في ما يلي مثال لطلب بحث يسترد مرات الظهور والنقرات والإحالات الناجحة كل الإحالات الناجحة لمجموعات بيانات 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 في الرد، والذي يتضمن مقالة في مركز المساعدة لتقديم المساعدة.

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

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

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

• 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. في حال عدم توفّر أحد هذه العناصر أو غيرها، سيؤدّي ذلك إلى ما يلي: الخطأ: MISSING_CAMPAIGN_FILTER وMISSING_AD_GROUP_FILTER.

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

سيؤدي تحديد التقرير باستخدام تاريخ أو نطاق زمني في عبارة 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'

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

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

• ad_group
• ad_group_ad
• campaign
• customer (مجمّعة لكل الحملات)
• product_group_view
• shopping_performance_view

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

يوضّح المثال التالي كيفية استخدام مقاييس بيانات سلة التسوّق من أجل تحليل الأداء على مستوى المنتج في "حملات 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