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