Rastreamento de rede
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Selecione a plataforma:
Android
iOS
O rastreamento de rede permite ver as atividades relacionadas ao SDK dos anúncios para dispositivos móveis do Google. Isso pode ser útil para depurar sua implementação do Google Mobile Ads.
Um dos principais motivos para usar o rastreamento de rede em vez de ferramentas como o Charles
Proxy é que ele funciona em todas as versões e dispositivos iOS sem confiar em perfis de certificados de segurança de terceiros. Não é o caso das ferramentas de proxy devido aos requisitos de perfil de certificado em vigor desde o iOS 10.3.
Este guia explica como ativar o rastreamento de rede para fins de depuração.
Ativar rastreamento
Para ativar o rastreamento de rede, defina a chave GADEnableNetworkTracing como YES no
arquivo plist.
Quando o rastreamento de rede está ativado, o SDK dos anúncios para dispositivos móveis do Google registra eventos de rede
no console. Em seguida, envie cópias dos registros aos nossos engenheiros para análise como uma resposta particular no fórum de desenvolvedores.
Logging
Os registros de console padrão adequados à plataforma são usados para gerar os registros de rede.
As mensagens de registro do console sempre começam com a string GMA Debug BEGIN, GMA Debug CONTENT ou GMA Debug FINISH para que possam ser pesquisadas ou filtradas. Para cada registro de rede, a primeira mensagem é GMA Debug BEGIN, a última é GMA Debug FINISH e o conteúdo começa com GMA Debug CONTENT. Se o conteúdo de um registro de rede for muito longo para caber em uma linha,
ele será dividido em várias linhas, cada uma começando com GMA Debug CONTENT.
Exemplo de saída
<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
Em seguida, envie cópias dos registros aos nossos engenheiros para análise.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-09-03 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-09-03 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\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."]]
