You need to enable JavaScript to run this app.
导航
Http API数据接入指南
最近更新时间:2024.11.28 17:01:32首次发布时间:2023.07.28 16:04:32

1. 产品概述

支持实时API数据接入,API类型为回调型,即当发生变更时,直接回调CDP。通过此功能,客户可以实时获取数据变更的通知,便于及时处理数据变更。

2. 使用限制
  • 用户需具备 项目中心-权限-按内容管理-模块-数据管理-新建连接 权限。
  • 该功能仅SaaS支持。

3. 操作步骤

1.点击 数据管理 - 数据连接
2.在数据连接目录左上角- 新建数据连接 按钮,选择 API - HTTP API
Image
Image

  • header:点击按钮自动生成,下方示例数据会实时同步header信息。
  • URL地址:系统默认生成,用户可自行配置,填入希望接入的数据URL
  • 输出数据类型:可选「数据集」或「元数据」

信息填写完成后,点击「测试连接」,成功后即可「保存」。

3.1 存储为数据集

输出数据类型选中「数据集」,会将api传入的实时数据存为数据集。
Image
点击右上角「一键接入」,将自动创建prep建模流程,生成数据集。
Image

3.2 存储为元数据

存储类型选中「元数据」,会在创建数据集基础上进行实时id-mapping,后自动在元数据管理中注册为实时数据源。
点击右上角「一键接入」,将弹窗进行实时id-mapping设置。可选 实时转换实时生成。(可选的主体和ID类型需要先在ID图谱构建中完成配置)

  • 实时转换:根据现有One-ID(即基准ID BaseID)实时查询,仅转换历史生成过one-id的部分。
  • 实时生成:根据ID-Mapping统一服务,实时生成One-ID(即基准ID BaseID),历史未生成过one-id的部分将重新生成one-id。

注意

实时生成ID-Mapping会影响CDP内主体全部数据的使用,仅支持集团管理员使用。

Image
接入成功后,点击右上角「查看元数据」将跳转元数据管理页面,显示已经自动注册好的数据源。
Image

4. 常见问题

Q1:Http Api 和Rest Api 有什么区别呢?

Http Api 是由平台侧提供上报接口,用户通过Http Api建立实时回传通道,平台侧接收用户行为事件数据上报进入CDP,最终数据会处理成行为数据格式(产物:实时数据源 - 行为元数据),Rest Api是由用户侧提供接口,平台侧来负责定期地离线同步数据。

Q2:Http Api 和流式数据源有什么区别呢?

流式数据库需要用户自有(私有化部署客户支持开源 Kafka 和 Pulsar,SaaS客户仅支持火山Kafka)。如果用户没有Kafka,则可选择Http Api。