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