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

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

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

طريقة عرض "أداء التسوّق"

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

تسجّل "طريقة عرض أداء التسوّق" حالة المنتج في الوقت الذي تم فيه تسجيل المقاييس ذات الصلة. ويشمل ذلك أجزاءً مثل 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، في "حملات التسوّق".

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