네트워크 추적
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
네트워크 추적을 사용하면 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로 시작합니다.
샘플 출력
<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
그런 다음 로그 복사본을 Google 엔지니어에게 제공하여 분석을 요청할 수 있습니다.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-09-02(UTC)
[null,null,["최종 업데이트: 2025-09-02(UTC)"],[[["\u003cp\u003eNetwork tracing allows debugging of the Google Mobile Ads SDK by revealing network activities.\u003c/p\u003e\n"],["\u003cp\u003eIt works on all iOS versions and devices without needing third-party security certificate profiles, unlike proxying tools.\u003c/p\u003e\n"],["\u003cp\u003eTo enable, set the \u003ccode\u003eGADEnableNetworkTracing\u003c/code\u003e key to \u003ccode\u003eYES\u003c/code\u003e in your app's plist file.\u003c/p\u003e\n"],["\u003cp\u003eNetwork event logs are output to the console, starting with "GMA Debug BEGIN" and ending with "GMA Debug FINISH".\u003c/p\u003e\n"],["\u003cp\u003eShare the console logs with Google engineers for analysis to help with debugging.\u003c/p\u003e\n"]]],["Network tracing, used for debugging the Google Mobile Ads SDK, works on all iOS versions without needing third-party security certificates. To enable it, set `GADEnableNetworkTracing` to `YES` in your plist file. Network events are logged to the console, with messages starting with `GMA Debug BEGIN`, `GMA Debug CONTENT`, or `GMA Debug FINISH`. These logs can then be provided to engineers for analysis via the developer forum. Each network log includes content, timestamp, and event parameters.\n"],null,["Select platform: [Android](/admob/android/network-tracing \"View this page for the Android platform docs.\") [iOS](/admob/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."]]
