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

كما هو الحال مع أنواع الحملات الأخرى، يمكنك استخدام GoogleAdsService.SearchStream لاسترداد السمات ومقاييس الأداء لـ "الحملات الذكية".

تتوفّر مقاييس "الحملات الذكية" من المورد campaign، وتتوفّر المقاييس المتعلّقة بعبارات البحث من المورد smart_campaign_search_term_view. في smart_campaign_search_term_view، يحتوي الحقل search_term على أي طلبات بحث مطابقة أدّت إلى عرض نتائج. لاسترداد الحالة التشغيلية وتفاصيل الأهلية لحملة ذكية (مثل الحالة "قيد المراجعة" أو أسباب عدم الأهلية أو الطوابع الزمنية لمرات الظهور)، استخدِم SmartCampaignSettingService.GetSmartCampaignStatus كما هو موضّح في حالة الحملة.

مرّات الظهور والنقرات في "الحملات الذكية" خلال آخر 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 يومًا، بالإضافة إلى تكلفتها. يُرجى العِلم أنّه تم حذف segments.date من عبارة SELECT ليتم تجميع مرّات الظهور والتكلفة على مستوى النطاق الزمني الكامل الذي يبلغ 30 يومًا لكل عبارة بحث.

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'

متطلبات وظيفة إعداد التقارير

لتنفيذ "الحملات الذكية"، يجب أن يستوفي تطبيقك مجموعة من الحدّ الأدنى من الوظائف المطلوبة.

بالنسبة إلى إعداد التقارير على وجه التحديد، يجب توفير عدد من حقول إعداد التقارير للمستخدم النهائي. في ما يلي كيفية استرداد الحقول المطلوبة من رقم العنصر 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'

المكالمات الهاتفية مقسّمة حسب الساعة

في ما يلي كيفية استرداد جميع مقاييس المكالمات الهاتفية بين الساعة 12:00 ظهرًا و5:00 مساءً (قيم 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