توفّر واجهة مستخدِم "إعلانات Google" إمكانيات إعداد التقارير. لإنشاء تقرير، سجِّل الدخول إلى حسابك على "إعلانات Google". انقر على الحملات على يمين الصفحة، ثمّ انقر على الإحصاءات والتقارير. لإنشاء تقرير من البداية، انقر على محرّر التقارير.
يربط هذا الدليل مفاهيم إعداد التقارير الشائعة واصطلاحات التسمية في واجهة مستخدِم "إعلانات Google" بالتقارير التي يمكنك إنشاؤها باستخدام "لغة طلبات بحث إعلانات Google" (GAQL) وGoogle Ads API. يمكنك أيضًا اتّباع التعليمات في واجهة المستخدِم لإنشاء التقرير الذي يناسب متطلباتك على أفضل وجه.
الأدوات والموارد
لمزيد من الأمثلة التفصيلية والمساعدة الآلية في ربط شاشات واجهة المستخدِم بواجهة برمجة التطبيقات، اطّلِع على المَراجع التالية:
- **Query Cookbook**: مجموعة من طلبات بحث GAQL التي تكرّر البيانات المعروضة على العديد من شاشات واجهة مستخدِم "إعلانات Google" الشائعة.
- Google Ads API Reporting Extension: إضافة Chrome تساعدك في تحديد أسماء حقول وموارد واجهة برمجة التطبيقات مباشرةً ضمن واجهة مستخدِم "إعلانات Google".
مصطلحات واجهة المستخدِم الشائعة
يلخّص الجدول التالي بعض المصطلحات الشائعة المستخدَمة في واجهة المستخدِم و عمليات الربط الخاصة بها مع "لغة طلبات بحث إعلانات Google" (GAQL).
| واجهة المستخدِم | GAQL |
|---|---|
| الأعمدة | أيّ مورد أو حقل شريحة أو مقياس في عبارة SELECT لطلب بحث GAQL. |
| النطاق الزمني | ترتبط النطاقات الزمنية بعبارة WHERE
التي يتم فيها الفلترة استنادًا إلى segments.date. |
| الفلاتر | شرط واحد أو أكثر في عبارة WHERE. |
| حقول الشرائح | يمكنك تطبيق تصنيف إلى قطاعات أو شرائح من خلال تضمين حقول الشرائح في طلب بحث GAQL. |
| تقسيم النتائج على عدّة صفحات | يقسّم تقسيم النتائج مجموعة نتائج طلب البحث إلى صفحات متعدّدة. |
الأعمدة
تُعادل الأعمدة في واجهة المستخدِم استخدام عبارة SELECT لـ حقول الموارد، أو حقول الشرائح، أو المقاييس في GAQL.
اطّلِع على مقالة لمحة عن الأعمدة في جدول الإحصاءات
النطاقات الزمنية
تحتوي واجهة مستخدِم "إعلانات Google" على جدول يعرض إحصاءات الحساب، وقائمة منسدلة للتحكّم في النطاق الزمني لهذه الإحصاءات.
يمكنك التحكّم بالطريقة نفسها في GAQL من خلال الفلترة استنادًا إلى
segments.date في عبارة WHERE لطلب بحث GAQL.
الفلاتر
تُعادل الفلاتر في واجهة المستخدِم شرطًا واحدًا أو أكثر في الـ WHERE clause لـ GAQL.
اطّلِع على مقالة فلترة طريقة عرض بيانات الأداء.
التقسيم
للحصول على إحصاءات أكثر تفصيلاً، قسِّم البيانات حسب الشرائح. على سبيل المثال، لنفترض أنّك تريد الاطّلاع على عدد مرّات الظهور الخاصة بشبكة بحث Google بشكلٍ منفصل عن شبكة Google الإعلانية. في هذه الحالة، قسِّم تقريرك حسب الشبكة. اطّلِع على مقالة التقسيم لمعرفة كيفية تضمين حقول الشرائح في عبارة SELECT.
تقسيم النتائج على عدّة صفحات
يمكنك الانتقال بين تقاريرك في واجهة المستخدِم باستخدام عناصر التحكّم المتاحة في أسفل كل جدول بيانات، والتي تتيح لك تبديل الصفحات واختيار عدد النتائج التي تريد عرضها من مجموعة محدّدة من الأحجام.
تتوفّر إمكانية الانتقال بين النتائج عند استرداد التقارير باستخدام
GoogleAdsService.Search من خلال
next_page_token. لاسترداد مجموعة النتائج بالكامل
بدون أيّ تقسيم، استخدِم
GoogleAdsService.SearchStream.
ترتيب النتائج
في واجهة المستخدِم، يمكنك ترتيب النتائج من خلال اختيار عمود.
في GAQL، يمكنك استخدام عبارتَي ORDER BY و LIMIT لترتيب نتيجة طلب البحث.
تنسيقات التنزيل
في واجهة المستخدِم، يمكن تنزيل التقارير بتنسيقات مختلفة، مثل CSV أو TSV أو XML.
لا تتيح واجهة برمجة التطبيقات بشكلٍ مباشر تنسيقات مختلفة في ناتجها، لذا عليك إجراء بعض المعالجة اللاحقة. اطّلِع على مثال الرمز البرمجي هذا الذي يوضّح كيفية تنفيذ تنسيق CSV في أحد العملاء.
جدولة التقارير وإرسالها بالبريد الإلكتروني
يمكنك جدولة تقرير وإرساله بالبريد الإلكتروني من واجهة المستخدِم، ولكن لا تتوفّر هاتان الميزتان في واجهة برمجة التطبيقات.
ربط طرق عرض واجهة المستخدِم بموارد واجهة برمجة التطبيقات
في ما يلي قائمة بطرق عرض واجهة المستخدِم الشائعة وأسماء موارد GAQL المطابقة لها.
| طرق عرض واجهة المستخدِم | اسم مورد GAQL (حدِّده في عبارة FROM) |
|---|---|
| الحساب | العميل |
| الحملة، تفاصيل الحملة |
الحملة |
| المجموعة الإعلانية، تفاصيل المجموعة الإعلانية |
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" على مستوى العميل.
كمثال من الجدول السابق، يمكنك استخدام 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'