聯播網追蹤

透過聯播網追蹤功能,您可以查看 Google Mobile Ads SDK 的相關網路活動,這有助於對 Google Mobile Ads 導入作業進行偵錯。

使用聯播網追蹤功能 (而非 Charles Proxy 等工具) 的主要原因是,這項功能適用於所有 Android 版本,以及搭載支援 Google Play 服務版本的裝置。但 Proxy 工具並非如此,因為 Android 7.0 起採用的信任 CA 和憑證有所變更。

本指南說明如何啟用聯播網追蹤功能,以便偵錯。

Enable tracing

如要啟用聯播網追蹤,請在裝置上啟用開發人員選項。接著,啟動「Google 設定」應用程式,然後選取「廣告」選項:

假設您已啟用開發人員選項,且該功能可用,畫面會如下所示:

選取「啟用廣告偵錯記錄」選項,開啟下列對話方塊:

輕觸「確定」,系統就會顯示結尾為 10ca1ad1abe1 的廣告 ID:

現在,您可以在 logcat 中查看網路記錄的所有輸出內容。如要篩選出僅輸出至畫面和檔案的資訊層級廣告,請發出下列指令:

adb logcat '*:S' Ads:I Ads-cont:I | tee logs.txt

輸出內容

系統會使用適合平台的標準控制台記錄,輸出網路記錄。

控制台記錄訊息一律以字串 GMA Debug BEGIN、GMA Debug CONTENT 或 GMA Debug FINISH 開頭,因此您可以搜尋或篩選這些字串。在每個網路記錄中,第一則記錄訊息為 GMA Debug BEGIN,最後一則記錄訊息為 GMA Debug FINISH,網路記錄內容則以 GMA Debug CONTENT 開頭。如果內容太長,無法容納在一行中,則會分割成多行,每行開頭為 GMA Debug CONTENT。

控制台輸出內容範例

I/Ads     ( 4660): GMA Debug BEGIN
I/Ads     ( 4660): GMA Debug CONTENT {"timestamp":1510679993741,...}
I/Ads     ( 4660): GMA Debug FINISH

JSON 輸出範例

以下是 Logcat 的 JSON 輸出範例:

onNetworkRequest

{
  "timestamp": 1510679994904,
  "event": "onNetworkRequest",
  "components": [
    "ad_request_cf5ab185-3c3f-4f01-9f56-33da2ae110f2",
    "network_request_6553bc32-1d44-4f18-9dd0-5c183abbeb90"
  ],
  "params": {
    "firstline": {
      "uri": "http://googleads.g.doubleclick.net/pagead/ads?carrier=....",
      "verb": "GET"
    },
    "headers": [
      {
        "name": "User-Agent",
        "value": "Mozilla/5.0 (Linux; Android 5.0.2;..."
      }
    ]
  }
}

onNetworkResponse

{
  "timestamp": 1510679995295,
  "event": "onNetworkResponse",
  "components": [
    "ad_request_cf5ab185-3c3f-4f01-9f56-33da2ae110f2",
    "network_request_6553bc32-1d44-4f18-9dd0-5c183abbeb90"
  ],
  "params": {
    "firstline": {
      "code": 200
    },
    "headers": [
      {
        "name": null,
        "value": "HTTP/1.1 200 OK"
      },
      {
        "name": "X-Google-DOS-Service-Trace",
        "value": "main:pagead"
      },
      {
        "name": "Content-Type",
        "value": "text/html; charset=UTF-8"
      },
      ...
    ]
  }
}

onNetworkResponseBody

{
  "timestamp": 1510679995375,
  "event": "onNetworkResponseBody",
  "components": [
    "ad_request_cf5ab185-3c3f-4f01-9f56-33da2ae110f2",
    "network_request_6553bc32-1d44-4f18-9dd0-5c183abbeb90"
  ],
  "params": {
    "bodydigest": "B2520049D02F3C70A12AD1BC0D1B58A4",
    "bodylength": 122395
  }
}