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

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

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

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

واجهة المستخدم	واجهة برمجة التطبيقات Google Cloud Platform ( GAQL)
الأعمدة	أي مورد أو حقل شريحة أو مقياس في عبارة 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 و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"