数据集成

SparkX MMM 支持多种数据接入方式 — 从简单的 CSV 上传到 API 自动同步，满足不同团队的集成需求。

CSV / Excel 上传

拖拽上传 CSV 或 Excel，自动列识别与校验

已支持

→

Google Ads API

OAuth 2.0 授权，每日自动拉取广告花费与转化

开发中

→

Meta Marketing API

Facebook & Instagram 广告数据自动同步

开发中

→

TikTok Marketing API

TikTok Ads 花费数据自动拉取

开发中

→

Google Sheets

连接 Google Sheets，手动或定时触发同步

已支持

→

Custom Webhook

事件驱动数据推送，实时接入自有数据管道

已支持

→

REST API

编程式数据接入，适合 CI/CD 管道集成

已支持

→

Google Analytics (GA4)

流量和转化数据接入（规划中）

规划中

→

Snowflake

数据仓库直连，查询即同步（规划中）

规划中

→

BigQuery

Google BigQuery 数据仓库直连（规划中）

规划中

→

Amazon Ads API

亚马逊广告花费数据拉取（规划中）

即将支持

→

Segment / CDP

客户数据平台事件流接入（规划中）

Beta

→

需要自定义集成？

如果你的数据源不在列表中，可以通过 Webhook 或 REST API 接入任意数据。Enterprise 计划支持定制连接器开发。

联系我们 →

最简单的数据接入方式。上传 CSV/Excel 文件，系统自动识别渠道列、日期列和目标变量列。

接入步骤

在 Data Management 模块点击「上传数据」
选择 CSV 或 Excel 文件（支持 .csv / .xlsx）
系统自动识别列名并匹配渠道映射
校验通过后即可在 Instant Mode 或 Expert Mode 中使用

代码示例

date,google_search,meta,tiktok,youtube,revenue
2026-01-01,3200,2800,1500,800,42000
2026-01-02,3100,2600,1600,850,41500
2026-01-03,3400,2900,1700,900,43500

注意事项

最低数据行数要求：30 行（建议 90 天以上以达到最佳建模效果）。第一列必须是 date，最后一列是目标变量（revenue / conversions）。

通过 Google Ads API 自动拉取搜索、展示、YouTube 等广告渠道的每日花费和转化数据，无需手动导出。

接入步骤

在 Data Management 中添加数据源，选择 Google Ads
OAuth 2.0 授权连接你的 Google Ads 账户
选择要同步的账户层级和渠道（Search / Display / YouTube / Shopping）
配置拉取频率（每日自动）和渠道映射规则
系统自动拉取花费数据并合并到 MMM 数据集

代码示例

GET /api/v1/data/connectors/google-ads/sync
Authorization: Bearer {jwt_token}
Content-Type: application/json

{
  "project_id": "proj_abc123",
  "customer_id": "123-456-7890",
  "date_range": {"start": "2026-01-01", "end": "2026-06-30"},
  "channels": ["search", "display", "youtube", "shopping"]
}

注意事项

OAuth 2.0 授权后数据每日自动同步。支持多账户层级（MCC）。Enterprise 计划功能。

通过 Meta Marketing API 自动拉取 Facebook 和 Instagram 广告的每日花费、展示、点击和转化数据。

接入步骤

在 Data Management 中添加数据源，选择 Meta Ads
使用 Facebook 登录授权（Meta Marketing API）
选择广告账户和要同步的渠道（Facebook / Instagram / Audience Network）
配置拉取频率和渠道映射
系统自动拉取并合并数据

代码示例

GET /api/v1/data/connectors/meta-ads/sync
Authorization: Bearer {jwt_token}

{
  "project_id": "proj_abc123",
  "ad_account_id": "act_123456789",
  "date_range": {"start": "2026-01-01", "end": "2026-06-30"},
  "breakdown": "campaign"
}

注意事项

需要 Meta 开发者账号和应用审核。支持 Campaign / Ad Set / Ad 层级数据。Enterprise 计划功能。

通过 TikTok Marketing API 自动拉取 TikTok 广告的每日花费和转化数据。

接入步骤

在 Data Management 中添加数据源，选择 TikTok Ads
使用 TikTok Business 授权登录
选择广告账户
配置拉取频率和渠道映射
系统自动拉取并合并数据

代码示例

GET /api/v1/data/connectors/tiktok-ads/sync
Authorization: Bearer {jwt_token}

{
  "project_id": "proj_abc123",
  "advertiser_id": "123456789",
  "date_range": {"start": "2026-01-01", "end": "2026-06-30"}
}

注意事项

需要 TikTok for Business 开发者账号。Enterprise 计划功能。

将 Google Sheets 作为数据源。适合已经在 Sheets 中维护营销数据的团队，无需切换到 CSV 上传。

接入步骤

在 Data Management 中添加数据源，选择 Google Sheets
粘贴 Google Sheets 链接并授权只读访问
选择工作表（Sheet Tab）
确认列映射
每次需要更新时点击「同步」或设置定时触发

代码示例

# Sheets 格式要求
- 第一行: 列名 (date, channel_1, channel_2, ..., revenue)
- 第一列: 日期 (YYYY-MM-DD)
- 数据区域: 纯数字，不含公式或格式化

注意事项

Sheets 需设置为「知道链接的人都可以查看」。支持多个工作表分别映射为不同渠道。

如果你的数据仓库（BigQuery、Snowflake 等）已有聚合好的渠道花费数据，可以通过 Webhook 推送到 SparkX。

接入步骤

在 Data Management 中创建 Webhook 数据源
获取唯一的 Webhook URL 和 JWT Token
在你的数据管道中配置定时 POST 推送
系统接收数据后自动校验并合并到项目数据集
每次推送后可自动触发 Instant Mode 重跑

代码示例

POST /api/v1/data/webhook
Authorization: Bearer {jwt_token}
Content-Type: application/json

{
  "project_id": "proj_abc123",
  "date": "2026-07-01",
  "channels": {
    "google_search": 3200.00,
    "meta": 2800.00,
    "tiktok": 1500.00,
    "youtube": 800.00
  },
  "metrics": {
    "revenue": 42000.00
  }
}

注意事项

详见 API 文档中 /api/v1/data/webhook 端点说明。支持增量推送（单日）和批量推送（多日）。

通过 REST API 编程式接入数据。适合已有 ETL 管道、CI/CD 流程或自建数据中台的团队。

接入步骤

在账户设置中生成 API Key（JWT）
调用 /api/v1/data/upload 端点上传数据
调用 /api/v1/agent/run 触发分析
轮询 /api/v1/agent/run/{run_id} 获取结果
调用 /api/v1/budget/optimize 获取预算优化方案

代码示例

# 上传数据
POST /api/v1/data/upload
Authorization: Bearer {jwt_token}
Content-Type: multipart/form-data

# 触发 Instant Mode 分析
POST /api/v1/agent/run
Authorization: Bearer {jwt_token}

{
  "project_id": "proj_abc123",
  "mode": "instant"
}

注意事项

所有端点均使用 JWT Bearer 认证。详见 API 文档。API 直连是 Enterprise 计划功能，Free 和 Pro 用户请使用 CSV/Excel 上传。

通过 GA4 Data API 拉取网站流量、会话和转化数据，与广告花费数据合并进行 MMM 建模。

接入步骤

连接 Google Analytics 账户（OAuth 2.0）
选择 Property 和数据视图
配置维度和指标映射（sessions, conversions, revenue）
设置同步频率
系统自动拉取并合并到数据集

代码示例

# 规划中的端点
GET /api/v1/data/connectors/ga4/sync
Authorization: Bearer {jwt_token}

{
  "project_id": "proj_abc123",
  "property_id": "123456",
  "metrics": ["sessions", "conversions", "totalRevenue"],
  "date_range": {"start": "2026-01-01", "end": "2026-06-30"}
}

注意事项

此集成正在规划中。GA4 数据可用于补充转化漏斗分析，提升模型准确性。

直连 Snowflake 数据仓库，通过 SQL 查询拉取已聚合好的渠道花费和收入数据，无需导出文件。

接入步骤

在 Data Management 中添加 Snowflake 数据源
输入连接凭证（Account / Warehouse / Database / Schema）
编写或选择预置 SQL 查询（选择渠道花费和收入列）
配置同步频率
系统执行查询并合并结果

代码示例

# 规划中的配置
{
  "connector": "snowflake",
  "account": "xy12345.us-east-1",
  "warehouse": "COMPUTE_WH",
  "database": "MARKETING_DB",
  "schema": "AD_SPEND",
  "query": "SELECT date, channel, spend, conversions FROM daily_spend WHERE date >= '2026-01-01'"
}

注意事项

此集成正在规划中。适合已有数据仓库的企业团队。Enterprise 计划功能。

直连 Google BigQuery，通过 SQL 查询拉取已聚合好的营销数据，无需手动导出。

接入步骤

在 Data Management 中添加 BigQuery 数据源
使用 Google Cloud 服务账号授权
选择项目和数据集
编写或选择预置 SQL 查询
配置同步频率

代码示例

# 规划中的配置
{
  "connector": "bigquery",
  "project_id": "my-gcp-project",
  "dataset": "marketing_data",
  "query": "SELECT date, channel, spend, revenue FROM daily_summary WHERE date >= '2026-01-01'"
}

注意事项

此集成正在规划中。适合使用 GCP 生态的企业团队。Enterprise 计划功能。

通过 Amazon MMM API（GA，覆盖 21 个市场）程序化拉取 DSP、Sponsored Products、Sponsored Brands 的媒体花费数据，以及 ASIN 级别的零售销售数据。数据直接映射为 SparkX MMM 的标准输入格式，省去手动下载和整理环节。

接入步骤

在 Data Management 中添加 Amazon Ads 数据源
使用 Amazon OAuth 授权
选择 Profile 和广告类型
配置拉取频率
系统自动拉取并合并

代码示例

# 规划中的端点
GET /api/v1/data/connectors/amazon-ads/sync
Authorization: Bearer {jwt_token}

{
  "project_id": "proj_abc123",
  "profile_id": "123456789",
  "ad_types": ["sponsoredProducts", "sponsoredBrands"],
  "date_range": {"start": "2026-01-01", "end": "2026-06-30"}
}

注意事项

此集成即将上线（预计 v1.4）。Brand Group 需先在 Amazon Ads Console 完成注册并通过审批。支持 COUNTRY / POSTAL_CODE / DMA 三种地理粒度，最多拉取过去 3 年数据。查看技术文档

通过 Segment 或其他 CDP（Customer Data Platform）接入客户事件流数据，用于构建更精细的转化归因模型。

接入步骤

在 Data Management 中添加 CDP 数据源
配置 Segment Source 或 Webhook endpoint
定义事件到渠道的映射规则
设置聚合粒度（每日 / 每周）
系统接收事件并聚合为 MMM 输入

代码示例

# Segment → SparkX Webhook
POST /api/v1/data/cdp/webhook
Authorization: Bearer {jwt_token}

{
  "project_id": "proj_abc123",
  "events": [
    {"event": "Purchase", "channel": "google_search", "revenue": 89.99, "timestamp": "2026-07-01T10:30:00Z"},
    {"event": "Purchase", "channel": "meta", "revenue": 129.99, "timestamp": "2026-07-01T11:15:00Z"}
  ]
}

注意事项

此集成处于 Beta 阶段。CDP 事件流可以补充广告平台归因数据的不足，提升模型准确度。

本站使用 Cookie 和类似技术以提升体验并分析流量。继续浏览即表示同意。详见隐私政策。