设置实时“Bing Ads 受众估算”任务
此端点根据指定的定向条件提供广告活动的预估受众规模。
授权
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
请求体
搜索引擎位置的完整名称。如果未指定 location_code 或 location_coordinate,则此字段为必填字段。如果使用此字段,则无需指定 location_code 或 location_coordinate。您可以单独请求 https://api.dataforseo.com/v3/keywords_data/bing/locations,获取搜索引擎的可用位置及其 location_name 列表。示例:London,England,United Kingdom
搜索引擎位置代码。如果未指定 location_name 或 location_coordinate,则为必填字段。如果使用此字段,则无需指定 location_name 或 location_coordinate。可通过向 https://api.dataforseo.com/v3/keywords_data/bing/locations 单独发送请求,获取搜索引擎的可用位置及其 location_code。示例:2840
位置的 GPS 坐标。如果未指定 location_name 或 location_code,则为必填字段。如果使用此字段,则无需指定 location_name 或 location_code。location_coordinate 参数应采用“latitude,longitude,radius(单位:km)”格式。将提供指定坐标所属国家/地区的数据。示例:29.6821525,-82.4098881,100
选择用于定向的年龄范围;可能的值:eighteen_to_twenty_four, fifty_to_sixty_four, sixty_five_and_above, thirteen_to_seventeen, thirty_five_to_forty_nine, twenty_five_to_thirty_four, unknown, zero_to_twelve
所需的出价设置值(美元),最大值:1000
每日广告活动预算值(美元),最大值:10000
目标性别,可选值:male、female、unknown
LinkedIn 个人资料定向的行业;如果使用此字段,可向 https://api.dataforseo.com/v3/keywords_data/bing/audience_estimation/industries 单独发出请求,以获取包含 industry_id 的可用行业名称列表。示例:806301758
LinkedIn 个人资料定向的职位职能;如果使用此字段,可以通过向 https://api.dataforseo.com/v3/keywords_data/bing/audience_estimation/job_functions 单独发出请求,获取包含 job_function_id 的可用职位职能名称列表;示例:806300451
响应
成功响应
API 的当前版本
通用状态码;您可以在此处查看完整的响应码列表。注意:我们强烈建议设计必要的系统来处理相关异常或错误情况
常规信息消息;可在此处查看常规信息消息的完整列表
执行时间(秒)
任务总成本(美元)
tasks 数组中的任务数量
返回错误的 tasks 数组中的任务数量
任务数组
任务标识符,系统中采用 UUID 格式的唯一任务标识符
DataForSEO 生成的任务状态码;取值范围为:10000-60000,完整的响应码列表可在此处查看
任务的信息性消息,你可以在此处查看通用信息性消息的完整列表
执行时间(秒)
任务成本(美元)
结果数组中的元素数量
URL 路径
包含您在 POST 请求中指定的相同参数
结果数组
每月预估展示次数范围
表示结果范围的上限
指示范围结果的下限
每月预计覆盖用户数范围
表示结果范围的上限
指示范围结果的下限
月度预估点击次数范围
表示结果范围的上限
指示范围结果的下限
每月预计支出范围
表示结果范围的上限
指示范围结果的下限
表示带范围结果的预计单次事件成本
表示结果范围的上限
指示范围结果的下限
预估点击率范围
表示结果范围的上限
指示范围结果的下限
当前定向条件下的建议出价值
当前定向和出价条件下的建议每日预算值
表示因输入出价不足而丢失的事件数量
表示由于输入预算不足,事件计数发生丢失
月度预估用户数
每月预估展示次数
货币名称,例如:USDollar