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