گزارش نویسی

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

منطق انتساب برای گزارش محصول

گزارش‌های سطح محصول از یک چارچوب انتساب خاص برای ارزیابی عملکرد هر محصول، زمانی که چندین محصول در یک تبلیغ واحد ظاهر می‌شوند، استفاده می‌کنند.

معیارهای مالی

معیارهای مالی، مانند metrics.cost_micros و metrics.conversions ، محاسبه می‌شوند تا اطمینان حاصل شود که مجموع آنها در تمام محصولات از گزارش‌های سطح کمپین تجاوز نمی‌کند.

تعاملات مستقیم
وقتی قصد کاربر واضح و مرتبط با یک محصول واحد باشد (مانند کلیک مستقیم روی یک محصول)، ۱۰۰٪ از هزینه و اعتبار تبدیل مرتبط به آن محصول خاص اختصاص داده می‌شود.
تعاملات غیرمستقیم
وقتی قصد کاربر به طور کلی به تبلیغ معطوف می‌شود (برای مثال، اگر کاربر روی یک تیتر، دکمه فراخوان یا یک ویدیو کلیک کند)، هزینه و اعتبار تبدیل مرتبط به طور یکنواخت بین تمام محصولات ارائه شده در آن تبلیغ خاص توزیع می‌شود.

معیارهای تعامل

معیارهای تعامل، مانند metrics.impressions و metrics.clicks ، میزان تعامل مختص محصول را اندازه‌گیری می‌کنند.

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

برعکس، metrics.clicks فقط کلیک‌هایی را که روی آن محصول خاص رخ داده است، اندازه‌گیری می‌کند. در رابط کاربری گوگل ادز، فیلد metrics.clicks به صراحت با عنوان Product Clicks برچسب‌گذاری شده است.

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

نمای گروه محصول، آمار گزارش‌دهی تجمیعی را برای [گروه‌های فهرست خرید] 4 ارائه می‌دهد. برای مثال‌هایی از نمای گروه محصول گروه دارایی، به راهنمای گزارش‌دهی 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، معیارهای مربوط به همه محصولات در سطح حساب را که (صرف نظر از اینکه معیارها غیر صفر هستند یا خیر) برای دوره زمانی مشخص شده هستند، برمی‌گرداند.

شما نمی‌توانید 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_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

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

[4]: /google-ads/api/docs/shopping-ads/create-listing-groups (که به عنوان _product شناخته می‌شود)

قبلی
ایجاد گروه های لیست