كما هو الحال مع أنواع الإعلانات الأخرى، يمكنك استخدام GoogleAdsService.SearchStream لاسترداد حالة المنتج وبيانات الأداء لمنتجات Shopping.
تتضمّن الحملات التي تتيح استخدام منتجات من خلاصة على Google Merchant Center التقارير المخصّصة التالية:
- عرض أداء التسوّق
- طريقة عرض مجموعة المنتجات
- طريقة عرض مجموعة المنتجات في مجموعة مواد العرض
- منتج Shopping
- طريقة عرض مبيعات بيانات سلة التسوّق (متاحة في الإصدار 24 والإصدارات الأحدث)
- عرض مواد عرض "توسيع عنوان URL النهائي" (متاح لـ "حملات تسوّق" في الإصدار 26 والإصدارات الأحدث)
بالإضافة إلى ذلك، اعتبارًا من الإصدار 26، في حملات التسوّق،
يعرض final_url_expansion_asset_view مواد عرض "تخصيص النص" التي تم عرضها
عند تفعيل AI Max (campaign.ai_max_setting.enable_ai_max = true) و"توسيع عنوان URL النهائي" (FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION = OPTED_IN).
يُرجى الاطّلاع على قسم عرض مواد عرض "توسيع عنوان URL النهائي" لمعرفة متطلبات طلبات البحث ومثال عليها.
عرض أداء "التسوّق على YouTube"
توفّر طريقة العرض Shopping Performance View إحصاءات مجمّعة للتقارير السابقة
للمنتجات حسب سمات مثل product_item_id.
تتوافق هذه الميزة مع جميع أنواع الحملات التي تستخدم خلاصات المنتجات من Google Merchant Center، بما في ذلك "حملات Shopping" و"حملات الأداء الأفضل" و"حملات زيادة الطلب" و"حملات الفيديو" و"حملات التطبيقات" و"الحملات على الشبكة الإعلانية".
تسجّل طريقة عرض أداء Shopping حالة المنتج في وقت تسجيل المقاييس ذات الصلة. ويشمل ذلك شرائح مثل
product_title، والتي قد تكون تغيّرت منذ تسجيل المقياس.
يتيح shopping_performance_view أيضًا استخدام الأقسام والمقاييس التالية:
segments.ad_sub_network_type(يتوفّر أيضًا فيproduct_group_viewوasset_group_product_group_view).- المقاييس المقسّمة حسب تاريخ الإحالة الناجحة:
metrics.conversions_by_conversion_dateوmetrics.all_conversions_by_conversion_dateوmetrics.conversions_value_by_conversion_dateوmetrics.all_conversions_value_by_conversion_dateوmetrics.value_per_conversions_by_conversion_dateوmetrics.value_per_all_conversions_by_conversion_date. - مقاييس نسبة ظهور الإعلان التنافسية:
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 - تتوفّر في الإصدار 24 والإصدارات الأحدث: شريحة
segments.conversion_attribution_event_typeومقاييسmetrics.all_*بيانات سلة التسوّق (التي تسجّل بيانات سلة التسوّق في جميع الإحالات الناجحة، بما في ذلك الإحالات الناجحة غير القابلة للمزايدة).
في ما يلي مثال على طلب بحث يسترجع مرات الظهور والنقرات والتكلفة والإحالات الناجحة وجميع الإحالات الناجحة للمنتجات حسب 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
آلية تحديد المصدر لتتبُّع أداء المنتج
تستخدم التقارير على مستوى المنتج إطار عمل محدّدًا لتحديد مصدر الإحالة الناجحة من أجل تحديد نسبة مساهمة الأداء في المنتجات الفردية عندما تظهر منتجات متعدّدة في إعلان واحد.
المقاييس المالية
يتم احتساب المقاييس المالية، مثل metrics.cost_micros وmetrics.conversions، لضمان ألا يتجاوز مجموعها في جميع المنتجات التقارير على مستوى الحملة.
- التفاعلات المباشرة
- عندما تكون نية المستخدم واضحة ومرتبطة بمنتج واحد (مثل النقر مباشرةً على منتج)، يتم تحديد مصدر %100 من التكلفة المرتبطة به ونسبة الإسهام في الإحالة الناجحة لهذا المنتج المحدّد.
- التفاعلات غير المباشرة
- عندما تكون نية المستخدم موجّهة إلى الإعلان ككل (على سبيل المثال، إذا نقر المستخدم على عنوان أو زر حث على اتخاذ إجراء أو فيديو)، يتم توزيع التكلفة المرتبطة ونسبة المساهمة في الإحالة الناجحة بشكل موحّد على كل المنتجات المعروضة في هذا الإعلان تحديدًا.
مقاييس التفاعل
تقيس مقاييس التفاعل، مثل metrics.impressions وmetrics.clicks،
مستوى التفاعل الخاص بالمنتج.
بالنسبة إلى مرّات الظهور، تتم زيادة العدد لكل منتج مضمَّن في الإعلان عند وقوع الحدث، بغض النظر عمّا إذا كان المنتج مرئيًا في إطار العرض لدى المستخدم. لهذا السبب، قد يكون مجموع مرات الظهور في كل المنتجات في التقرير أعلى بكثير من الإجماليات المقابلة على مستوى الحملة.
في المقابل، لا يقيس metrics.clicks سوى النقرات التي حدثت على هذا المنتج المحدّد. في واجهة مستخدم "إعلانات Google"، يتم تصنيف الحقل metrics.clicks بشكل صريح على أنّه النقرات على المنتج.
طريقة عرض مجموعة المنتجات
توفّر طريقة عرض مجموعة المنتجات إحصاءات مجمّعة لإعداد التقارير عن مجموعات بيانات المنتجات (يُشار إليها باسم مجموعات المنتجات في واجهة المستخدم). يمكنك الاطّلاع على دليل إعداد تقارير "حملات الأداء الأفضل" للحصول على أمثلة على طريقة عرض مجموعة المنتجات في مجموعة مواد العرض.
في ما يلي مثال على طلب بحث يسترجع مرات الظهور والنقرات والإحالات الناجحة وجميع الإحالات الناجحة لمجموعات بيانات المنتجات في 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". يمكن استخدام هذا التقرير لفحص الإحصاءات على مستوى العميل والحملة والمجموعة الإعلانية. وهي متوافقة مع "حملات Shopping" و"حملات الأداء الأفضل" و"حملات زيادة الطلب" و"حملات الفيديو" و"حملات التطبيقات" (في الإصدار 24 والإصدارات الأحدث). يمكنك أيضًا الاستعلام عن shopping_product.product_image_uri لاسترداد معرّف الموارد المنتظم (URI) لصورة المنتج التي يقدّمها التاجر.
في ما يلي مثال على طلب بحث يسترجع مرات الظهور والنقرات والإحالات الناجحة وجميع الإحالات الناجحة لآخر 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".
يشبه حقل issues في shopping_product حقل ProductStatus في Merchant API، مع إضافة المشاكل المتعلّقة بـ "إعلانات 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 إلى عرض كل المنتجات المضمّنة في الحملة المحدّدة.
وهي متاحة لأنواع الحملات التالية التي يمكنها استخدام خلاصات المنتجات:
- تسوّق
- حملات الأداء الأفضل
- حملات زيادة الطلب
- فيديو
- التطبيق (متوفّر في الإصدار 24 والإصدارات الأحدث)
يتيح لك طلب البحث هذا الاطّلاع على حالة كل منتج مضمّن في حملة معيّنة، بما في ذلك المشاكل التي تؤدي إلى ظهور هذه الحالة. على سبيل المثال، تؤثر الحملة المتوقفة مؤقتًا في حالة المنتج:
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، يتم عرض كل المنتجات المضمّنة في الحملة المحدّدة. توضّح مقاييس المنتج وحالته ومشاكله ما إذا كان مضمّنًا في المجموعة الإعلانية المحدّدة أو مستبعدًا منها.
وهو متاح لأنواع الحملات التالية:
- تسوّق
- حملات زيادة الطلب
- فيديو
- التطبيق (متوفّر في الإصدار 24 والإصدارات الأحدث، ويتيح استخدام مقاييس
impressionsوclicksوctrفقط، ولا يتيح استخدامstatusأوissues)
يتيح لك هذا الطلب الاطّلاع على حالة المنتج في ما يتعلّق بتلك المجموعة الإعلانية. تتيح لك هذه الميزة التأكّد من تطبيق فلاتر مجموعات المنتجات (على مستوى المجموعة الإعلانية) بشكل صحيح والتحقّق من حالة كل منتج:
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 DURING LAST_30_DAYS
أداء المنتجات استنادًا إلى بيانات سلة التسوّق
يمكن للمعلنين في قطاع البيع بالتجزئة الوصول إلى مقاييس المبيعات والأرباح ذات الصلة، مثل الإيرادات والأرباح الإجمالية وهامش الربح الإجمالي والوحدات المُباعة. تتوفّر هذه المقاييس لجميع المعلِنين الذين يستخدمون ميزة الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق في "حملات Shopping"، وهي متوافقة مع التقارير التالية:
ad_groupad_group_adcampaigncart_data_sales_view(متوفّر في الإصدار 24 والإصدارات الأحدث)customer(مجمّعة لجميع الحملات)product_group_viewshopping_performance_viewshopping_product(لمقاييس بيانات سلة التسوّق البالغ عددهاmetrics.all_*في الإصدار 24 والإصدارات الأحدث)
يمكن استخدام مقاييس بيانات سلة التسوّق التالية في التقارير، مثل
shopping_performance_view، في "حملات Shopping":
metrics.average_cart_sizemetrics.average_order_value_microsmetrics.cost_of_goods_sold_microsmetrics.cross_sell_cost_of_goods_sold_microsmetrics.cross_sell_gross_profit_microsmetrics.cross_sell_revenue_microsmetrics.cross_sell_units_soldmetrics.gross_profit_marginmetrics.gross_profit_microsmetrics.lead_cost_of_goods_sold_microsmetrics.lead_gross_profit_microsmetrics.lead_revenue_microsmetrics.lead_units_soldmetrics.ordersmetrics.revenue_microsmetrics.units_sold
في الإصدار 24 والإصدارات الأحدث، تتوفّر أيضًا مقاييس بيانات سلة التسوّق التالية لإعداد التقارير عن جميع الإحالات الناجحة (بما في ذلك الإحالات الناجحة غير القابلة للمزايدة):
metrics.all_average_cart_sizemetrics.all_average_order_value_microsmetrics.all_cost_of_goods_sold_microsmetrics.all_cross_sell_cost_of_goods_sold_microsmetrics.all_cross_sell_gross_profit_microsmetrics.all_cross_sell_revenue_microsmetrics.all_cross_sell_units_soldmetrics.all_gross_profit_marginmetrics.all_gross_profit_microsmetrics.all_lead_cost_of_goods_sold_microsmetrics.all_lead_gross_profit_microsmetrics.all_lead_revenue_microsmetrics.all_lead_units_soldmetrics.all_ordersmetrics.all_revenue_microsmetrics.all_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
طريقة عرض مواد عرض ميزة "توسيع عنوان URL النهائي"
اعتبارًا من الإصدار 26، يمكنك استخدام
final_url_expansion_asset_view لقياس الأداء على مستوى مادة العرض
لمواد عرض تخصيص النص التي يتم عرضها في "حملات Shopping" عند تفعيل AI Max
(campaign.ai_max_setting.enable_ai_max = true) وميزة "توسيع عنوان URL النهائي"
(FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION = OPTED_IN).
عند الاستعلام عن final_url_expansion_asset_view، اتّبِع قواعد الفلترة واختيار الحقول التالية:
- يجب أن تتم فلترة طلبات البحث في
final_url_expansion_asset_viewحسب سمة واحدة على الأقل من السمات التالية:campaign.advertising_channel_typeأوcampaign(campaign.idأوcampaign.resource_nameأوfinal_url_expansion_asset_view.campaign) أوad_group(ad_group.idأوad_group.resource_nameأوfinal_url_expansion_asset_view.ad_group). يؤدي حذف جميع هذه السمات إلى عرضFinalUrlExpansionAssetViewError.MISSING_REQUIRED_FILTER. - عند الاستعلام عن
final_url_expansion_asset_viewلـ "حملات تسوّق" على مستوى الحساب أو الحملة، يجب الفلترة حسبcampaign.advertising_channel_type = 'SHOPPING'(أو الفلترة حسب مجموعة إعلانية واحدة باستخدام=). تتطلّب الفلترة حسب الحملة (campaign.idأوcampaign.resource_nameأوfinal_url_expansion_asset_view.campaign) أيضًا استخدامcampaign.advertising_channel_type = 'SHOPPING'، ويؤدي حذفها إلى عرضFinalUrlExpansionAssetViewError.REQUIRES_ADVERTISING_CHANNEL_TYPE_FILTER، في حين أنّ الفلترة حسبad_groupواحدة تفي بمتطلبات الفلترة بمفردها. - يجب أن تستخدم الفلاتر في
campaign.advertising_channel_typeأوcampaignأوad_groupعامل التشغيل=في قيمة واحدة، ويؤدي استخدامINأو شروط متعددة لنوع المورد نفسه إلى عرضFinalUrlExpansionAssetViewError.REQUIRES_FILTER_BY_SINGLE_RESOURCE. - بالنسبة إلى "حملات تسوّق"، يمكنك اختيار حقول
ad_groupوالفلترة حسبها، ولكن لا يمكنك اختيار حقولasset_group. يؤدي اختيار حقولasset_groupفي "حملات تسوّق" (أو عند الفلترة حسبad_group) إلى عرضFinalUrlExpansionAssetViewError.CANNOT_SELECT_ASSET_GROUP(أوCANNOT_SELECT_BOTH_AD_GROUP_AND_ASSET_GROUPعند اختيار حقولad_groupأيضًا). تؤدي الفلترة حسبasset_groupمع اختيار حقولad_groupإلى عرضCANNOT_SELECT_AD_GROUP، وتؤدي الفلترة حسب كل منad_groupوasset_groupإلى عرضCANNOT_FILTER_BY_BOTH_AD_GROUP_AND_ASSET_GROUP.
يستردّ طلب البحث التالي مقاييس الأداء على مستوى مادة العرض في "حملات Shopping" خلال آخر 30 يومًا:
SELECT
campaign.id,
campaign.name,
campaign.advertising_channel_type,
ad_group.id,
final_url_expansion_asset_view.asset,
final_url_expansion_asset_view.field_type,
final_url_expansion_asset_view.final_url,
final_url_expansion_asset_view.status,
metrics.impressions,
metrics.clicks,
metrics.conversions
FROM final_url_expansion_asset_view
WHERE
campaign.advertising_channel_type = 'SHOPPING'
AND segments.date DURING LAST_30_DAYS