گزارش نویسی

همانند سایر انواع کمپین، می‌توانید از 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 عبارت جستجوی برتر که بیشترین بازدید را در 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 Smart Campaign Search Term View آمده است:

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

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

در اینجا نحوه بازیابی تمام معیارهای تماس تلفنی بین ساعت ۱۲ ظهر تا ۵ بعد از ظهر آورده شده است:

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