> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloudx.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 竞价流量压缩

> OpenRTB 竞价请求和竞价响应的 HTTP 压缩支持

CloudX 支持对与需求合作伙伴交换的 OpenRTB 流量使用 gzip 和 zstd 压缩。压缩功能按竞价端点启用，并由需求合作伙伴与 CloudX 协调配置。

## 竞价请求

启用压缩后，CloudX 会压缩 OpenRTB JSON 请求体，并通过 HTTP `Content-Encoding` 标头标明压缩算法：

```http theme={null}
Content-Encoding: zstd
Content-Type: application/json
```

竞价端点必须先解压请求体，再解析 OpenRTB 请求。

CloudX 也可能声明其接受的响应编码：

```http theme={null}
Accept-Encoding: gzip, zstd
```

## 竞价响应

当 `Accept-Encoding` 包含 `gzip` 或 `zstd` 时，需求合作伙伴可以使用其中任一编码压缩 OpenRTB 响应。请将 `Content-Encoding` 设置为实际使用的算法：

```http theme={null}
Content-Encoding: zstd
Content-Type: application/json
```

请勿发送缺少相应 `Content-Encoding` 标头的压缩响应体。

## 失败处理和回滚

如果响应使用不受支持的编码、压缩响应体缺少 `Content-Encoding` 标头或标头与响应体不匹配，或者响应体无法解压，则该响应将被视为无效并排除在竞价之外。CloudX 不会自动以未压缩方式重试该响应。请联系 CloudX，将端点恢复为 gzip 或未压缩流量。

## 启用方式

请联系 CloudX，为您的竞价端点协调启用和验证流程。现有集成仍支持 gzip。