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 theo cách có lập trình đặt giá thầu theo thời gian thực cũng được hiển thị thông qua Công cụ Đột phá RTB trong Giao diện người dùng của Authorized Buyers. Các thiết bị này bao gồm bidders.filterSets, bidders.accounts.filterSets và tất cả tài nguyên dưới chúng theo thứ tự phân cấp.

Bằng cách sử dụng các chỉ số từ tài nguyên khắc phục sự cố RTB, bạn có thể có được thông tin chi tiết về các cơ hội bị bỏ lỡ để nhận được các lượt hiển thị có thể giúp bạn 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 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, cung cấp 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

Các tài nguyên được cấu trúc trong cả biddersbidders.accounts. Các tham số này cho phép bạn chỉ định liệu lệnh gọi API có nhắm mục tiêu bên đặt giá thầu (còn gọi là tài khoản mẹ hay không) và tất cả tài khoản con hoặc tài khoản Authorized Buyers cá nhân. Trong bối cảnh RTB Khắc phục sự cố, 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 nhất định và tất cả các tài khoản con được liên kết. Ngược lại, những người dùng trong bidders.accounts.filterSets sẽ chỉ trả về các chỉ số cho tài khoản được chỉ định, bất kể cho dù đó là tài khoản bên đặt giá thầu hay tài khoản con.

Lưu ý: Tài khoản uỷ quyền đặt giá thầu cho một 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, tài khoản không phải của bên đặt giá thầu cũng không thể truy cập vào impressionMetrics, filteredBidResponses, bidResponseErrors ở cấp tài khoản và Tài nguyên bidResponsesWithoutBids.

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 nhận dạng duy nhất thay vì mã nhận dạng số nguyên hoặc chuỗi. Khi tạo một thực thể mới của một đối tượng cụ thể loại tài nguyên này, bây giờ bạn phải chỉ định một tương đối tài nguyên 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. Chiến lược phát hành đĩa đơn sau đây là ví dụ về các tên có liên quan cho các tài nguyên Khắc phục sự cố 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ã của bên đặt giá thầu Mã tài khoản Authorized Buyers. Đối với accounts, mã nhận dạng tài nguyên phải là mã tài khoản của một trong hai 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 bạn không biết Authorized Buyers nào được liên kết với Tài khoản Google của bạn, bạn có thể sử dụng accounts.list để tìm chúng.

Nhóm bộ lọc

Nhóm bộ lọc thể hiện các lựa chọn lọc có sẵn và có thể tạo được ở cấp bên đặt giá thầu hoặc cấp tài khoản. URL này được dùng để lọc danh sách kết quả khắc phục sự cố RTB để truy xuất chỉ số cho chiến dịch đặt giá thầu theo thời gian thực.

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

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 từ cấp mà chúng được tạo—bất kể tài khoản được dùng để tạo chúng là gì. Bên đặt giá thầu và tài khoản con chia sẻ các tập hợp bộ lọc được tạo ở cấp tài khoản, trong khi chỉ bên đặt giá thầu mới có thể truy cập vào các 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 các 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 các tập hợp 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ề một 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 một nhóm bộ lọc

Khi tạo tập hợp 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ố, chế độ mặc định là áp dụng cho tất cả dữ liệu được cung cấp trong toàn bộ phạm vi thời gian. Nếu bạn muốn nhận bảng chi tiết chuỗi thời gian trong phạm vi thời gian, bạn có thể chỉ định timeSeriesGranularity để chỉ định khoảng thời gian HOURLY hoặc DAILY.

Nếu chỉ yêu cầu nhóm bộ lọc trong một khoảng thời gian ngắn, bạn có thể đặt giá trị isTransient thành true. Điều này cho biết nhóm bộ lọc là tạm thời, có nghĩa là nhóm sẽ không được duy trì vô thời hạn. Các tập hợp 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 cấp bên đặt giá thầu mới, hãy gửi yêu cầu POST đến URI tài nguyên bidders.filterSets có định dạng sau:

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

Cảnh báo: Bộ 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 mã giao dịch. Nếu chỉ định các bộ lọc này khi tạo tập hợp bộ lọc cấp bên đặt giá thầu, 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 tập hợp bộ lọc cấp bên đặt giá thầu không tạm thời mớ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 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 tập hợp bộ lọc cấp tài khoản mới, 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ã nhận dạng 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à bên đặt giá thầu có thể truy cập tài khoản được chỉ định trong URI, bao gồm cả tài khoản bên đặt giá thầu.

Yêu cầu

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

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 một nhóm bộ lọc

Phương thức get chỉ có thể lấy tập hợp bộ lọc ở chính cấp mà nó được tạo. Ví dụ: trình đặt giá thầu tài khoản nên sử dụng bidders.accounts.filterSets.get để truy xuất nhóm bộ lọc được tạo trong 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 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, 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, 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"
}

Liệt kê các nhóm bộ lọc

Phương thức danh sách sẽ chỉ trả về các tập hợp bộ lọc có thể truy cập từ cấp mà nó đang được gọi. Ví dụ: tài khoản bên đặt giá thầu sẽ không thấy các tập hợp bộ lọc được tạo cho chính tài khoả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ả tập hợp 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 HTTP GET yêu cầu đến URI tài nguyên bidders.filtersets có định dạng 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 bộ bộ lọc cấp bên đặt giá thầu cho 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 của một tài khoản nhất định bằng cách gửi một HTTP GET yêu cầu đến URI tài nguyên bidders.accounts.filtersets có định dạng sau:

GET https://adexchangebuyer.googleapis.com/v2beta1/bidders/{bidder resource ID}/accounts/{account 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 tài khoản cho một 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 tập hợp bộ lọc không tạm thời không cần thiết lâu hơn. Bộ lọc chỉ có thể xoá các tập hợp bộ lọc có thể truy cập từ cấp mà bộ lọc đang được gọi; ví dụ: tài khoản bên đặt giá thầu không thể xóa tập hợp bộ lọc được tạo bằng bidders.accounts.filterSets.create cùng 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 vào URI tài nguyên bidders.filtersets có định dạng 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 xoá 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, nội dung yêu cầu sẽ trống. Bạn sẽ không thể truy cập vào nhóm bộ lọc được chỉ định nữa.

Cấp tài khoản

Bạn có thể xoá tập hợp bộ lọc cấp tài khoản cho một tài khoản cụ thể bằng cách gửi một HTTP DELETE yêu cầu đến URI tài nguyên bidders.accounts.filtersets có định dạng 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á nhóm 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, nội dung yêu cầu sẽ trống. Bạn sẽ không thể truy cập vào nhóm bộ lọc được chỉ định nữa.

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

Tất cả tài nguyên khắc phục sự cố RTB dùng để nhận chỉ số hoạt động theo cách tương tự nhau—chúng có phương thức duy nhất để liệt kê các chỉ số cho tập hợp bộ lọc được chỉ định thông qua đường dẫn filterSetName . Nhóm bộ lọc được chỉ định sẽ xác định bộ lọc và cài đặt nào sẽ được áp dụng khi truy vấn các chỉ số. Việc gọi các tài nguyên này từ cấp bên đặt giá thầu sẽ trả về các chỉ số tổng hợp từ tài khoản người đặt giá thầu và tất cả cá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ề các 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 trong số lượng giá thầu. Ví dụ: bạn có thể sử dụng chỉ số này để xác định tổng số giá thầu của mình trên một phạm vi thời gian nhất định và số lượng quảng cáo không được lọc khỏi phiên đấu giá, giành được hiển thị, Giống như tất cả các tài nguyên khắc phục sự cố RTB khác được dùng để thu thập chỉ số, tài nguyên này chỉ có phương thức list.

Liệt kê các 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 nhóm bộ lọc nhất định bằng cách gửi một HTTP GET yêu cầu đến URI tài nguyên bidders.filtersets.bidMetrics có định dạng 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à ví dụ về các chỉ số giá thầu ở cấp bên đặt giá thầu liệt kê:

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à nội dung chứa các hàng chỉ số cho các phương diện và độ chi tiết được 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 ý: Mọi trường được đặt thành 0 cho một chỉ số nhất định sẽ không xuất hiện trong nội dung phản hồi. Chỉ số billedImpressionsmeasurableImpressions trống ở trên chỉ ra rằng cả giá trị và phương sai của các giá trị này được đặt bằng 0.

Cảnh báo: Đối với mọi thông tin chi tiết về dữ liệu trong câu trả lời, câu trả lời sẽ không bao gồm các hàng nếu chúng không chứa ít nhất một chỉ số khác 0. Ví dụ: khi một timeSeriesGranularity đã được chỉ định, phản hồi sẽ không bao gồm hàng cho bất kỳ timeInterval trong phạm vi thời gian được chỉ định của nhóm bộ lọc, trong đó tất cả các chỉ số đều 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 nhóm bộ lọc nhất định bằng cách gửi một HTTP GET yêu cầu đến URI tài nguyên bidders.accounts.filtersets.bidMetrics, trong đó có định dạng 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

Dưới đây là ví dụ 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à nội dung chứa các hàng chỉ số cho các phương diện và độ chi tiết được 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 ý: Mọi trường được đặt thành 0 cho một chỉ số nhất định sẽ không xuất hiện trong nội dung phản hồi. Chiến lược phát hành đĩa đơn các chỉ số billedImpressionsmeasurableImpressions trống ở trên cho biết cả giá trị và phương sai của các giá trị này đều được đặt thành 0.

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