报表数据延迟

在通过报表 API 创建报表时需注意，报表中某些数据字段可能存在数据延迟。数据延迟的时间取决于报表基于的数据类型和具体字段。

两种数据源

数据延迟源于 TikTok 广告管理平台上的两种数据类型（实时数据和离线数据）及对应的刷新机制。

实时数据刷新频繁，请求数据后需等待时间短。实时数据第二天会通过离线数据进行微调，从而保证数据的准确性。

离线数据与实时数据相比，刷新不那么频繁。离线数据刷新发布时，必要的数据处理（例如数据除重）已完成，因此离线数据不需要进行后续的微调。除reach字段为估算值外，其他数据均为准确数据。

注意

报表管理 API 数据仅用于报告目的。若您想实现自动规则等用例，请先查看自动规则 API 的相关介绍。
对于定制化的用例或自动规则，请联系 TikTok API for Business 团队以获取指导和技术支持。

数据延迟层级

TikTok 广告管理平台的数据延迟分为三个层级：天级、小时级和分钟级。

天级数据延迟

以下数据类型以离线数据形式发布，数据延迟时间通常为 48 小时：

商务中心报表： - tax_spend指标的数据。

小时级数据延迟

以下数据类型以离线数据形式发布，数据延迟时间通常为 16 小时：

基础报表： - 使用任意维度时的 UV（独立访客）类数据以及voucher_spend和cash_spend指标的数据。 - 使用以下任意维度时的所有数据： - 定向维度 ad_type - 资产维度 custom_event_type、event_source_id、page_id、component_name 和 post_id - 搜索维度 search_terms

注意
UV类指标包括：
reach，cost_per_1000_reached，
frequency，以及
当 optimization_goal（优化目标）为REACH时的成效指标：
result，cost_per_result，result_rate，
real_time_result，real_time_cost_per_result，real_time_result_rate，
secondary_goal_result，cost_per_secondary_goal_result，secondary_goal_result_rate，
skan_result，skan_cost_per_result，skan_result_rate。

受众分析报表：

使用任意维度时的UV（独立访客）类指标数据。
使用以下任意定向维度时的所有指标数据：
platform
device_brand_id
ad_type
gender
province_id
dma_id
age
language
interest_category
interest_category_tier2
interest_category_tier3
interest_category_tier4
interest_category
hashtag
audience_tags
additional_interests
ac
contextual_tag

注意
使用定向维度 behavior_id 或 purchase_intention 时，指标数据延迟仍为小时级，但延迟时间为 24 小时。

试玩素材报表：

所有数据。

DSA 报表：

所有数据。

商务中心报表： - cash_spend，voucher_spend和cashback_coupon_spend指标的数据。

分钟级数据延迟

以下数据类型以实时数据形式发布，通常数据延迟时间为 30 分钟：

注意
极端情况下，实时数据的延迟可能达到或超过 2 小时。

基础报表： - 未使用定向维度ad_type，资产维度 custom_event_type，event_source_id，page_id，component_name和 post_id 或搜索维度 search_terms 时，除UV类数据以及voucher_spend和cash_spend指标的数据外的所有数据。

受众分析报表： - 使用定向维度country_code或placement时的非 UV 类指标数据。

商务中心报表： - 除cash_spend，voucher_spend、tax_spend和cashback_coupon_spend外其他指标的数据。

最大成交额广告报表： - 所有指标的数据。

注意
实时数据会进行微调，每天 12:00（UTC+0）期间会运行数据修复脚本，因此推荐在 12:00（UTC+0）后抓取数据。

数据延迟参照表

通过下列参照表，可快速查看请求某类报表时，某类数据对应的期望延迟时间。

|报表类型{20%}|数据类别{60%}|延迟时间{20%}|
|---|---|---|
|基础报表|使用任意维度时：<ul><li> UV类指标数据，UV类指标包括：<ul><li>`reach`，`cost_per_1000_reached`，</li><li>`frequency`，以及</li><li>当 `optimization_goal`（优化目标）为`REACH`时的成效指标：<ul><li>`result`，`cost_per_result`，`result_rate`，</li><li>`real_time_result`，`real_time_cost_per_result`，`real_time_result_rate`， </li><li>`secondary_goal_result`，`cost_per_secondary_goal_result`，`secondary_goal_result_rate`，</li><li>`skan_result`，`skan_cost_per_result`，`skan_result_rate`。</li></ul></li></ul></li><li> `voucher_spend`和`cash_spend`指标数据。</li></ul>|16 小时|
|基础报表|使用以下任意维度时的所有数据：<ul><li>定向维度 `ad_type`</li><li>资产维度  `custom_event_type`、`event_source_id`、`page_id`、`component_name` 和 `post_id`</li><li>搜索维度 `search_terms`</li></ul>|16 小时|
|基础报表|<strong>未</strong>使用定向维度`ad_type`，资产维度 `custom_event_type`，`event_source_id`，`page_id`，`component_name`和 `post_id` 或搜索维度 `search_terms` 时：<ul><li> 除 UV类指标以及`voucher_spend`和`cash_spend`指标外的指标数据。</li></ul>|30 分钟|
|受众分析报表|使用定向维度 `behavior_id` 或 `purchase_intention` 时的所有指标数据|24 小时|
|受众分析报表| <ul><li>使用任意维度时的 UV（独立访客）类指标数据。</li><li>使用以下任意定向维度时的所有指标数据：<ul><li>`platform`</li><li>`device_brand_id`</li><li>`ad_type`</li><li>`gender`</li><li>`province_id`</li><li>`dma_id`</li><li>`age`</li><li>`language`</li><li>`interest_category`</li><li>`interest_category_tier2`</li><li>`interest_category_tier3`</li><li>`interest_category_tier4`</li><li>`interest_category`</li><li>`hashtag`</li><li>`audience_tags`</li><li>`additional_interests`</li><li>`ac`</li><li>`contextual_tag`</li></ul></li></ul> |16 小时|
|受众分析报表| 使用定向维度`country_code`或`placement`时的非 UV 类指标数据。|30 分钟|
|试玩素材报表| 所有数据。|16 小时|
|DSA 报表| 所有数据。|16 小时|
| 商务中心报表 |`tax_spend`的指标数据。 | 48 小时 |
| 商务中心报表 |  `cash_spend`，`voucher_spend` 和 `cashback_coupon_spend`指标的数据。 | 16 小时 |
| 商务中心报表 | 除`cash_spend`，`voucher_spend`，`tax_spend`和`cashback_coupon_spend`外的指标数据。 | 30 分钟 |
| 最大成交额广告报表 | 所有数据。 | 30 分钟 <br><br><p><span style="color:darkred"><b>注意</b></span>： 此延迟仅适用于使用 [/report/integrated/get/](https://business-api.tiktok.com/portal/docs/run-a-synchronous-report/v1.3) 创建的最大成交额广告报表。如果你使用[/gmv_max/report/get/](https://business-api.tiktok.com/portal/docs/run-a-gmv-max-campaign-report/v1.3) 创建了 GMV Max 推广系列报表，延迟时间最长可达 24 小时。|