使用 RTB Troubleshooting API

由于 Authorized Buyers (AB) 与需求方平台 (DSP) 之间的可结算展示计数存在差异，一小部分有保证的程序化 (PG) 交易不会在 AB 中完全投放。

若要找出存在问题的交易，您可以使用 RTB Troubleshooting API 来提取“可结算展示次数”，以便将 AB 报表与 DSP 端报表进行比对并突出显示差异较大的交易。这些可结算展示是我们据以向买方收费的净创收展示。

支出的计算公式为：提取的可结算展示次数 x 相应交易的静态 CPM。

第 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，出价指标会显示为一行；如果指定了 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 可获取下一页结果。