يتناول هذا الدليل بعض أفضل الممارسات التي يمكنك تنفيذها لتحسين كفاءة تطبيقاتك وأدائها.
صيانة تطبيقك
لضمان تشغيل تطبيقك بدون انقطاع، اتّبِع الخطوات التالية:
تأكَّد من أنّ قائمة المالكين والمحرّرين لمشروعك على 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 تطبيقك للحصول على مستويات أعلى من إذن الوصول إلى واجهة برمجة التطبيقات.