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