使用 RTB Troubleshooting API

少部分程式輔助保證 (PG) 交易無法在 Authorized Buyers (AB) 中完整放送，因為 AB 與需求端平台 (DSP) 之間的可計費曝光次數出現差異。

如要找出有問題的交易，您可以使用 RTB Troubleshooting API 擷取「可計費曝光」，然後比對 AB 報表和 DSP 報表，並標明差異很大的交易。這些可計費曝光是我們會向買方收費的淨營利曝光次數。

如要計算支出，請擷取可計費曝光次數，然後乘以交易的靜態千次曝光出價。

步驟 1

使用 bidders.accounts.filterSets.create，為具有指定帳戶 ID 的帳戶建立指定的篩選器組合

1. 在要求主體中指定 ownerName、isTransient 和 filterSet，如以下範例所示：

範例 ownerName -> "bidders/48446606/accounts/48446606" isTransient -> true filterSet -> {   "dealId": 12345,   "relativeDateRange": {     "durationDays": 30,     "offsetDays": 0   },   "name": "bidders/48446606/filterSets/12345",   "timeSeriesGranularity": "HOURLY" }

如果篩選器組合只是為了短期使用，且不應無限期保留，請將 isTransient 設為 true。

2. 在篩選器組合中，指定要篩選的 dealId。

3. 指定 relativeDateRange (最多 30 天)。

RTB Troubleshooting API 僅支援 30 天內的指標。

4. 使用 timeSeriesGranularity，根據時段或日期來細分結果。

5. 建立完成後，請記錄篩選器組合名稱。

步驟 2

使用 bidders.accounts.filterSets.bidMetrics.list 查詢出價指標 (包括已計費曝光)。

1. 輸入您在步驟 1 建立的 filterSet 名稱。例如 bidders/48446606/filterSets/12345。視需要指定頁面大小。
2. 如果未指定 timeSeriesGranularity，出價指標會顯示一列資料；如果有指定，則會針對每個時間精細程度設定 (時段或日期) 顯示多列資料。

舉例來說，因為步驟 1 的 filterSet 以及 pageSize 等於 2，則回應為：

範例

bid_metrics_rows {
  bids {
    value: 43731
  }
  bids_in_auction {
    value: 43731
  }
  impressions_won {
    value: 34369
  }
  billed_impressions {
    value: 31823
  }
  measurable_impressions {
    value: 31580
  }
  viewable_impressions {
    value: 22820
  }
  row_dimensions {
    time_interval {
      start_time {
        seconds: 1627023600

      }
      end_time {
        seconds: 1627027200
      }
    }
  }
  reached_queries {
    value: 34646
  }
}
bid_metrics_rows {
  bids {
    value: 37903
  }
  bids_in_auction {
    value: 37903
  }
  impressions_won {
    value: 30041
  }
  billed_impressions {
    value: 27974
  }
  measurable_impressions {
    value: 27747
  }
  viewable_impressions {
    value: 20026
  }
  row_dimensions {
    time_interval {
      start_time {
        seconds: 1627027200
      }
      end_time {
        seconds: 1627030800
      }
    }
  }
  reached_queries {
    value: 30329
  }
}
next_page_token: "CAoQwJODrfuI8gIYvdPy4IyJ8gI="

 

每個 bid_metrics_rows 代表 time_interval 針對該時段或該日指定的匯總指標。使用 next_page_token 即可取得下一頁結果。