گزارش نویسی

مانند سایر انواع کمپین، می‌توانید از GoogleAdsService.SearchStream برای بازیابی ویژگی‌ها و معیارهای عملکرد برای کمپین‌های هوشمند استفاده کنید.

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

تعداد بازدیدها و کلیک‌های کمپین‌های هوشمند در 30 روز گذشته

جستار زیر، نمایش‌ها و کلیک‌ها را برای هر عبارت جستجو از 30 روز گذشته برای همه کمپین‌های هوشمند، تقسیم‌بندی شده بر اساس تاریخ، بازیابی می‌کند.

SELECT
  campaign.id,
  campaign.name,
  segments.date,
  metrics.impressions,
  metrics.clicks,
  smart_campaign_search_term_view.search_term
FROM smart_campaign_search_term_view
WHERE segments.date DURING LAST_30_DAYS

10 عبارت برتر جستجو بر اساس برداشت

پرس و جوی زیر 10 عبارت جستجوی برتر را که در 30 روز گذشته بیشترین بازدید را داشته اند به همراه هزینه آنها بازیابی می کند.

SELECT
  campaign.id,
  campaign.name,
  segments.date,
  metrics.impressions,
  metrics.cost_micros,
  smart_campaign_search_term_view.search_term
FROM smart_campaign_search_term_view
ORDER BY metrics.impressions DESC
LIMIT 10

ویژگی های یک KeywordThemeConstant را بازیابی کنید

از آنجایی که KeywordThemeConstants از یک مجموعه داده بزرگ که مختص مشتری نیست بازیابی می شود، اسکن کل منبع keyword_theme_constant به یکباره امکان پذیر نیست. برای بازیابی تک تک KeywordThemeConstants ، باید از منبع campaign_criterion پرس و جو کنید تا نام منابع مضامین کلیدواژه های مرتبط با کمپین های خود را بیابید، سپس از نام آن منابع برای فیلتر کردن منبع keyword_theme استفاده کنید.

SELECT
  campaign_criterion.type,
  campaign_criterion.status,
  campaign_criterion.criterion_id,
  campaign_criterion.keyword_theme.keyword_theme_constant
FROM campaign_criterion
WHERE campaign_criterion.type = KEYWORD_THEME

اکنون از نام منبع در قسمت campaign_criterion.keyword_theme.keyword_theme_constant در عبارت زیر استفاده کنید:

SELECT
  keyword_theme_constant.resource_name,
  keyword_theme_constant.display_name,
  keyword_theme_constant.country_code
FROM keyword_theme_constant
WHERE keyword_theme_constant.resource_name = 'keywordThemeConstants/40804~0'

الزامات عملکرد گزارش

برای اجرای کمپین های هوشمند، برنامه شما باید مجموعه ای از حداقل عملکردهای مورد نیاز (RMF) را برآورده کند.

برای گزارش دهی به طور خاص، تعدادی فیلد گزارش باید در دسترس کاربر نهایی قرار گیرد. در اینجا نحوه بازیابی فیلدهای مورد نیاز از آیتم R.20 Campaign Performance در RMF آورده شده است:

SELECT
  metrics.clicks,
  metrics.cost_micros,
  metrics.impressions,
  metrics.conversions,
  metrics.all_conversions
FROM campaign

در اینجا نحوه بازیابی فیلدهای مورد نیاز از شماره مورد R.70 مشاهده عبارت جستجوی کمپین هوشمند آمده است :

SELECT
  metrics.clicks,
  metrics.cost_micros
FROM smart_campaign_search_term_view

معیارهای هر فروشگاه

در اینجا یک پرس و جو وجود دارد که شامل تمام معیارهای موجود برای هر فروشگاه است. این فیلدها همچنین می توانند با فیلدهای دیگر در یک پرس و جو ترکیب شوند:

SELECT
  metrics.all_conversions_from_click_to_call,
  metrics.all_conversions_from_directions,
  metrics.all_conversions_from_menu,
  metrics.all_conversions_from_order,
  metrics.all_conversions_from_other_engagement,
  metrics.all_conversions_from_store_visit,
  metrics.all_conversions_from_store_website
FROM campaign

تماس‌های تلفنی بر اساس ساعت تقسیم‌بندی شده‌اند

در اینجا نحوه بازیابی تمام معیارهای تماس تلفنی بین 12 بعد از ظهر تا 5 بعد از ظهر آمده است:

SELECT
  segments.hour,
  metrics.phone_calls
FROM campaign
WHERE segments.hour BETWEEN 12 and 17