گزارش

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

سنجه‌های پویش هوشمند از منبع campaign دردسترس است و سنجه‌های ویژه عبارت جستجو از منبع smart_campaign_search_term_view دردسترس است. در smart_campaign_search_term_view، فیلد search_term حاوی هرگونه پرسمان منطبقی است که نتایجی را تولید کرده است. برای بازیابی وضعیت عملیاتی و جزئیات واجدشرایط بودن «پویش هوشمند» (مثل وضعیت درحال مرور، دلایل واجدشرایط نبودن، یا مُهرهای زمان ظهور)، از SmartCampaignSettingService.GetSmartCampaignStatus به‌صورتی که در وضعیت پویش توضیح داده شده است استفاده کنید.

ظهورها و کلیک‌های «پویش‌های هوشمند» در ۳۰ روز گذشته

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

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

۱۰ عبارت جستجوی برتر براساس ظهورها

پُرسمان زیر ۱۰ عبارت جستجوی برتر را که بیشترین ظهور را در ۳۰ روز گذشته تولید کرده‌اند، همراه با هزینه آن‌ها بازیابی می‌کند. توجه داشته باشید که segments.date از عبارت SELECT حذف شده است تا ظهورها و هزینه در کل محدوده تاریخ ۳۰ روزه برای هر عبارت جستجو جمع‌آوری شود.

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

بازیابی مشخصه‌های KeywordThemeConstant

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

SELECT
  campaign.id,
  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 عملکرد پویش در «حداقل کارکردهای لازم» آورده شده است:

SELECT
  campaign.id,
  campaign.name,
  campaign.advertising_channel_type,
  metrics.clicks,
  metrics.cost_micros,
  metrics.impressions,
  metrics.conversions,
  metrics.all_conversions
FROM campaign
WHERE campaign.advertising_channel_type = 'SMART'

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

SELECT
  campaign.id,
  campaign.name,
  smart_campaign_search_term_view.search_term,
  metrics.clicks,
  metrics.cost_micros
FROM smart_campaign_search_term_view

سنجه‌های هر فروشگاه

در اینجا پُرسمانی وجود دارد که شامل همه سنجه‌های دردسترس برای هر فروشگاه برای کمپین‌های «هوشمند» است. این فیلدها را می‌توان با فیلدهای دیگر در یک پُرسمان ترکیب کرد:

SELECT
  campaign.id,
  campaign.name,
  campaign.advertising_channel_type,
  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
WHERE campaign.advertising_channel_type = 'SMART'

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

در اینجا نحوه بازیابی همه سنجه‌های تماس تلفنی بین ساعت ۱۲:۰۰ ب.ظ. و ۵:۰۰ ب.ظ. آورده شده است (segments.hour مقادیر 12 تا 16، که هر عدد صحیح نشان‌دهنده پنجره ۱ ساعته‌ای است که از آن ساعت شروع می‌شود):

SELECT
  campaign.id,
  campaign.name,
  campaign.advertising_channel_type,
  segments.hour,
  metrics.phone_calls
FROM campaign
WHERE campaign.advertising_channel_type = 'SMART'
  AND segments.hour BETWEEN 12 AND 16
  AND segments.date DURING LAST_30_DAYS