توفّر واجهة مستخدم "إعلانات 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. |
| تقسيم الصفحات | تقسيم الصفحات يؤدي إلى تقسيم مجموعة نتائج طلب البحث إلى صفحات متعددة. |
الأعمدة
تعادل الأعمدة في واجهة المستخدم استخدام عبارة SELECT
لحقول الموارد أو
حقول الشرائح أو
المقاييس في لغة طلب البحث في "إعلانات Google" (GAQL).
لمزيد من المعلومات، يُرجى الاطّلاع على مقالة لمحة عن الأعمدة في جدول الإحصاءات.
النطاقات الزمنية
تحتوي واجهة مستخدم "إعلانات Google" على جدول يعرض إحصاءات الحساب، وقائمة منسدلة للتحكّم في النطاق الزمني لهذه الإحصاءات.
يمكنك التحكّم في ذلك في لغة طلب البحث في "إعلانات Google" (GAQL) من خلال الفلترة حسب segments.date في عبارة WHERE لطلب بحث GAQL.
الفلاتر
تُعادل الفلاتر في واجهة المستخدِم شرطًا واحدًا أو أكثر في
عبارة WHERE من لغة طلب البحث في Google Ads.
لمزيد من المعلومات، يُرجى الاطّلاع على مقالة فلترة طريقة عرض بيانات الأداء.
التقسيم
للحصول على إحصاءات أكثر تفصيلاً، يمكنك تقسيم البيانات حسب الشرائح. على سبيل المثال، لنفترض أنّك تريد الاطّلاع على عدد مرّات الظهور الخاصة بـ "شبكة بحث Google" بشكل منفصل عن "شبكة Google الإعلانية". في هذه الحالة، يمكنك تقسيم تقريرك حسب الشبكة. يُرجى الاطّلاع على التقسيم لمعرفة كيفية تضمين حقول الأقسام في عبارة SELECT.
تقسيم النتائج على عدّة صفحات
يمكنك التنقّل في تقاريرك في واجهة المستخدم باستخدام عناصر التحكّم المتاحة في أسفل كل جدول بيانات، والتي تتيح لك تبديل الصفحات واختيار عدد النتائج التي تريد عرضها من مجموعة محدّدة من الأحجام.
للتنقّل بين صفحات النتائج عند استرداد التقارير، استخدِم
GoogleAdsService.Search مع
next_page_token. لجلب مجموعة النتائج بالكامل
بدون أي تقسيم للصفحات، استخدِم
GoogleAdsService.SearchStream.
ترتيب النتائج
في واجهة المستخدم، يمكنك ترتيب النتائج من خلال اختيار عمود.
في لغة GAQL، يمكنك استخدام عبارة ORDER BY وعبارة LIMIT لترتيب نتائج طلب البحث وحصرها.
تنسيقات التنزيل
في واجهة المستخدم، يمكن تنزيل التقارير بتنسيقات مختلفة، مثل CSV أو TSV أو XML.
لا تنسّق واجهة برمجة التطبيقات المخرجات مباشرةً في ملفات مثل CSV، لذا يجب أن ينسّق تطبيق العميل الاستجابة. اطّلِع على نموذج رمز تقرير الحملة إلى ملف CSV للتعرّف على كيفية تنفيذ تنسيق ملف CSV في برنامج عميل.
جدولة التقارير وإرسالها عبر البريد الإلكتروني
يمكنك جدولة تقرير وإرساله عبر البريد الإلكتروني من واجهة المستخدم، ولكن هذه الميزات غير متاحة في واجهة برمجة التطبيقات.
ربط طرق عرض واجهة المستخدم بموارد واجهة برمجة التطبيقات
في ما يلي قائمة بطرق العرض الشائعة في واجهة المستخدم واسم مورد GAQL المطابق لها.
| طرق عرض واجهة المستخدم | اسم مورد GAQL (يجب تحديده في عبارة FROM) |
|---|---|
| Account | customer |
| الحملة، تفاصيل الحملة |
campaign |
| المجموعة الإعلانية، تفاصيل المجموعة الإعلانية |
ad_group |
| مجموعات مواد العرض | asset_group |
|
إعلان، رابط عنوان URL النهائي |
ad_group_ad |
| المنتجات | shopping_performance_view, shopping_product |
| كلمة البحث الرئيسية | keyword_view |
| عبارات البحث | search_term_view, campaign_search_term_view |
| النتائج المدفوعة والمجانية (نموذج معاينة أداء المنافسين)* |
paid_organic_search_term_view |
| الصفحة المقصودة | landing_page_view |
| الصفحة المقصودة الموسَّعة | expanded_landing_page_view |
| المحتوى > مواضع الإعلان | managed_placement_view |
| المحتوى > مكان عرض الإعلانات | group_placement_view |
| المحتوى > مواضع ظهور الإعلانات > عرض التفاصيل | detail_placement_view |
| موضع الإعلان في حملات الأداء الأفضل | performance_max_placement_view |
| المحتوى > المواضيع | topic_view |
| الجمهور | ad_group_audience_view, campaign_audience_view |
| شرائح الجمهور > الخصائص الديمغرافية > العمر | age_range_view |
| شرائح الجمهور > الخصائص الديمغرافية > الجنس | gender_view |
| المواقع الجغرافية | location_view |
| المواقع الجغرافية > التقرير الجغرافي | geographic_view |
* لإنشاء تقرير نتائج البحث المدفوعة والمجانية، يجب ربط حساب على Google Search Console بحسابك على "إعلانات 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'