يتناول هذا الدليل بعض أفضل الممارسات التي يمكنك تنفيذها لتحسين كفاءة تطبيقاتك وأدائها.
صيانة تطبيقك
لضمان تشغيل تطبيقك بدون انقطاع، يُرجى اتّباع الخطوات التالية:
تأكَّد من أنّ قائمة المالكين والمحرِّرين لمشروعك على 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 أو فلترة العناصر التي تم تعديلها مؤخرًا لمزامنة
التغييرات بشكل تدريجي.
أخطاء السجلّ
يجب تسجيل جميع الأخطاء لتسهيل تصحيح الأخطاء والمراقبة. At a minimum, log the request ID, the operations that caused the error, and the error itself. تشمل المعلومات الأخرى التي يجب تسجيلها رقم تعريف العميل وخدمة واجهة برمجة التطبيقات ووقت استجابة طلب الذهاب والعودة وعدد مرات إعادة المحاولة والطلب الأولي الذي تم تنقيحه والاستجابة (مع التأكد من تنقيح بيانات الاعتماد الحساسة مثل رموز OAuth المميزة وأي معلومات تكشف الهوية الشخصية).
مراقبة المؤشرات
احرص على مراقبة المؤشرات في أخطاء واجهة برمجة التطبيقات حتى تتمكّن من رصد المشاكل في تطبيقك ومعالجتها. ننصحك بإنشاء حلّ خاص بك أو استخدام إحدى الأدوات التجارية العديدة المتاحة التي يمكنها استخدام سجلّاتك لإنشاء لوحات بيانات تفاعلية وإرسال تنبيهات مبرمَجة.
تطوير
استخدِم حسابات اختبارية أثناء عملية التطوير.
استخدام حسابات اختبارية
الحسابات الاختبارية هي حسابات على "إعلانات Google" لا تعرض الإعلانات فعليًا. يمكنك استخدام حساب اختباري لتجربة Google Ads API والتأكّد من أنّ اتصال تطبيقك أو منطق إدارة الحملات أو أي معالجة أخرى تعمل على النحو المتوقع. يحتاج مشروعك على Google Cloud إلى مستوى الوصول التجريبي فقط لاستخدامه في حساب تجريبي، حتى تتمكّن من بدء التطوير باستخدام Google Ads API على الفور، أثناء انتظار مراجعة Google لطلبك للحصول على مستويات وصول أعلى إلى واجهة برمجة التطبيقات.