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