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