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