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

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

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

في ما يلي كيفية استرداد الحقول المطلوبة من رقم البند R.70 Smart عرض عبارة البحث في "الحملة الذكية":

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