تتبُّع الشبكة
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
اختيار النظام الأساسي:
Android
iOS
تتيح لك ميزة "تتبُّع الشبكة" إمكانية الاطّلاع على أنشطة الشبكة المرتبطة بحزمة تطوير البرامج (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
يمكنك بعد ذلك تقديم نُسخ من السجلات إلى مهندسينا لإجراء التحليل.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-09-02 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-09-02 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eNetwork tracing provides insights into Google Mobile Ads SDK network activities, aiding in debugging your ad implementation.\u003c/p\u003e\n"],["\u003cp\u003eIt offers a debugging advantage over proxy tools by functioning on all iOS versions and devices without requiring third-party security certificate profiles.\u003c/p\u003e\n"],["\u003cp\u003eTo enable tracing, simply set the \u003ccode\u003eGADEnableNetworkTracing\u003c/code\u003e key to \u003ccode\u003eYES\u003c/code\u003e within your plist file.\u003c/p\u003e\n"],["\u003cp\u003eWhen enabled, the SDK logs network events to the console, which can be shared with Google engineers for analysis.\u003c/p\u003e\n"],["\u003cp\u003eConsole logs are easily identifiable, starting with \u003ccode\u003eGMA Debug BEGIN\u003c/code\u003e, \u003ccode\u003eGMA Debug CONTENT\u003c/code\u003e, or \u003ccode\u003eGMA Debug FINISH\u003c/code\u003e, allowing for efficient searching and filtering.\u003c/p\u003e\n"]]],[],null,["Select platform: [Android](/ad-manager/mobile-ads-sdk/android/network-tracing \"View this page for the Android platform docs.\") [iOS](/ad-manager/mobile-ads-sdk/ios/network-tracing \"View this page for the iOS platform docs.\")\n\n\u003cbr /\u003e\n\nNetwork tracing lets you see network activities relating to the\nGoogle Mobile Ads SDK. This can be useful in debugging your Google Mobile Ads\nimplementation.\n\nA key reason to use network tracing instead of tools such as [Charles\nProxy](//www.charlesproxy.com) is that it will work on **all** iOS versions and\ndevices without trusting any third party security certificate profiles. This is\nnot the case with proxying tools due [certificate profile\nrequirements](https://support.apple.com/en-nz/HT204477) in place since iOS 10.3.\n\nThis guide explains how to enable network tracing for debugging purposes.\n\nEnable tracing\n\nTo enable network tracing, set the `GADEnableNetworkTracing` key to `YES` in\nyour plist file.\n\nWhen network tracing is enabled, the Google Mobile Ads SDK logs network events\nto the console. You can then provide copies of the logs to our engineers for\nanalysis as a private reply on the [developer\nforum](//groups.google.com/forum/#!forum/google-admob-ads-sdk).\n\nLogging\n\nStandard platform-appropriate console logs are used to output the network logs.\n\nConsole log messages always begin with the string `GMA Debug BEGIN`,\n`GMA Debug CONTENT`, or `GMA Debug FINISH` so that it can be searched for or\nfiltered out. For each network log, the first log message is `GMA Debug BEGIN`,\nthe last log message is `GMA Debug FINISH`, and the network log content begins\nwith `GMA Debug CONTENT`. If a network log content is too long to fit on a line,\nit is split among multiple lines, each line beginning with `GMA Debug CONTENT`.\n\nSample output \n\n \u003cYour App Name\u003e[2710:30568] \u003cGoogle\u003e GMA Debug BEGIN\n 2017-12-06 09:47:09.268020-0800 \u003cYour App Name\u003e[2710:30568] \u003cGoogle\u003e GMA Debug CONTENT: {\n \"components\" : [\n \"network_request_31107D12-E54E-45D6-AEA9-4A303C659EDF\"\n ],\n \"timestamp\" : 1512582429267.2629,\n \"event\" : \"onNetworkRequest\",\n \"params\" : {\n \"firstline\" : {\n \"uri\" : \"\u003cencoded text\u003e\",\n \"verb\" : \"\u003cencoded text\u003e\"\n },\n \"headers\" : [\n {\n \"name\" : \"\u003cencoded text\u003e\",\n \"value\" : \"\u003cencoded text\u003e\"\n }\n ]\n }\n }\n 2017-12-06 09:47:09.275742-0800 \u003cYour App Name\u003e[2710:30568] \u003cGoogle\u003e GMA Debug FINISH\n\nYou can then [provide copies of the logs to our\nengineers](//groups.google.com/forum/#!forum/google-admob-ads-sdk) for analysis."]]
