گزارش نویسی

همانند سایر انواع تبلیغات، می‌توانید از GoogleAdsService.SearchStream برای بازیابی وضعیت محصول و داده‌های عملکرد برای محصولات فروشگاهی استفاده کنید.

کمپین‌هایی که از محصولات پشتیبانی می‌کنند، گزارش‌های اختصاصی زیر را دارند:

• نمای عملکرد خرید
• نمای گروه محصولات
• نمای گروه محصول گروه دارایی
• محصول خرید

توجه: هم «نمای عملکرد خرید» و هم «محصول خرید» می‌توانند معیارها را در سطح محصول برگردانند. «نمای عملکرد خرید» وضعیت «تاریخچه» محصولی را که تبلیغات ارائه داده است، ارائه می‌دهد، در حالی که «محصول خرید» وضعیت فعلی محصول را چه تبلیغات ارائه داده باشد و چه نه، ارائه می‌دهد. توصیه می‌شود از «محصول خرید» در درجه اول برای ارزیابی «وضعیت» یک محصول و هرگونه مشکلی که مانع از استفاده آن توسط یک کمپین می‌شود، استفاده شود.

نمای عملکرد خرید

نمای عملکرد خرید، آمار گزارش‌های تاریخی تجمیعی را برای محصولات بر اساس ویژگی‌هایی مانند product_item_id ارائه می‌دهد.

نمای عملکرد خرید، وضعیت محصول را در زمان ثبت معیارهای مربوطه ثبت می‌کند. این شامل بخش‌هایی مانند 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

نمای گروه محصولات

نمای گروه محصول، آمار گزارش‌دهی تجمیعی را برای گروه‌های فهرست خرید (که در رابط کاربری به عنوان گروه‌های محصول شناخته می‌شوند) ارائه می‌دهد. برای مثال‌هایی از نمای گروه محصول گروه دارایی، به راهنمای گزارش‌دهی Performance Max مراجعه کنید.

در اینجا یک مثال از کوئری وجود دارد که تعداد نمایش‌ها، کلیک‌ها، تبدیل‌ها و تمام تبدیل‌ها را برای گروه‌های فهرست خرید بر اساس کمپین با نمایش‌ها در 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

محصول خرید

گزارش محصولات خرید، ویژگی‌ها و آمار گزارش‌دهی را برای محصولاتی که در حساب‌های مرکز بازرگانان گوگل (Google Merchant Center) که به حساب تبلیغات گوگل (Google Ads) متصل هستند، وجود دارند، ارائه می‌دهد. این گزارش می‌تواند برای بررسی آمار در سطح مشتری، کمپین و گروه تبلیغاتی مورد استفاده قرار گیرد.

در اینجا یک پرس و جو به عنوان مثال آورده شده است که تعداد نمایش‌ها، کلیک‌ها، تبدیل‌ها و تمام تبدیل‌ها را برای 30 روز گذشته (به ترتیب نزولی بر اساس تمام تبدیل‌ها، سپس تبدیل‌ها، سپس کلیک‌ها، سپس نمایش‌ها) برای همه محصولات خرید از همه حساب‌های مرتبط مرکز بازرگانان گوگل بازیابی می‌کند:

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

برای جزئیات بیشتر در مورد پرس‌وجوها، به راهنمای گزارش‌دهی مراجعه کنید.

ملاحظات عملکرد

گزارش خرید محصولات می‌تواند حجم قابل توجهی از داده‌ها را در زمانی که یک حساب کاربری به تعداد زیادی از محصولات مرتبط است، بازگرداند. توصیه‌های زیر می‌تواند به بهبود عملکرد پرس‌وجوهای GAQL شما کمک کند:

• جستجوها در سطح کمپین و گروه تبلیغاتی معمولاً سریع‌تر از جستجوها در سطح حساب کاربری انجام می‌شوند، زیرا احتمالاً شامل محصولات کمتری هستند و به دسترسی به داده‌های کمتری نیاز دارند.
• هرچه فیلدها و معیارهای بیشتری در عبارت SELECT وجود داشته باشد، زمان پاسخ کندتر می‌شود. توصیه می‌کنیم فقط فیلدها و معیارهایی را انتخاب کنید که در پرس‌وجو به آنها نیاز دارید.
• در نظر بگیرید که محصولاتی که یک یا چند مشکل دارند، داده‌های بیشتری را برمی‌گردانند. می‌توانید با استفاده از shopping_product.status در WHERE فیلتر کنید تا بفهمید کدام محصولات احتمالاً مشکلاتی را که باعث ایجاد وضعیت مربوطه شده‌اند، برمی‌گردانند.

موارد استفاده از گزارش خرید محصول

گزارش محصولات خرید، دسترسی انعطاف‌پذیری به اطلاعات محصول را برای کمپین‌هایی که از فیدهای محصول استفاده می‌کنند، فراهم می‌کند. این گزارش می‌تواند به شما در مورد وضعیت محصولات از حساب‌های مرکز بازرگانان گوگل (Google Merchant Center) بینش بدهد، اما همچنین اطلاعات خاص تبلیغات مانند معیارهای عملکرد و مشکلاتی که مانع از نمایش تبلیغات توسط محصولات می‌شوند را نیز ارائه می‌دهد.

این بخش برخی از موارد استفاده معمول مشابه موارد ممکن در نمای « محصولات » در رابط کاربری گوگل ادز را پوشش می‌دهد.

فیلد «مسائل» برای محصول خرید مشابه فیلدی است که توسط productstatuses در Content API for Shopping ارائه می‌شود، با این تفاوت که مسائلی که مختص تبلیغات گوگل هستند نیز اضافه شده‌اند. برای بررسی اینکه آیا مشکل باید در مرکز بازرگانان گوگل یا تبلیغات گوگل حل شود، ابتدا فیلد 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 مشخص شوند. اگر یکی از آنها وجود نداشته باشد، منجر به یکی از خطاهای زیر خواهد شد: 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 برای کمپین‌های خرید استفاده شوند.

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 برای حساب‌هایی با تعداد زیادی محصول، حتی با اعمال فیلترها، می‌تواند زمان بیشتری ببرد.

مثال زیر نشان می‌دهد که چگونه می‌توان از معیارهای داده‌های سبد خرید برای تحلیل عملکرد سطح محصول برای کمپین‌های خرید در 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