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