التقارير في واجهة المستخدم

يربط هذا الدليل المفاهيم واصطلاحات التسمية للتقارير في واجهة مستخدم "إعلانات Google" بالتقارير التي يمكنك إنشاؤها باستخدام لغة طلب البحث في "إعلانات Google" (GAQL) وGoogle Ads API.

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

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

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

الأعمدة

تُعادِل الأعمدة في واجهة المستخدم حقول الموارد وحقول الشرائح والمقاييس في GAQL.

الفلترة

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

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

لديك نفس عناصر التحكم في GAQL من خلال الفلترة حسب segments.date في عبارة WHERE (أين) في طلب بحث GAQL.

الفلاتر

تعادل الفلاتر في واجهة المستخدم شرطًا واحدًا أو أكثر في عبارة WHERE في GAQL.

التصنيف إلى قطاعات أو شرائح

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

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

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

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

نتائج الطلبات

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

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

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

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

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

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

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

التقارير المحدَّدة مسبقًا

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

في ما يلي قائمة بالتقارير الأساسية المحدّدة مسبقًا واسم مورد GAQL المطابق لها.

التقارير الأساسية المحدَّدة مسبقًا	اسم مورد GAQL (يُرجى التحديد في عبارة FROM)
Account	العميل
الحملة، تفاصيل الحملة	الحملة
المجموعة الإعلانية، تفاصيل المجموعة الإعلانية	ad_group
الإعلان، رابط عنوان URL النهائي	ad_group_ad
شبكة البحث - الكلمة الرئيسية	keyword_view
عبارات البحث	search_term_view
المدفوعة والمجانية	paid_organic_search_term_view
الصفحة المقصودة	landing_page_view
الصفحة المقصودة الموسَّعة	expanded_landing_page_view

في مثال الجدول أعلاه، يمكنك استخدام GAQL التالي لإنشاء تقرير الحساب:

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 عادةً لاستبعاد الصفوف التي تمت إزالتها، على سبيل المثال:

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