توفّر واجهة مستخدم "إعلانات Google" إمكانات إعداد التقارير. لإنشاء تقرير، سجِّل الدخول إلى حسابك على "إعلانات Google"، وانقر على الحملات في قائمة التنقّل على يمين الصفحة، ثم انقر على الإحصاءات والتقارير. لإنشاء تقرير من البداية، انقر على محرِّر التقارير.
يربط هذا الدليل بين مفاهيم إعداد التقارير الشائعة واصطلاحات التسمية في واجهة مستخدم "إعلانات Google" والتقارير التي يمكنك إنشاؤها باستخدام "لغة طلبات البحث في إعلانات Google" (GAQL) وGoogle Ads API. يمكنك أيضًا اتّباع الطلبات في واجهة المستخدم لإنشاء التقرير الذي يناسب متطلباتك على أفضل وجه.
الأدوات والموارد
للاطّلاع على أمثلة أكثر تفصيلاً والحصول على مساعدة آلية في ربط شاشات واجهة المستخدم بواجهة برمجة التطبيقات، يُرجى الرجوع إلى المَراجع التالية:
- كتاب وصفات الاستعلامات: مجموعة من طلبات بحث GAQL التي تنسخ البيانات المعروضة في العديد من شاشات واجهة مستخدم "إعلانات Google" الشائعة.
- إضافة "إعداد التقارير في Google Ads API": هي إضافة على Chrome تساعدك في تحديد أسماء موارد واجهة برمجة التطبيقات والحقول مباشرةً ضمن واجهة مستخدم "إعلانات Google".
مصطلحات واجهة المستخدم الشائعة
يلخّص الجدول التالي بعض المصطلحات الشائعة الاستخدام في واجهة المستخدم وعمليات الربط الخاصة بها مع لغة طلب البحث في "إعلانات Google" (GAQL).
| واجهة المستخدِم | GAQL |
|---|---|
| الأعمدة | أيّ مورد أو حقل شريحة أو مقياس في عبارة SELECT ضمن طلب بحث GAQL |
| النطاق الزمني | يتم ربط النطاقات الزمنية بشرط WHERE
يتم فيه الفلترة حسب segments.date. |
| الفلاتر | شرط واحد أو أكثر في عبارة WHERE |
| حقول شرائح الجمهور | طبِّق التصنيف إلى قطاعات أو شرائح من خلال تضمين حقول شرائح الجمهور في طلب بحث GAQL. |
| تقسيم المحتوى إلى صفحات | تؤدي التقسيم إلى صفحات إلى تقسيم مجموعة نتائج طلب البحث إلى صفحات متعددة. |
الأعمدة
تكون الأعمدة في واجهة المستخدِم مكافئة لاستخدام عبارة SELECT من أجل
حقول الموارد أو
حقول الشرائح أو
المقاييس في 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، لذا يجب أن ينسّق تطبيق العميل الردّ. راجِع نموذج رمز تقرير الحملة إلى ملف CSV للتعرّف على كيفية تنفيذ تنسيق ملف 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 |
| المحتوى > مواضع الإعلان | 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 لإنشاء تقرير مجمّع عن الحساب خلال آخر 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'