네트워크 추적을 사용하면 Google 모바일 광고 SDK와 관련된 네트워크 활동을 확인할 수 있습니다. 이 기능은 Google 모바일 광고 구현을 디버깅할 때 유용할 수 있습니다.
Charles 프록시와 같은 도구 대신 네트워크 추적을 사용하는 주된 이유는
제3자 보안 인증서 프로필을 신뢰하지 않아도
모든 iOS 버전 및 기기에서 작동하기 때문입니다. 단,
프록싱 도구의 경우 iOS 10.3 이후의 인증서 프로필
요건 때문에 이렇게 작동하지 않습니다.
이 가이드에서는 디버깅을 위해 네트워크 추적을 사용 설정하는 방법을 설명합니다.
추적 사용 설정
네트워크 추적을 사용하려면 plist 파일에서 GADEnableNetworkTracing 키를 YES로 설정하세요.
네트워크 추적을 사용하면 Google 모바일 광고 SDK가 네트워크 이벤트를 콘솔에 기록합니다. 그런 다음 로그 복사본을 Google 엔지니어에 제공하면
분석 결과를 개발자 포럼에서 비공개 답변으로
받을 수 있습니다.
로깅
표준 플랫폼에 적합한 콘솔 로그는 네트워크 로그를 출력하는 데 사용됩니다.
콘솔 로그 메시지는 항상 GMA Debug BEGIN,
GMA Debug CONTENT 또는 GMA Debug FINISH 문자열로 시작하므로 검색 또는 필터링이
가능합니다. 각 네트워크 로그의 첫 번째 로그 메시지는 GMA Debug BEGIN이고,
마지막 로그 메시지는 GMA Debug FINISH이며, 네트워크 로그 내용은 GMA Debug CONTENT로
시작합니다. 네트워크 로그 내용이 한 행에 들어가지 못할 정도로
길면 여러 행으로 나눠지며, 각 행은 GMA Debug CONTENT로 시작합니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-09-03(UTC)"],[[["\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\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, 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."]]