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

اختيار النظام الأساسي: Android iOS

اعتبارًا من الإصدار 13.0.0، لم تعُد ميزة "تتبّع الشبكة" متاحة.

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

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

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

تمكين التتبع

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

عند تفعيل ميزة "تتبّع الشبكة"، تسجِّل Google Mobile Ads SDK أحداث الشبكة في وحدة التحكّم.

التسجيل

تُستخدم سجلّات وحدة التحكّم العادية المناسبة للنظام الأساسي لعرض سجلّات الشبكة.

تبدأ دائمًا رسائل سجلّ وحدة التحكّم بالعبارة 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