إعداد التقارير

كما هو الحال مع أنواع الحملات الأخرى، يمكنك استخدام 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 في "الحد الأدنى المطلوب من الوظائف":

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