تتبع الشبكة

تتيح لك ميزة "تتبُّع الشبكة" الاطّلاع على أنشطة الشبكة المرتبطة بحزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة. ويمكن أن يكون هذا مفيدًا في تصحيح الأخطاء في تنفيذ إعلانات Google للجوّال.

من الأسباب الرئيسية لاستخدام ميزة "تتبّع الشبكة" بدلاً من أدوات مثل Charles Proxy هو أنّها تعمل على جميع إصدارات وأجهزة iOS بدون الوثوق في أي ملفات شخصية لشهادات أمان تابعة لجهات خارجية. وهذا لا ينطبق على أدوات إنشاء خوادم وكيلة بسبب متطلبات ملف الشهادة السارية منذ نظام التشغيل iOS 10.3.

يشرح هذا الدليل كيفية تفعيل تتبع الشبكة لأغراض تصحيح الأخطاء.

تمكين التتبع

لتفعيل ميزة "تتبُّع الشبكة"، اضبط مفتاح GADEnableNetworkTracing على YES في ملف plist.

عند تفعيل تتبُّع الشبكة، تسجِّل حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" أحداث الشبكة في وحدة التحكّم. ويمكنك بعد ذلك تقديم نسخ من السجلات إلى مهندسينا لتحليلها كرد خاص في منتدى المطوّرين.

التسجيل

يتم استخدام سجلات وحدة التحكم القياسية الملائمة للنظام الأساسي لإخراج سجلات الشبكة.

تبدأ رسائل سجلّ وحدة التحكّم دائمًا بالسلسلة GMA Debug BEGIN أو GMA Debug CONTENT أو GMA Debug FINISH بحيث يمكن البحث عنها أو فلترتها. بالنسبة إلى كل سجلّ شبكة، تكون رسالة السجلّ الأولى هي GMA Debug BEGIN، وآخر رسالة في السجلّ هي GMA Debug FINISH، ويبدأ محتوى سجلّ الشبكة بـ GMA Debug CONTENT. إذا كان محتوى سجلّ الشبكة طويلاً جدًا بحيث يتعذّر عرضه على سطر، يتم تقسيمه على عدة أسطر، بحيث يبدأ كل سطر بـ GMA Debug CONTENT.

ناتج النموذج

<Your App Name>[2710:30568] <Google> GMA Debug BEGIN
2017-12-06 09:47:09.268020-0800 <Your App Name>[2710:30568] <Google> GMA Debug CONTENT: {
  "components" : [
    "network_request_31107D12-E54E-45D6-AEA9-4A303C659EDF"
  ],
  "timestamp" : 1512582429267.2629,
  "event" : "onNetworkRequest",
  "params" : {
    "firstline" : {
      "uri" : "<encoded text>",
      "verb" : "<encoded text>"
    },
    "headers" : [
      {
        "name" : "<encoded text>",
        "value" : "<encoded text>"
      }
    ]
  }
}
2017-12-06 09:47:09.275742-0800 <Your App Name>[2710:30568] <Google> GMA Debug FINISH

ويمكنك بعد ذلك تقديم نسخ من السجلات إلى المهندسين لدينا لتحليلها.