必应的获取广告效果数据的api怎么请求

必应的获取广告效果数据的 API 如何请求

WordPress建站?

摘要：本文将深入探究必应广告效果数据 API 的请求过程，包括必需的参数、请求格式以及响应数据的结构。通过示例请求和响应，您将获得对 API 使用的全面理解。

必应广告效果数据 API 简介

必应广告效果数据 API 允许开发者获取其广告活动的性能数据，例如点击次数、曝光次数和转化次数。通过此 API，您可以分析广告效果、优化广告系列并提高投资回报率 (ROI)。

设置先决条件

在请求 API 之前，您需要设置以下先决条件：

有效的必应广告帐户
开发者应用程序，并获取客户端 ID 和客户端密钥
OAuth 2.0 刷新令牌

请求 API

要请求 API，请按照以下步骤操作：

1. 构建请求 URL

请求 URL 的格式为：

https://ads.microsoft.com/api/reporting/v11/reporting/searchcampaigns/{campaignId}

其中 {campaignId} 是要检索广告效果数据的广告系列的 ID。seo文章代写!

2. 添加查询参数

相关阅读：如何提升必应搜索排名？营销攻略！

以下查询参数是必需的：自动内链插件!

start_date: 广告效果数据的开始日期，格式为 YYYY-MM-DD
end_date: 广告效果数据的结束日期，格式为 YYYY-MM-DD
grant_type: 授权类型，应设置为 “refresh_token”
client_id: 开发者应用程序的客户端 ID
client_secret: 开发者应用程序的客户端密钥
refresh_token: OAuth 2.0 刷新令牌

3. 构建请求正文

请求正文应包含以下 JSON 对象：

json { "report_type": "accounts_top_level", "aggregation_level": "campaign", "columns": ["campaign_id", "campaign_name", "impressions", "clicks", "conversions"] }

report_type: 报告的类型，应设置为 “accountstoplevel”
aggregation_level: 数据聚合级别，应设置为 “campaign”
columns: 要检索的字段列表

请求示例

下面的示例请求检索过去 30 天内广告系列 ID 为 12345 的广告效果数据：

相关阅读：如何进行必应的本地企业搜索优化？

URL: https://ads.microsoft.com/api/reporting/v11/reporting/searchcampaigns/12345 查询参数: - start_date: 2023-01-01 - end_date: 2023-01-30 - grant_type: refresh_token - client_id: YOUR_CLIENT_ID - client_secret: YOUR_CLIENT_SECRET - refresh_token: YOUR_REFRESH_TOKEN 请求正文: { "report_type": "accounts_top_level", "aggregation_level": "campaign", "columns": ["campaign_id", "campaign_name", "impressions", "clicks", "conversions"] }JS转Excel.

响应数据

API 响应是 JSON 格式的数据对象，包含请求的广告效果数据。响应的结构如下：标签导出插件?

json { "Report": { "AdvertiserId": "12345", "AdvertiserName": "My Advertiser Name", "ReportData": [ { "CampaignId": "12345", "CampaignName": "My Campaign Name", "Impressions": 1000, "Clicks": 50, "Conversions": 10 } ] } }

ReportData 数组包含广告系列的广告效果数据。每个元素表示一个广告系列，并包含以下字段：