التقارير في واجهة مستخدم "إعلانات 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.
تقسيم الصفحات	تؤدي Paging إلى تقسيم مجموعة نتائج طلب البحث إلى صفحات متعددة.

الأعمدة

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

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

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

تحتوي واجهة مستخدم "إعلانات 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، لذا يجب أن ينسّق تطبيق العميل الردّ. اطّلِع على نموذج رمز تقرير الحملة إلى ملف CSV للتعرّف على كيفية تنفيذ تنسيق ملف CSV في برنامج عميل.

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

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

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

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

طرق عرض واجهة المستخدم	اسم مورد GAQL (يجب تحديده في عبارة FROM)
Account	العميل
الحملة، تفاصيل الحملة	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" على مستوى العميل.

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