ردیابی شبکه
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
پلتفرم را انتخاب کنید: Android iOS ردیابی شبکه به شما امکان می‌دهد فعالیت‌های شبکه مربوط به Google Mobile Ads SDK را مشاهده کنید. این می تواند در اشکال زدایی پیاده سازی تبلیغات تلفن همراه گوگل شما مفید باشد.
یک دلیل کلیدی برای استفاده از ردیابی شبکه به جای ابزارهایی مانند چارلز پروکسی این است که بر روی تمام نسخه‌ها و دستگاه‌های iOS بدون اعتماد به پروفایل‌های گواهی امنیتی شخص ثالث کار می‌کند. این مورد در مورد ابزارهای پروکسی به دلیل الزامات مشخصات گواهینامه از iOS 10.3 وجود ندارد.
این راهنما نحوه فعال کردن ردیابی شبکه را برای اهداف اشکال زدایی توضیح می دهد.
ردیابی را فعال کنید
برای فعال کردن ردیابی شبکه، کلید GADEnableNetworkTracing را در فایل plist خود روی YES قرار دهید.
وقتی ردیابی شبکه فعال است، 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
سپس می توانید کپی هایی از گزارش ها را برای تحلیل در اختیار مهندسان ما قرار دهید .
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده 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."]]
