توفّر واجهة مستخدم "إعلانات 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'