يُعدّ إعداد تقارير بيانات الأداء جزءًا لا يتجزأ من تطبيقات Google Ads API. باستخدام خيارات إعداد التقارير المرنة في واجهة برمجة التطبيقات، يمكنك الحصول على بيانات الأداء لجميع الموارد التي يمكن البحث عنها، بدءًا من حملة كاملة ووصولاً إلى الكلمات الرئيسية المحدّدة التي أدّت إلى ظهور إعلانك.
لاسترداد بيانات التقارير في Google Ads API، يمكنك إنشاء طلب بحث باستخدام لغة طلبات البحث في "إعلانات Google" (GAQL) التي تحدّد المورد المستهدَف في عبارة FROM والسمات والشرائح والمقاييس المحدّدة في عبارة SELECT. بعد ذلك، يمكنك إرسال طلب البحث إلى GoogleAdsService.SearchStream (لبث مجموعة البيانات بأكملها عبر اتصال واحد) أو GoogleAdsService.Search (للتنقّل بين النتائج). للاطّلاع على قائمة كاملة بالمراجع والحقول والمقاييس التي يمكن البحث فيها، يُرجى الرجوع إلى المستندات المرجعية الخاصة بالتقارير.
الخطوات التالية
انتقِل إلى القسم من هذا الدليل الذي يناسب حالة الاستخدام الخاصة بك:
- تجربة مثال سريع
- استرداد مقاييس أداء المعايير
- تقسيم بيانات تقريرك
- التعامل مع الصفوف التي تتضمّن مقاييس صفرية
- استخدام التصنيفات لتنظيم التقارير وفلترتها
- بثّ بيانات التقارير باستخدام SearchStream
- التنقّل بين مجموعات النتائج الكبيرة
- ربط تقارير واجهة المستخدِم بموارد واجهة برمجة التطبيقات
- مراجعة بنية "لغة طلبات البحث في إعلانات Google"
- إدارة بيانات التقارير بكفاءة