工具 API
rf_
Get inventory estimates for Reach & Frequency ads via /open_api/v1.3/rf/inventory/estimate/. Use this endpoint to estimate inventory for planned R&F delivery and compare the prediction results with TikTok Ads Manager. In v1.3, `reach_percentage` is deprecated, `advertiser_id` changed from number to string, several targeting parameter names changed, and new request parameters include `rf_purchased_type`, `budget`, `purchased_impression`, `purchased_reach`, `rf_campaign_type`, and `contextual_tag_ids`. Contextual tags and pre-bid third-party brand safety are allowlist-only features. If `rf_campaign_type` is `PULSE`, you must later pass the `location_id` returned by this endpoint to `location_ids` when creating the ad group with /adgroup/rf/create/. See https://ads.tiktok.com/marketing_api/docs?id=1744571201117186 for inventory-estimate details and result mapping.
调用信息
- 工具标识
- tiktok-ads.rf_inventory_estimate
- 服务提供方
- TikTok 广告
- 平均响应
- 0 ms
- 近 7 天调用
- 0
输入参数
advertiser_id必填Advertiser ID.
audience_info必填Audience targeting rules used for the inventory estimate.
budgetBudget amount. Required when `rf_purchased_type` = `FIXED_BUDGET`. Based on the budget you specify, the endpoint returns estimated values for the other fields.
cpv_video_durationTarget video view duration.
feed_typeFeed type. `STANDARD_FEED` provides larger inventory with normal CPM pricing. `TOP_FEED` provides more limited inventory with higher CPM pricing.
frequency必填Frequency cap count. Together with `frequency_schedule`, this sets the maximum ad exposure rate for Reach & Frequency ads. Example: `frequency = 2` and `frequency_schedule = 3` means the ad is shown at most twice every 3 days. Constraints: `1 ≤ frequency ≤ frequency_schedule`; `1 ≤ frequency_schedule ≤ min(schedule_end_time - schedule_start_time, 30)`; and the cap derived from `frequency` plus `frequency_schedule` must not exceed four times per day.
frequency_schedule必填Frequency cycle in days. Together with `frequency`, this sets the maximum ad exposure rate for Reach & Frequency ads. See the `frequency` rules and limits.
objective_type必填Advertising objective.
purchased_impressionImpressions to purchase, in units of 1,000. Required when `rf_purchased_type` = `FIXED_SHOW`. Based on the impression amount you specify, the endpoint returns estimated values for the other fields.
purchased_reachUsers reached to purchase, in units of 1,000. Required when `rf_purchased_type` = `FIXED_REACH`. Based on the reach amount you specify, the endpoint returns estimated values for the other fields.
rf_campaign_typeUse this field with `objective_type = RF_REACH` to mark the campaign as TikTok Pulse and obtain available premium contextual tags. Enum values: `STANDARD` for a standard Reach & Frequency campaign, or `PULSE` for a TikTok Pulse campaign. If set to `PULSE`, only one `location_id` is returned. Do not pass this field when `objective_type` is not `RF_REACH`. If `PULSE` is used, you must pass the `location_id` returned by this endpoint to `location_ids` in /adgroup/rf/create/ when creating the TikTok Pulse ad group.
rf_purchased_typeBuying type. `FIXED_SHOW` purchases a fixed number of impressions. `FIXED_REACH` purchases a fixed number of reached users. `FIXED_BUDGET` purchases against a fixed budget. This field determines which companion field is required: `budget` for `FIXED_BUDGET`, `purchased_impression` for `FIXED_SHOW`, or `purchased_reach` for `FIXED_REACH`.
schedule_end_time必填End time in UTC+0, format `YYYY-MM-DD HH:MM:SS`. The `HH:MM:SS` portion must equal `23:59:59` for the target region. The interval between `schedule_end_time` and `schedule_start_time` must not exceed 30 days. If `location_ids` observe Daylight Saving Time, ignore DST and pass Standard Time instead.
schedule_start_time必填Start time in UTC+0, format `YYYY-MM-DD HH:MM:SS`. The `HH:MM:SS` portion must equal `00:00:00` for the target region. If `location_ids` observe Daylight Saving Time, ignore DST and pass Standard Time instead.