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

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

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

يلخِّص الجدول التالي بعض المصطلحات الشائعة المستخدَمة في واجهة المستخدِم ومقاييسها إلى لغة طلبات البحث في "إعلانات Google" (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".

على سبيل المثال من الجدول السابق، يمكنك استخدام لغة الاستعلامات في "إحصاءات 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"