يتناول هذا الدليل بعض أفضل الممارسات التي يمكنك تنفيذها لتحسين كفاءة تطبيقاتك وأدائها.
صيانة تطبيقك
لضمان تشغيل تطبيقك بدون انقطاع، يُرجى اتّباع الخطوات التالية:
تأكَّد من أنّ قائمة المالكين والمحرّرين لمشروعك على Google Cloud محدَّثة. سنتواصل مع هؤلاء المستخدمين في حال حدوث أي حالات طارئة أو مواضيع متعلقة بالامتثال لأحكام وشروط واجهة برمجة التطبيقات. إذا لم نتمكّن من التواصل معك بشأن الامتثال لأحكام وشروط واجهة برمجة التطبيقات، قد يتم خفض مستوى إذن وصولك إلى واجهة برمجة التطبيقات أو إلغاؤه.
للاطّلاع على المشاكل، مثل التغييرات في المنتجات وفترات التوقّف للصيانة وتواريخ الإيقاف النهائي، يمكنك الاشتراك في مدوّنة واجهة برمجة التطبيقات ومدوّنة المنتجات.
يجب أن يظل تطبيقك متوافقًا مع أحكام وشروط Google Ads API. إذا لزم الأمر، سيتواصل فريق الامتثال لواجهة برمجة التطبيقات مع مالكي ومحرّري مشروعك على Google Cloud الذين لديهم إذن الوصول إلى واجهة برمجة التطبيقات. إذا كانت لديك أسئلة أو استفسارات بشأن الأحكام والشروط، يمكنك التواصل مع فريق الامتثال من خلال الردّ على الرسالة الإلكترونية التي أرسلها إليك عند مراجعة طلبك للوصول إلى واجهة برمجة التطبيقات.
تحسين
يمكنك تحسين تطبيقك من خلال تنفيذ عمليات مجمّعة، وإرسال كائنات متفرقة، إذا كان ذلك مناسبًا.
عمليات مجمعة
يتطلب تقديم طلب إلى واجهة برمجة التطبيقات عددًا من التكاليف الثابتة، مثل وقت استجابة الشبكة ذهابًا وإيابًا، ومعالجة التسلسل وإلغاء التسلسل، والطلبات إلى أنظمة الخلفية. لتقليل تأثير هذه التكاليف الثابتة وتحسين الأداء العام، تم تصميم معظم طرق التغيير في واجهة برمجة التطبيقات لقبول مصفوفة من العمليات. من خلال تجميع عمليات متعددة في كل طلب، يمكنك تقليل عدد الطلبات التي ترسلها والتكاليف الثابتة المرتبطة بها. ننصحك بتجنُّب إرسال طلبات تتضمّن عملية واحدة فقط، إن أمكن.
على سبيل المثال، لنفترض أنّك تضيف 50,000 كلمة رئيسية إلى حملة في عدة مجموعات إعلانية. بدلاً من إرسال 50,000 طلب يتضمّن كل منها كلمة رئيسية واحدة، أرسِل 100 طلب يتضمّن كل منها 500 كلمة رئيسية، أو حتى 10 طلبات يتضمّن كل منها 5,000 كلمة رئيسية. هناك حدود لعدد العمليات المسموح بها في الطلب، لذا قد تحتاج إلى تعديل حجم الدفعة لتحقيق الأداء الأمثل.
إرسال عناصر متفرقة
عند إرسال عناصر إلى واجهة برمجة التطبيقات، يجب إلغاء تسلسل الحقول والتحقّق من صحتها وتخزينها في قاعدة البيانات. قد يؤدي إدخال كائنات كاملة عندما تريد تعديل بضعة حقول فقط إلى استغراق وقت معالجة إضافي وانخفاض الأداء. وللحدّ من هذه المشكلة، تتيح Google Ads API إجراء تعديلات متفرقة، ما يسمح لك بملء الحقول التي تحتاج إلى تغييرها أو المطلوبة فقط في عنصر معيّن.
تتم معالجة التعديلات المتفرقة بشكل أسرع، ومن غير المرجّح أن تؤدي إلى حدوث أخطاء. أما الحقول التي لا تظهر في update_mask (المعروفة أيضًا باسم FieldMask)، فستبقى بدون تغيير.
على سبيل المثال، يمكن أن يستفيد التطبيق الذي يعدّل عروض الأسعار على مستوى الكلمة الرئيسية من استخدام التعديلات المتفرقة، لأنّه لن يحتاج سوى إلى ملء حقول رقم تعريف المجموعة الإعلانية ورقم تعريف المعيار وعروض الأسعار.
معالجة الأخطاء وإدارتها
أثناء عملية التطوير، من المحتمل أن تواجه أخطاء. يصف هذا القسم الاعتبارات والاستراتيجيات اللازمة لإنشاء إدارة الأخطاء في تطبيقك. بالإضافة إلى هذا القسم، يمكنك زيارة دليل تحديد المشاكل وحلّها للحصول على مزيد من المعلومات حول إدارة الأخطاء.
التمييز بين مصادر الطلبات
بعض التطبيقات تفاعلية في المقام الأول، وتصدر طلبات بيانات من واجهة برمجة التطبيقات مباشرةً استجابةً للإجراءات التي يبدأها المستخدم في واجهة المستخدم. وتعمل تطبيقات أخرى بلا إنترنت بشكل أساسي، وتصدر طلبات بيانات من واجهة برمجة التطبيقات كجزء من عملية دورية في الخلفية. وتجمع العديد من التطبيقات بين الاثنين. عند التفكير في إدارة الأخطاء، قد يكون من المفيد التمييز بين هذه الأنواع المختلفة من الطلبات.
بالنسبة إلى الطلبات التي يبدأها المستخدمون، يجب أن يكون اهتمامك الأساسي هو تقديم تجربة جيدة لهم. استخدِم الخطأ المحدّد الذي حدث لتزويد المستخدم بأكبر قدر ممكن من السياق في واجهة المستخدم. قدِّم خطوات واضحة يمكنهم اتّخاذها لحلّ الخطأ (اطّلِع على الاقتراحات التالية).
بالنسبة إلى الطلبات التي يتم إرسالها من الخلفية، عليك تنفيذ معالجات لأنواع الأخطاء المختلفة التي قد يواجهها تطبيقك. يجب دائمًا تضمين معالج تلقائي لمعالجة الأخطاء النادرة أو التي لم يسبق مواجهتها. من الأساليب الجيدة للمعالج التلقائي إضافة العملية الفاشلة والخطأ إلى قائمة انتظار ليقوم عامل بشري بمراجعتها وتحديد الحل المناسب.
تمييز أنواع الأخطاء
يُعدّ معرفة الاختلافات بين أنواع الأخطاء في Google Ads API أمرًا بالغ الأهمية عند إنشاء معالجة قوية للأخطاء. في ما يلي بعض أنواع الأخطاء الأكثر شيوعًا:
- أخطاء المصادقة
- الأخطاء التي يمكن إعادة المحاولة فيها
- أخطاء التحقّق من الصحة
- الأخطاء المتعلّقة بالمزامنة
يُرجى الرجوع إلى أنواع الأخطاء والأخطاء الشائعة لمزيد من التفاصيل.
الخدمات الخلفية للمزامنة
إذا كان بإمكان مستخدمي تطبيقك الوصول يدويًا إلى حسابات "إعلانات Google"، فقد يُجرون تغييرات لا يعرفها تطبيقك، ما يؤدي إلى عدم مزامنة قاعدة البيانات المحلية لتطبيقك. كما هو موضّح في دليل أنواع الأخطاء، يمكنك معالجة الأخطاء المرتبطة بالمزامنة بشكل تفاعلي عند حدوثها، ولكن يمكنك أيضًا محاولة منع حدوثها بشكل استباقي. إحدى الاستراتيجيات الاستباقية هي تنفيذ مهمة مزامنة دورية للتوفيق بين قاعدة البيانات المحلية وعناصر "إعلانات Google" في حساباتك. بالنسبة إلى التسلسلات الهرمية الكبيرة للحسابات، تجنَّب سحب جميع العناصر من كل حساب كل ليلة لمنع استنفاد الحصص اليومية، وبدلاً من ذلك، استخدِم طلبات بحث ChangeStatus أو فلاتر للكيانات التي تم تعديلها مؤخرًا لمزامنة التغييرات بشكل تدريجي.
أخطاء في السجلّ
يجب تسجيل جميع الأخطاء لتسهيل تصحيح الأخطاء والمراقبة. يجب تسجيل رقم تعريف الطلب والعمليات التي تسبّبت في حدوث الخطأ والخطأ نفسه كحد أدنى. تشمل المعلومات الأخرى التي يجب تسجيلها رقم تعريف العميل وخدمة واجهة برمجة التطبيقات ووقت استجابة الطلب ذهابًا وإيابًا وعدد المحاولات وإزالة البيانات الحسّاسة من الطلب والاستجابة الأوليين (مع الحرص على إخفاء محتوى بيانات الاعتماد الحسّاسة، مثل رموز OAuth المميزة وأي معلومات تكشف الهوية الشخصية).
مراقبة المؤشرات
احرص على تتبُّع المؤشرات في أخطاء واجهة برمجة التطبيقات حتى تتمكّن من رصد المشاكل في تطبيقك ومعالجتها. يمكنك إنشاء حلّك الخاص أو استخدام إحدى الأدوات التجارية العديدة المتاحة التي يمكنها استخدام سجلّاتك لإنشاء لوحات بيانات تفاعلية وإرسال تنبيهات تلقائية.
تطوير
استخدِم حسابات اختبارية أثناء عملية التطوير.
استخدام حسابات اختبارية
حسابات الاختبار هي حسابات على "إعلانات Google" لا تعرض إعلانات فعليًا. يمكنك استخدام حساب اختباري لتجربة Google Ads API والتحقّق من أنّ اتصال تطبيقك أو منطق إدارة الحملات أو أي معالجة أخرى تعمل على النحو المتوقّع. يحتاج مشروعك على Google Cloud إلى مستوى الوصول "اختبار" فقط ليتم استخدامه على حساب اختباري، حتى تتمكّن من بدء التطوير باستخدام Google Ads API على الفور، أثناء انتظار مراجعة Google لطلبك للحصول على مستويات وصول أعلى إلى واجهة برمجة التطبيقات.