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

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

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

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

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

الأعمدة

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

الفلترة

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

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

يمكنك التحكّم بالطريقة نفسها في GAQL من خلال الفلترة على segments.date في عبارة WHERE لطلب GAQL.

الفلاتر

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

التقسيم

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

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

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

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

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

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

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

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

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

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

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

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

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

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

في ما يلي قائمة بالتقارير الأساسية المحدّدة مسبقًا واسم Resource Name المطابق لها في "استعلامات لغة الاستعلامات في "إحصاءات Google".

التقارير الأساسية المحدّدة مسبقًا	اسم مورد 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

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

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"