Google Ads 关键词流量实时估算
/keywords_data_google_ads_ad_traffic_by_keywords_live为提交的关键词估算 Google Ads 流量,包含所选定向条件下的展示量、点击量和费用。
- 最近 7 天完成的调用
- 0
统计不包含取消的调用。执行时间仅统计成功调用。
通过你的 Agent 使用
请安装 https://www.agentrouter.to/SKILL.md,然后通过 AgentRouter 使用 DataForSEO 的 /keywords_data_google_ads_ad_traffic_by_keywords_live 接口。
输入参数
keywords必填- 关键词,必填。最多 1000 个,每个最多 80 个字符,每个短语最多 10 个词,关键词会转换为小写。Google Ads 可能不为某些关键词组返回数据,详情参见帮助中心。另外,Google Ads 不允许部分符号和字符,如 UTF 符号、表情符号,创建任务时也不能使用;可用字符详情参见相关文章。DataForSEO API 中 keyword 和 keywords 字段的规则及限制参见帮助中心文章。
bid必填- 最高自定义出价,必填。收集数据基于此值,代表愿意为广告支付的价格;出价越高,返回指标值越高。详情参见帮助中心文章。
match必填- 关键词匹配类型,必填,可用值:exact、broad、phrase。
location_name选填- 搜索引擎地区的完整名称。 可选字段。 不指定地区则返回全球结果,即所有可用地区的数据; 使用此字段后无需指定 location_code 或 location_coordinate;可单独请求下列地址,获取搜索引擎可用地区及其 location_name : https://api.dataforseo.com/v3/keywords_data/google_ads/locations;例如: London,England,United Kingdom
location_code选填- 搜索引擎地区代码。 可选字段。 不指定地区则返回全球结果,即所有可用地区的数据; 使用此字段后无需指定 location_name 或 location_coordinate ;;可单独请求下列地址,获取搜索引擎可用地区及其 location_code : https://api.dataforseo.com/v3/keywords_data/google_ads/locations;例如: 2840
location_coordinate选填- 地区 GPS 坐标。 可选字段。 不指定地区则返回全球结果,即所有可用地区的数据; 使用此字段后无需指定 location_name 或 location_code ; location_coordinate 参数应使用以下格式指定: "latitude,longitude" 格式; 数据将针对所指定坐标所属的国家提供。 ;;例如: 52.6178549,-155.352142
language_name选填- 搜索引擎语言的完整名称。 可选字段。 可单独请求下列地址,获取搜索引擎可用语言及其 language_name : https://api.dataforseo.com/v3/keywords_data/google_ads/languages;例如: English
language_code选填- 搜索引擎语言代码。 可选字段。 可单独请求下列地址,获取搜索引擎可用语言及其 language_code : https://api.dataforseo.com/v3/keywords_data/google_ads/languages;例如: en
date_from选填- 预测时间范围起始日期。指定 date_to 时必填;同时提供 date_from 和 date_to 后无需 date_interval。最早为明天,date_from 不应晚于 date_to。日期格式为 "yyyy-mm-dd",例如 "2021-10-30"。状态接口的 actual_data 为 false 时,date_from 可设为上上个月或更早;actual_data 为 true 时,可设为上个月或更早。
date_to选填- 预测时间范围结束日期。指定 date_from 时必填;同时提供 date_from 和 date_to 后无需 date_interval。最早为 date_from +1 天,最晚为明年的同月同日。日期格式为 "yyyy-mm-dd",例如 "2022-10-30"。
date_interval选填- 预测日期区间,可选。指定 date_interval 后无需 date_from 和 date_to。可用值:next_week、next_month、next_quarter,默认 next_month。
sort_by选填- 结果排序参数。 可选字段。 使用这些参数按以下字段排序: relevance , impressions , ctr , average_cpc , cost , or clicks 按降序排列;默认值: relevance
输入示例
{
"location_code": 2840,
"language_code": "en",
"bid": 999,
"match": "exact",
"keywords": [
"seo marketing"
]
}输出
原生任务结果封装;在支持时包含条目、聚合结果和分页信息。