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

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

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

عرض أداء 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.search_budget_lost_impression_share,
  metrics.search_rank_lost_impression_share,
  metrics.search_budget_lost_absolute_top_impression_share,
  metrics.search_rank_lost_absolute_top_impression_share,
  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 في الردّ، الذي يتضمّن مقالة في مركز المساعدة للمساعدة.

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

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

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

  • تسوّق
  • حملات الأداء الأفضل

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

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

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

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

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