گزارش نویسی

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

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

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

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

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

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

نمای عملکرد خرید، وضعیت محصول را در زمان ثبت معیارهای مربوطه نشان می‌دهد. این شامل بخش‌هایی مانند product_title است که ممکن است از زمان ثبت معیار تغییر کرده باشد.

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

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

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

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

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

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

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

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

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

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

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

این بخش برخی از موارد استفاده معمولی مشابه موارد ممکن در نمای " محصولات " در رابط کاربری Google Ads را پوشش می دهد.

فیلد «مشکلات» برای محصول خرید، مشابه آنچه که توسط statusstatuses در Content API برای خرید ارائه می‌شود، با اضافه شدن مسائلی که مختص Google Ads هستند، است. برای بررسی اینکه آیا مشکل باید در Google Merchant Center یا Google Ads حل شود، ابتدا فیلد 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