Khắc phục sự cố RTB

Hướng dẫn này đề cập đến các tài nguyên khắc phục sự cố RTB, cho phép bạn truy cập vào các chỉ số chiến dịch đặt giá thầu theo thời gian thực theo phương thức lập trình. Những chỉ số này cũng được hiển thị thông qua công cụ Đột phá RTB trong giao diện người dùng Authorized Buyers. Các tài nguyên này bao gồm bidders.filterSets, bidders.accounts.filterSets và mọi tài nguyên theo hệ phân cấp.

Bằng cách sử dụng các chỉ số từ các tài nguyên về khắc phục sự cố RTB, bạn có thể hiểu rõ hơn về các cơ hội bị bỏ lỡ để giành được lượt hiển thị nhằm tối ưu hoá chiến dịch đặt giá thầu theo thời gian thực.

Điều chỉnh cấu trúc và kiểu API

Tài nguyên về khắc phục sự cố RTB giới thiệu một số thay đổi để chỉ rõ quyền sở hữu và quyền truy cập, mang đến cho bạn khả năng kiểm soát chi tiết hơn đối với dữ liệu mà API trả về và phù hợp hơn với các phương pháp thiết kế API của Google.

Tài nguyên ở cấp bên đặt giá thầu và cấp tài khoản

Tài nguyên được cấu trúc theo cả biddersbidders.accounts. Việc này cho phép bạn chỉ định liệu lệnh gọi API đang nhắm đến bên đặt giá thầu (còn gọi là tài khoản mẹ) và tất cả tài khoản con được liên kết, hay tài khoản Authorized Buyers cá nhân. Trong quá trình khắc phục sự cố RTB, các tài nguyên có cấu trúc trong bidders.filterSets sẽ trả về các chỉ số tổng hợp cho bên đặt giá thầu cụ thể và tất cả các tài khoản con được liên kết. Ngược lại, những miền trong bidders.accounts.filterSets sẽ chỉ trả về các chỉ số cho tài khoản được chỉ định, bất kể đó là bên đặt giá thầu hay tài khoản con.

Lưu ý: Các tài khoản uỷ quyền đặt giá thầu cho người mua khác không phải là tài khoản bên đặt giá thầu và do đó, không thể truy cập vào tài nguyên ở cấp bên đặt giá thầu. Ngoài ra, những tài khoản không đặt giá thầu sẽ không thể truy cập vào các tài nguyên impressionMetrics, filteredBidResponses, bidResponseErrorsbidResponsesWithoutBids ở cấp tài khoản.

Ra mắt tên tài nguyên dưới dạng giá trị nhận dạng duy nhất

Tên tài nguyên được dùng làm giá trị nhận dạng duy nhất thay vì mã nhận dạng số nguyên hoặc chuỗi. Giờ đây, khi tạo thực thể mới của một loại tài nguyên nhất định, bạn phải chỉ định tên tài nguyên tương đối bằng cách sử dụng đường dẫn URI của tài nguyên theo sau là mã nhận dạng tài nguyên ưu tiên. Sau đây là ví dụ về tên liên quan đến các tài nguyên Khắc phục sự cố liên quan đến RTB:

Tài nguyên Ví dụ về tên
bidders.filterSets bidders/12345678/filterSets/fset_1
bidders.accounts.filterSets bidders/12345678/accounts/87654321/filterSets/fset_2

Lưu ý: Mã tài nguyên được chỉ định cho bidders trong tên phải là mã tài khoản Authorized Buyers của bên đặt giá thầu. Đối với accounts, mã tài nguyên phải là mã tài khoản của bên đặt giá thầu hoặc tài khoản con do bên đặt giá thầu đó quản lý. Nếu không biết tài khoản Authorized Buyers nào được liên kết với Tài khoản Google của mình, bạn có thể sử dụng phương thức accounts.list để tìm các tài khoản đó.

Các nhóm bộ lọc

Tập hợp bộ lọc là thông tin đại diện cho các tuỳ chọn lọc hiện có và có thể được tạo ở cấp bên đặt giá thầu hoặc cấp tài khoản. Chế độ này dùng để lọc kết quả danh sách của những tài nguyên Khắc phục sự cố RTB nhằm truy xuất các chỉ số cho các chiến dịch đặt giá thầu theo thời gian thực của bạn.

Bộ lọc được áp dụng khi truy xuất chỉ số là giao điểm của từng bộ lọc trong tập hợp bộ lọc đã chỉ định. Các bộ lọc danh sách, chẳng hạn như platforms, được hiểu là sự kết hợp của từng mục trong danh sách.

Nhóm bộ lọc cấp tài khoản và bên đặt giá thầu khác nhau và chỉ truy cập được ở cấp mà bộ lọc đó được tạo, bất kể tài khoản dùng để tạo bộ lọc. Tập hợp bộ lọc chia sẻ tài khoản con và bên đặt giá thầu được tạo ở cấp tài khoản, trong khi chỉ có bên đặt giá thầu mới có thể truy cập vào tài nguyên ở cấp bên đặt giá thầu. Bảng sau đây tóm tắt cách bên đặt giá thầu và tài khoản con có thể truy cập vào tài nguyên ở một trong hai cấp:

  bidders.filterSets bidders.accounts.filterSets
Tài khoản bên đặt giá thầu Lệnh gọi API chỉ ảnh hưởng đến nhóm bộ lọc ở cấp bên đặt giá thầu. Lệnh gọi API chỉ ảnh hưởng đến các nhóm bộ lọc ở cấp tài khoản.
Tài khoản con Lệnh gọi API này sẽ trả về phản hồi lỗi. Lệnh gọi API chỉ ảnh hưởng đến các nhóm bộ lọc ở cấp tài khoản.

Tạo nhóm bộ lọc

Khi tạo một nhóm bộ lọc, bạn phải chỉ định phạm vi thời gian là relativeDateRange, absoluteDateRange hoặc realtimeTimeRange. Khi truy xuất chỉ số, hành vi mặc định là tất cả dữ liệu sẽ được cung cấp trong toàn bộ phạm vi thời gian. Nếu muốn nhận được bảng chi tiết theo chuỗi thời gian trong một khoảng thời gian, bạn có thể chỉ định timeSeriesGranularity để cho biết các khoảng thời gian HOURLY hoặc DAILY.

Nếu chỉ yêu cầu đặt bộ lọc trong một khoảng thời gian ngắn, bạn có thể đặt tham số truy vấn isTransient thành true. Điều này sẽ chỉ ra rằng tập hợp bộ lọc là tạm thời, có nghĩa là tập hợp sẽ không được duy trì vô thời hạn. Các nhóm bộ lọc tạm thời sẽ có sẵn trong ít nhất một giờ sau khi tạo, nhưng cuối cùng sẽ bị xoá. Theo mặc định, các nhóm bộ lọc không phải là tạm thời.

Ví dụ ở cấp bên đặt giá thầu

Để tạo tập hợp bộ lọc mới ở cấp bên đặt giá thầu, hãy gửi yêu cầu POST đến URI tài nguyên bidders.filterSets có định dạng như sau:

https://adexchangebuyer.googleapis.com/v2beta1/bidders/{bidder resource ID}/filterSets

Cảnh báo: Các nhóm bộ lọc cấp bên đặt giá thầu không thể lọc theo mã mẫu quảng cáo hoặc giao dịch. Nếu chỉ định các bộ lọc này khi tạo nhóm bộ lọc cấp bên đặt giá thầu, thì bạn sẽ nhận được phản hồi lỗi.

Yêu cầu

Dưới đây là ví dụ về yêu cầu POST tạo một nhóm bộ lọc mới ở cấp bên đặt giá thầu, không tạm thời:

POST https://adexchangebuyer.googleapis.com/v2beta1/bidders/12345678/filterSets
Authorization: Bearer access token here
Content-Type: application/json

{
  "name": "bidders/12345678/filterSets/bidder-fs",
  "format": "DISPLAY",
  "environment": "APP",
  "platforms": ["TABLET", "MOBILE"],
  "absoluteDateRange": {
    "startDate": {
      "month": 11,
      "day": 26,
      "year": 2017
    },
    "endDate": {
      "month": 12,
      "day": 3,
      "year": 2017
    }
  },
  "timeSeriesGranularity": "DAILY"
}

Phản hồi

Nếu yêu cầu thành công, máy chủ sẽ phản hồi bằng mã trạng thái 200 OK. Nội dung phản hồi sẽ bao gồm tài nguyên nhóm bộ lọc đã tạo, giống hệt với nhóm bộ lọc được gửi trong yêu cầu.

Ví dụ ở cấp tài khoản

Để tạo một nhóm bộ lọc mới ở cấp tài khoản, hãy gửi yêu cầu POST đến URI tài nguyên bidders.accounts.filterSets có định dạng như sau:

https://adexchangebuyer.googleapis.com/v2beta1/bidders/{bidder resource ID}/accounts/{account resource ID}/filterSets

Lưu ý: Mã tài nguyên được chỉ định cho accounts có thể là mã tài khoản của bất kỳ tài khoản Authorized Buyers nào mà tài khoản bên đặt giá thầu đã chỉ định trong URI có thể truy cập, bao gồm cả chính tài khoản của bên đặt giá thầu đó.

Yêu cầu

Dưới đây là ví dụ về yêu cầu POST tạo một nhóm bộ lọc mới không tạm thời ở cấp tài khoản:

POST https://adexchangebuyer.googleapis.com/v2beta1/bidders/12345678/accounts/87654321/filterSets
Authorization: Bearer access token here
Content-Type: application/json

{
  "name": "bidders/12345678/accounts/87654321/filterSets/account-fs",
  "format": "VIDEO",
  "environment": "WEB",
  "platforms": ["DESKTOP"],
  "absoluteDateRange": {
    "startDate": {
      "month": 11,
      "day": 26,
      "year": 2017
    },
    "endDate": {
      "month": 12,
      "day": 3,
      "year": 2017
    }
  },
  "timeSeriesGranularity": "DAILY"
}
Phản hồi

Nếu yêu cầu thành công, máy chủ sẽ phản hồi bằng mã trạng thái 200 OK. Nội dung phản hồi sẽ bao gồm tài nguyên nhóm bộ lọc đã tạo. Tài nguyên này sẽ giống với nhóm bộ lọc được gửi trong yêu cầu.

Tải tập hợp bộ lọc

Phương thức get chỉ có thể lấy tập hợp bộ lọc ở cùng cấp mà nó được tạo. Ví dụ: tài khoản bên đặt giá thầu phải sử dụng bidders.accounts.filterSets.get để truy xuất nhóm bộ lọc được tạo ở cấp tài khoản thay vì phương thức bidders.filterSets.get.

Cấp bên đặt giá thầu

Bạn có thể truy xuất tập hợp bộ lọc cấp bên đặt giá thầu bằng cách gửi yêu cầu HTTP GET đến URI tài nguyên bidders.filterSets có định dạng như sau:

GET https://adexchangebuyer.googleapis.com/v2beta1/bidders/{bidder resource ID}/filterSets/{filter set resource ID}
Yêu cầu

Ví dụ:

GET https://adexchangebuyer.googleapis.com/v2beta1/bidders/12345678/filterSets/bidder-fs
Phản hồi

Nếu yêu cầu thành công thì máy chủ sẽ phản hồi bằng mã trạng thái HTTP 200 OK và tập hợp bộ lọc được truy xuất:

{
  "name": "bidders/12345678/filterSets/bidder-fs",
  "format": "DISPLAY",
  "environment": "APP",
  "platforms": ["TABLET", "MOBILE"],
  "absoluteDateRange": {
    "startDate": {
      "month": 11,
      "day": 26,
      "year": 2017
    },
    "endDate": {
      "month": 12,
      "day": 3,
      "year": 2017
    }
  },
  "timeSeriesGranularity": "DAILY"
}

Cấp tài khoản

Bạn có thể truy xuất tập hợp bộ lọc cấp tài khoản bằng cách gửi yêu cầu HTTP GET đến URI tài nguyên bidders.accounts.filterSets có định dạng như sau:

GET https://adexchangebuyer.googleapis.com/v2beta1/bidders/{bidder resource ID}/accounts/{account resource ID}/filterSets/{filter set resource ID}
Yêu cầu

Ví dụ:

GET https://adexchangebuyer.googleapis.com/v2beta1/bidders/12345678/accounts/87654321/filterSets/account-fs
Phản hồi

Nếu yêu cầu thành công thì máy chủ sẽ phản hồi bằng mã trạng thái HTTP 200 OK và tập hợp bộ lọc được truy xuất:

{
  "name": "bidders/12345678/accounts/87654321/filterSets/account-fs",
  "format": "VIDEO",
  "environment": "WEB",
  "platforms": ["DESKTOP"],
  "absoluteDateRange": {
    "startDate": {
      "month": 11,
      "day": 26,
      "year": 2017
    },
    "endDate": {
      "month": 12,
      "day": 3,
      "year": 2017
    }
  },
  "timeSeriesGranularity": "DAILY"
}

Danh sách các nhóm bộ lọc

Phương thức danh sách sẽ chỉ trả về các nhóm bộ lọc có thể truy cập được từ cấp mà phương thức đó đang được gọi. Ví dụ: tài khoản bên đặt giá thầu sẽ không thấy tập hợp bộ lọc được tạo cho chính nó thông qua bidders.accounts.filterSets.create khi gọi bidders.filterSets.list.

Cấp bên đặt giá thầu

Bạn có thể truy xuất tất cả nhóm bộ lọc cấp bên đặt giá thầu cho một bên đặt giá thầu nhất định bằng cách gửi yêu cầu HTTP GET đến URI tài nguyên bidders.filtersets có định dạng như sau:

GET https://adexchangebuyer.googleapis.com/v2beta1/bidders/{bidder resource ID}/filterSets
Yêu cầu

Dưới đây là ví dụ liệt kê tất cả các nhóm bộ lọc cấp bên đặt giá thầu của bên đặt giá thầu có mã tài khoản là 12345678:

GET https://adexchangebuyer.googleapis.com/v2beta1/bidders/12345678/filterSets
Phản hồi
{
  "filterSets": [{
      "filterSetId": "99994",
      "name": "bidders/12345678/filterSets/test-b-1",
      "relativeDateRange": {
        "durationDays": 30
      }
    },
    {
      "realtimeTimeRange": {
        "startTimeStamp": "2017-11-15T12:30:30.072831583Z"
      },
      "filterSetId": "99995",
      "name": "bidders/12345678/filterSets/test-b-2",
      "timeSeriesGranularity": "HOURLY"
    },
    {
      "absoluteDateRange": {
        "endDate": {
          "day": 12,
          "month": 3,
          "year": 2017
        },
        "startDate": {
          "day": 26,
          "month": 11,
          "year": 2017
        }
      },
      "filterSetId": "99996",
      "name": "bidders/12345678/filterSets/bidder-fs",
      "timeSeriesGranularity": "DAILY",
      "platforms": ["TABLET", "MOBILE"],
      "environment": "APP",
      "format": "DISPLAY"
    }
  ]
}

Cấp tài khoản

Bạn có thể truy xuất tất cả các nhóm bộ lọc cấp tài khoản cho một tài khoản nhất định bằng cách gửi yêu cầu HTTP GET đến URI tài nguyên bidders.accounts.filtersets có định dạng như sau:

GET https://adexchangebuyer.googleapis.com/v2beta1/bidders/{bidder resource ID}/accounts/{account resource ID}/filterSets
Yêu cầu

Sau đây là ví dụ liệt kê tất cả các nhóm bộ lọc cấp tài khoản cho tài khoản con có mã tài khoản là 87654321:

GET https://adexchangebuyer.googleapis.com/v2beta1/bidders/12345678/accounts/87654321/filterSets
Phản hồi
{
  "filterSets": [{
        "realtimeTimeRange": {
        "startTimeStamp": "2017-11-19T04:24:43.252893487Z"
      },
      "filterSetId": "99997",
      "name": "bidders/12345678/accounts/87654321/filterSets/test-a-1",
      "timeSeriesGranularity": "DAILY"
    },
    {
      "absoluteDateRange": {
        "endDate": {
          "day": 3,
          "month": 12,
          "year": 2017
        },
        "startDate": {
          "day": 26,
          "month": 11,
          "year": 2017
        }
      },
      "filterSetId": "99998",
      "name": "bidders/12345678/accounts/87654321/filterSets/account-fs",
      "timeSeriesGranularity": "DAILY",
      "platforms": ["DESKTOP"],
      "environment": "WEB",
      "format": "VIDEO"
    }
  ]
}

Xóa tập hợp bộ lọc

Bạn có thể sử dụng phương thức delete để xoá mọi nhóm bộ lọc không tạm thời mà không còn cần thiết nữa. Thao tác này chỉ có thể xoá các tập hợp bộ lọc có thể truy cập được ở cấp đang được gọi; ví dụ: tài khoản bên đặt giá thầu không thể xoá tập hợp bộ lọc được tạo bằng bidders.accounts.filterSets.create với bidders.filterSets.delete.

Cấp bên đặt giá thầu

Bạn có thể xoá tập hợp bộ lọc cấp bên đặt giá thầu cho một tài khoản nhất định bằng cách gửi yêu cầu HTTP DELETE đến URI tài nguyên bidders.filtersets có định dạng như sau:

DELETE https://adexchangebuyer.googleapis.com/v2beta1/bidders/{bidder resource ID}/filterSets/{filter set resource ID}
Yêu cầu

Dưới đây là ví dụ về cách xóa tập hợp bộ lọc cấp bên đặt giá thầu:

DELETE https://adexchangebuyer.googleapis.com/v2beta1/bidders/12345678/filterSets/test-b-2
Phản hồi

Nếu thành công, phần nội dung của yêu cầu sẽ trống. Tập hợp bộ lọc được chỉ định sẽ không còn truy cập được nữa.

Cấp tài khoản

Bạn có thể xoá nhóm bộ lọc cấp tài khoản cho một tài khoản nhất định bằng cách gửi yêu cầu HTTP DELETE đến URI tài nguyên bidders.accounts.filtersets có định dạng như sau:

DELETE https://adexchangebuyer.googleapis.com/v2beta1/bidders/{bidder resource ID}/accounts/{account resource ID}/filterSets/{filter set resource ID}
Yêu cầu

Dưới đây là ví dụ về cách xoá tập hợp bộ lọc cấp tài khoản:

DELETE https://adexchangebuyer.googleapis.com/v2beta1/bidders/12345678/accounts/87654321/filterSets/test-a-1
Phản hồi

Nếu thành công, phần nội dung của yêu cầu sẽ trống. Tập hợp bộ lọc được chỉ định sẽ không còn truy cập được nữa.

Truy xuất chỉ số khắc phục sự cố RTB

Tất cả các tài nguyên khắc phục sự cố RTB được dùng để nhận các chỉ số đều hoạt động theo cách tương tự – những tài nguyên này có một phương thức duy nhất để liệt kê các chỉ số cho nhóm bộ lọc được chỉ định thông qua thông số đường dẫn filterSetName. Nhóm bộ lọc đã chỉ định sẽ xác định những bộ lọc và chế độ cài đặt sẽ được áp dụng khi truy vấn các chỉ số. Khi gọi những tài nguyên này từ cấp bên đặt giá thầu, hệ thống sẽ trả về chỉ số tổng hợp từ tài khoản bên đặt giá thầu và tất cả tài khoản con được liên kết, trong khi lệnh gọi từ cấp tài khoản sẽ chỉ trả về chỉ số cho tài khoản cá nhân.

Chỉ số giá thầu

Tài nguyên bidMetrics dùng để truy xuất các chỉ số được đo lường về số lượng giá thầu. Ví dụ: bạn có thể sử dụng tính năng này để xác định tổng số giá thầu trong một phạm vi thời gian nhất định và số lượng giá thầu trong số đó không được lọc khỏi phiên đấu giá, giành được lượt hiển thị, v.v. Giống như tất cả các tài nguyên khắc phục sự cố RTB khác dùng để thu thập chỉ số, tính năng này chỉ có phương thức list.

Liệt kê chỉ số giá thầu ở cấp bên đặt giá thầu

Bạn có thể liệt kê các chỉ số giá thầu cấp bên đặt giá thầu cho một tập hợp bộ lọc nhất định bằng cách gửi yêu cầu HTTP GET đến URI tài nguyên bidders.filtersets.bidMetrics có định dạng như sau:

GET https://adexchangebuyer.googleapis.com/v2beta1/bidders/{bidder resource ID}/filterSets/{filter set resource ID}/bidMetrics
Yêu cầu

Dưới đây là một ví dụ về trang thông tin chỉ số giá thầu cấp bên đặt giá thầu:

GET https://adexchangebuyer.googleapis.com/v2beta1/bidders/12345678/filterSets/bidder-fs/bidMetrics
Phản hồi

Nếu yêu cầu thành công, máy chủ sẽ phản hồi bằng mã trạng thái 200 OK và phần nội dung chứa các hàng chỉ số theo các phương diện và độ chi tiết đã chỉ định.

{
  "bidMetricsRows": [{
        "bids": {
        "value": "6160"
      },
      "bidsInAuction": {
        "value": "5698"
      },
      "billedImpressions": {
        "value": "1196"
      },
      "impressionsWon": {
        "value": "2920"
      },
      "measurableImpressions": {
        "value": "1160"
      },
      "rowDimensions": {
        "timeInterval": {
          "endTime": "2017-11-29T08:00:00Z",
          "startTime": "2017-11-28T08:00:00Z"
        }
      },
      "viewableImpressions": {
        "value": "683"
      }
    },
    {
      "bids": {
        "value": "104288"
      },
      "bidsInAuction": {
        "value": "94016"
      },
      "billedImpressions": {
        "value": "99"
      },
      "impressionsWon": {
        "value": "125"
      },
      "measurableImpressions": {
        "value": "94"
      },
      "rowDimensions": {
        "timeInterval": {
          "endTime": "2017-11-30T08:00:00Z",
          "startTime": "2017-11-29T08:00:00Z"
        }
      },
      "viewableImpressions": {
        "value": "87"
      }
    },
    {
      "bids": {
        "value": "3999"
      },
      "bidsInAuction": {
        "value": "3631"
      },
      "billedImpressions": {
        "value": "618"
      },
      "impressionsWon": {
        "value": "1819"
      },
      "measurableImpressions": {
        "value": "604"
      },
      "rowDimensions": {
        "timeInterval": {
          "endTime": "2017-12-01T08:00:00Z",
          "startTime": "2017-11-30T08:00:00Z"
        }
      },
      "viewableImpressions": {
        "value": "369"
      }
    },
    {
      "bids": {
        "value": "15"
      },
      "bidsInAuction": {
        "value": "3"
      },
      "billedImpressions": {},
      "impressionsWon": {
        "value": "3"
      },
      "measurableImpressions": {},
      "rowDimensions": {
        "timeInterval": {
          "endTime": "2017-12-02T08:00:00Z",
          "startTime": "2017-12-01T08:00:00Z"
        }
      },
      "viewableImpressions": {}
    }
  ]
}

Lưu ý: Bất kỳ trường nào được đặt thành 0 cho một chỉ số nhất định sẽ không xuất hiện trong phản hồi. Các chỉ số billedImpressionsmeasurableImpressions trống ở trên cho biết cả giá trị và phương sai của các chỉ số này đều được đặt thành 0.

Cảnh báo: Đối với mọi phân tích dữ liệu trong phản hồi, phản hồi sẽ không bao gồm các hàng nếu dữ liệu đó không chứa ít nhất một chỉ số khác 0. Ví dụ: khi bạn chỉ định timeSeriesGranularity, phản hồi sẽ không bao gồm các hàng cho bất kỳ timeInterval nào trong phạm vi thời gian được chỉ định của tập hợp bộ lọc, trong đó tất cả các chỉ số bằng 0.

Liệt kê các chỉ số giá thầu cấp tài khoản

Bạn có thể liệt kê các chỉ số giá thầu cấp tài khoản cho một tập hợp bộ lọc nhất định bằng cách gửi yêu cầu HTTP GET đến URI tài nguyên bidders.accounts.filtersets.bidMetrics có định dạng như sau:

GET https://adexchangebuyer.googleapis.com/v2beta1/bidders/{bidder resource ID}/accounts/{account resource ID}/filterSets/{filter set resource ID}/bidMetrics
Yêu cầu

Sau đây là một ví dụ về việc liệt kê các chỉ số giá thầu cấp tài khoản:

GET https://adexchangebuyer.googleapis.com/v2beta1/bidders/12345678/accounts/87654321/filterSets/account-fs/bidMetrics
Phản hồi

Nếu yêu cầu thành công, máy chủ sẽ phản hồi bằng mã trạng thái 200 OK và phần nội dung chứa các hàng chỉ số theo các phương diện và độ chi tiết đã chỉ định.

{
  "bidMetricsRows": [{
      "bids": {
        "value": "1748"
      },
      "bidsInAuction": {
        "value": "1421"
      },
      "billedImpressions": {
        "value": "301"
      },
      "impressionsWon": {
        "value": "915"
      },
      "measurableImpressions": {
        "value": "298"
      },
      "rowDimensions": {
        "timeInterval": {
          "endTime": "2017-12-01T08:00:00Z",
          "startTime": "2017-11-30T08:00:00Z"
        }
      },
      "viewableImpressions": {
        "value": "172"
      }
    },
    {
      "bids": {
        "value": "6"
      },
      "bidsInAuction": {
        "value": "2"
      },
      "billedImpressions": {},
      "impressionsWon": {
        "value": "1"
      },
      "measurableImpressions": {},
      "rowDimensions": {
        "timeInterval": {
          "endTime": "2017-12-02T08:00:00Z",
          "startTime": "2017-12-01T08:00:00Z"
        }
      },
      "viewableImpressions": {}
    }
  ]
}

Lưu ý: Bất kỳ trường nào được đặt thành 0 cho một chỉ số nhất định sẽ không xuất hiện trong phản hồi. Các chỉ số billedImpressionsmeasurableImpressions trống ở trên cho biết cả giá trị và phương sai của các chỉ số này đều được đặt thành 0.

Cảnh báo: Đối với mọi bảng chi tiết về dữ liệu trong phản hồi, phản hồi sẽ không bao gồm các hàng nếu dữ liệu đó không chứa ít nhất một chỉ số khác 0. Ví dụ: khi bạn chỉ định timeSeriesGranularity, phản hồi sẽ không bao gồm các hàng cho bất kỳ timeInterval nào trong phạm vi thời gian được chỉ định của tập hợp bộ lọc, trong đó tất cả các chỉ số bằng 0.