工具 API

audience_segment_operate

Creates or deletes an audience segment through the Streaming API endpoint `/open_api/v1.3/segment/audience/`. Access is allowlist-only: to apply for Streaming API access (formerly Segment API), use the Allowlist Management feature in the Developer Portal and select "Streaming API". Rate limit is 1 QPS per advertiser account. You can have up to 400 audience segments per advertiser account; if this advertiser-level limit is reached, delete existing audiences before creating new ones. Before using this endpoint, review the Streaming API important notes for Multiple Advertisers Associated with a Business Account and Mixed Segments with IDFA/AAID, and follow the identifier normalization guidance at https://business-api.tiktok.com/portal/docs?id=1850030360880129.

ecommerceOAuth1 积分

调用信息

工具标识
tiktok-ads.audience_segment_operate
服务提供方
TikTok 广告
平均响应
0 ms
近 7 天调用
0

输入参数

action必填

Action to perform. `create` creates an audience segment and requires `custom_audience_name`. `delete` deletes an audience segment and requires `delete_audience_id`. If omitted, the default is `create`.

advertiser_id必填

Advertiser ID.

custom_audience_name

Name of the audience segment to create. Required when `action` is `create`. Names longer than 70 characters are truncated to 67 characters and appended with `...`.

delete_audience_id

Audience ID of the segment to delete. Required when `action` is `delete`.