التقارير في واجهة مستخدم "إعلانات Google"

توفّر واجهة مستخدم "إعلانات Google" إمكانات لإعداد التقارير. لإنشاء تقرير، سجِّل الدخول إلى حسابك على "إعلانات Google"، وانقر على الحملات في قائمة التنقّل اليمنى، ثم انقر على الإحصاءات والتقارير. لإنشاء تقرير من البداية، انقر على محرِّر التقارير.

يوضّح هذا الدليل المفاهيم الشائعة لإعداد التقارير واتفاقيات التسمية في واجهة مستخدم "إعلانات Google" للتقارير التي يمكنك إنشاؤها باستخدام لغة طلب البحث في "إعلانات Google"‏ (GAQL) وGoogle Ads API. يمكنك أيضًا اتّباع الطلبات في واجهة المستخدم لإنشاء التقرير الذي يناسب متطلباتك على أفضل نحو.

الأدوات والموارد

للحصول على أمثلة أكثر تفصيلاً ومساعدة مبرمَجة في ربط شاشات واجهة المستخدم بواجهة برمجة التطبيقات، يُرجى الاطّلاع على المراجع التالية:

• Query Cookbook: مجموعة من طلبات البحث بلغة GAQL التي تكرّر البيانات المتوفّرة في العديد من شاشات واجهة مستخدم "إعلانات Google" الشائعة.
• إضافة Google Ads API Reporting: هي إضافة Chrome تساعدك في تحديد أسماء حقول وموارد واجهة برمجة التطبيقات مباشرةً ضمن واجهة مستخدم "إعلانات Google".

مصطلحات واجهة المستخدم الشائعة

يلخّص الجدول التالي بعض المصطلحات الشائعة المستخدَمة في واجهة المستخدم ومطابقتها مع لغة طلب البحث في "إعلانات Google"‏ (GAQL).

واجهة المستخدِم	GAQL
الأعمدة	أي مورد أو حقل شريحة أو مقياس في عبارة SELECT لطلب بحث GAQL
النطاق الزمني	يتم ربط النطاقات الزمنية بشرط WHERE للفلترة حسب segments.date.
الفلاتر	شرط واحد أو أكثر في عبارة WHERE
حقول الشرائح	طبِّق التقسيم من خلال تضمين حقول الأقسام في طلب بحث GAQL.
تقسيم الصفحات	يؤدي تقسيم الصفحات إلى تقسيم مجموعة نتائج طلب البحث إلى صفحات متعددة.

الأعمدة

تعادل الأعمدة في واجهة المستخدم استخدام عبارة SELECT لحقول الموارد أو حقول الشرائح أو المقاييس في لغة طلب البحث في "إعلانات Google"‏ (GAQL).

لمزيد من المعلومات، يُرجى الاطّلاع على مقالة لمحة عن الأعمدة في جدول الإحصاءات.

النطاقات الزمنية

تحتوي واجهة مستخدم "إعلانات Google" على جدول يعرض إحصاءات الحساب، وقائمة منسدلة للتحكّم في النطاق الزمني لهذه الإحصاءات.

يمكنك التحكّم في ذلك في لغة طلب البحث في "إعلانات Google"‏ (GAQL) من خلال الفلترة حسب segments.date في عبارة WHERE لطلب بحث GAQL.

الفلاتر

تُعادل الفلاتر في واجهة المستخدِم شرطًا واحدًا أو أكثر في عبارة WHERE من لغة طلب البحث في "إعلانات Google"‏ (GAQL).

لمزيد من المعلومات، يُرجى الاطّلاع على مقالة فلترة طريقة عرض بيانات الأداء.

التقسيم

للحصول على إحصاءات أكثر تفصيلاً، يمكنك تقسيم البيانات حسب الشرائح. على سبيل المثال، لنفترض أنّك تريد الاطّلاع على عدد مرّات الظهور الخاصة بـ "شبكة بحث Google" بشكل منفصل عن "شبكة Google الإعلانية". في هذه الحالة، يمكنك تقسيم تقريرك حسب الشبكة. يُرجى الاطّلاع على التقسيم لمعرفة كيفية تضمين حقول الأقسام في عبارة SELECT.

تقسيم النتائج على عدّة صفحات

يمكنك التنقّل في تقاريرك في واجهة المستخدم باستخدام عناصر التحكّم المتاحة في أسفل كل جدول بيانات، والتي تتيح لك تبديل الصفحات واختيار عدد النتائج المطلوب عرضها من مجموعة محدّدة من الأحجام.

للانتقال بين صفحات النتائج عند استرداد التقارير، استخدِم GoogleAdsService.Search مع next_page_token. لجلب مجموعة النتائج بالكامل بدون أي تقسيم للصفحات، استخدِم GoogleAdsService.SearchStream.

ترتيب النتائج

في واجهة المستخدم، يمكنك ترتيب النتائج من خلال اختيار عمود.

في GAQL، يمكنك استخدام عبارة ORDER BY وعبارة LIMIT لترتيب نتائج طلب البحث وحصرها.

تنسيقات التنزيل

في واجهة المستخدم، يمكن تنزيل التقارير بتنسيقات مختلفة، مثل CSV أو TSV أو XML.

لا تنسِّق واجهة برمجة التطبيقات الناتج مباشرةً في ملفات مثل CSV، لذا يجب أن ينسِّق تطبيق العميل الردّ. اطّلِع على نموذج رمز تقرير الحملة إلى ملف CSV للتعرّف على كيفية تنفيذ تنسيق ملف CSV في برنامج عميل.

جدولة التقارير وإرسالها عبر البريد الإلكتروني

يمكنك جدولة تقرير وإرساله عبر البريد الإلكتروني من واجهة المستخدم، ولكن لا تتوفّر هذه الميزات في واجهة برمجة التطبيقات.

ربط طرق عرض واجهة المستخدم بموارد واجهة برمجة التطبيقات

في ما يلي قائمة بطرق العرض الشائعة في واجهة المستخدم واسم مورد GAQL المطابق لها.

طرق عرض واجهة المستخدم	اسم مورد GAQL (يجب تحديده في عبارة FROM)
Account	customer
الحملة، تفاصيل الحملة	campaign
المجموعة الإعلانية، تفاصيل المجموعة الإعلانية	ad_group
الإعلان، رابط عنوان URL النهائي	ad_group_ad
كلمة البحث الرئيسية	keyword_view
عبارات البحث	search_term_view
النتائج المدفوعة والمجانية (نموذج معاينة أداء المنافسين)^*	paid_organic_search_term_view
الصفحة المقصودة	landing_page_view
الصفحة المقصودة الموسَّعة	expanded_landing_page_view
المحتوى > مواضع الإعلان	managed_placement_view
المحتوى > مكان عرض الإعلانات	group_placement_view
المحتوى > مواضع ظهور الإعلانات > عرض التفاصيل	detail_placement_view
شرائح الجمهور > الخصائص الديمغرافية > العمر	age_range_view
شرائح الجمهور > الخصائص الديمغرافية > الجنس	gender_view
المواقع الجغرافية	location_view
المحتوى > المواضيع	topic_view
المواقع الجغرافية > تقرير الأداء الجغرافي	geographic_view

^* لإنشاء تقرير نتائج البحث المدفوعة والمجانية، يجب ربط حساب على Google Search Console بحسابك على "إعلانات Google" على مستوى العميل.

على سبيل المثال من الجدول السابق، يمكنك استخدام طلب البحث التالي في GAQL لإنشاء تقرير مجمّع عن الحساب لآخر 7 أيام (أضِف segments.date إلى عبارة SELECT إذا كنت تريد تقسيم المقاييس حسب اليوم):

SELECT
  customer.descriptive_name,
  customer.id,
  metrics.clicks,
  metrics.impressions,
  metrics.ctr,
  metrics.average_cpc,
  metrics.cost_micros,
  metrics.absolute_top_impression_percentage,
  metrics.top_impression_percentage,
  metrics.average_cpm
FROM customer
WHERE segments.date DURING LAST_7_DAYS

الاختلافات الشائعة

عند مقارنة تقارير واجهة المستخدم بتقارير واجهة برمجة التطبيقات، يتمثّل أحد الاختلافات الأكثر شيوعًا في أنّ واجهة المستخدم تفلتر الكيانات التي تمت إزالتها ضمنيًا، في حين أنّ واجهة برمجة التطبيقات لا تفعل ذلك.

لتكرار طريقة عرض تلقائية لواجهة المستخدم، أضِف فلترًا باستخدام حقل status لاستبعاد الصفوف التي تمت إزالتها (أو تضمين الكيانات ENABLED وPAUSED بشكل صريح). على سبيل المثال:

SELECT campaign.name
FROM campaign
WHERE campaign.status != 'REMOVED'