تتبُّع الشبكة

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

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

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

تمكين التتبع

لتفعيل تتبُّع الشبكة، اضبط مفتاح 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

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