POST /api/v1/client-api/exports/placements/

获取版位信息

获取付费墙、用户引导或流程版位的配置:每个版位中的目标受众、市场细分和 A/B 测试,以及每个目标受众所对应的付费墙、用户引导或流程。这有助于您无需逐一打开每个版位即可确认所有配置是否正确。

速率限制:每秒 2 次请求。

Request body

filtersobjectrequired
placement_typestringrequired

要返回的版位类型。每次请求返回一种类型的版位。

One of: "paywall", "onboarding", "flow"

Responses

版位信息获取成功

Schema

响应包含一个数组,以您请求的 placement_type 命名:paywall_placements、onboarding_placements 或 flow_placements。

paywall_placementsarray of object

当 placement_type 为 paywall 时返回

developer_idstring

版位 ID

placement_namestring

版位名称

audience_namestring

目标受众名称

segment_namestring

该目标受众所基于的市场细分名称

cross_placement_ab_test_namestring

跨版位 A/B 测试名称

ab_test_namestring

A/B 测试名称

paywall_namestring

在此版位展示的付费墙名称

onboarding_placementsarray of object

当 placement_type 为 onboarding 时返回

developer_idstring

版位 ID

placement_namestring

版位名称

audience_namestring

目标受众名称

segment_namestring

目标受众所基于的市场细分名称

cross_placement_ab_test_namestring

跨版位 A/B 测试名称

ab_test_namestring

A/B 测试名称

onboarding_namestring

在此版位显示的用户引导名称

flow_placementsarray of object

当 placement_type 为 flow 时返回

developer_idstring

版位 ID

placement_namestring

版位名称

audience_namestring

目标受众名称

segment_namestring

目标受众所基于的市场细分名称

cross_placement_ab_test_namestring

跨版位 A/B 测试名称

ab_test_namestring

A/B 测试名称

flow_namestring

在此版位展示的流程名称

Bad Request

Schema
errorsarray of object
sourcestring
errorsarray of string
error_codestring
status_codeinteger

Unauthorized

Schema
errorsarray of object
sourcestring
errorsarray of string
error_codestring
status_codeinteger

超出速率限制。每个 API 密钥每秒最多 2 次请求。