esnerd/keboola-bingads-ex

BingAds数据提取器

Keboola Connection的Docker应用，用于从BingAds API提取数据。

核心功能

该组件从BingAds API的两个服务中获取数据：

• Bulk Service：提供BingAds对象的完整实体数据，支持提取ads（广告）、adgroups（广告组）、campaigns（推广活动）、site_links_ad_extensions（站点链接广告扩展）、keywords（关键词）等数据集。
• Reporting Service：提供指定聚合级别的性能数据，支持AdsPerformance（广告性能）、KeywordPerformance（关键词性能）、AdExtensionDetail（广告扩展详情）、AdExtensionByKeyWord（按关键词的广告扩展）、AdExtensionByAd（按广告的广告扩展）等报告类型。

使用场景

1. 批量提取BingAds账户中的实体数据，用于本地分析或数据仓库集成。
2. 获取广告性能报告，评估不同广告组/关键词的投放效果。
3. 增量同步数据，避免重复下载历史数据，提升效率。

配置说明

认证

1. 申请开发者令牌（Developer Token）：参考Bing Ads入门指南。
2. 通过Microsoft账户授权获取刷新令牌：在组件配置界面点击“Authorize Account”按钮完成授权。

参数

• #devKey（必填）：开发者令牌。
• customerId（必填）：BingAds账户的客户ID。
• accountId（必填）：BingAds账户ID，获取方式参考账户ID与客户ID获取指南。
• bucket（必填）：存储结果的桶名称。
• sinceLast（可选）：是否从上次下载状态继续（仅首次运行时考虑startDate），默认值为TRUE。
• bulkRequests（必填）：指定是否包含Bulk Service的数据集（true/false），包括ads、campaigns、keywords等。
• reportRequests（必填）：报告查询列表，每个查询包含类型、起始日期/周期、聚合级别等参数。

配置示例

用例1：从指定日期提取所有数据

json
{
  "#devKey": "yourdevkey",
  "customerId": 123456,
  "accountId": 123456,
  "bucket": "in.c-test",
  "sinceLast": false,
  "bulkRequests": {
    "ads": true,
    "campaigns": true,
    "keywords": true,
    "campQualityScore": true,
    "siteLinkAddExtensions": true,
    "adGroups": true
  },
  "reportRequests": [
    {"type": "AdsPerformance", "startDate": "21-03-2016"},
    {"type": "KeywordPerformance", "startDate": "21-03-2016"}
  ]
}

Docker部署示例

将配置文件挂载到容器运行：

bash
docker run -v /path/to/config.json:/app/config.json esnerd/keboola-bingads-ex --config /app/config.json