← 返回目录
📁 Marketing API › Ad Measurement › Guides › Events API Gateway

自托管设置指南

前提条件

  1. 在部署事件 API 网关之前,确保您已拥有 AWS 账户。 如果您还没有 AWS 账户,可以按照 "创建并激活 AWS 账户" 指南进行创建。

  2. 在本文档中确定托管区域和 TikTok 广告账户。如果您还没有 TikTok 广告账户,可以点击此处创建。

  3. 将托管区域(例如 us-east-1)和 TikTok 广告账户 ID(见下方截图)告知您的 TikTok 负责人,之后我们将为您生成安装链接。

广告主账户ID

  1. AWS 账户权限要求
|AWS 服务{30%}|访问级别{70%}|
|---|---|
| CloudFormation | 完全访问权限 |
| EC2 | 完全访问权限 |
| EC2 Auto Scaling | 完全访问权限 |
| EKS | 完全访问权限 |
| IAM | 完全访问权限 |
| Security Token Service | 角色切换权限 |
| Systems Manager | 完全访问权限 |
| ACM | Write |
| ELB | 完全访问权限 |
| CloudWatch | 写入权限 |
| CloudWatch Logs | 写入权限 |
| EventBridge | 写入权限 |

在 AWS 上的安装

点击安装链接,系统将跳转至 AWS CloudFormation 堆栈,开始快速部署流程:

  • Stack name 和 ProvisioningData 字段将会被预填写,请勿更改 ProvisioningData 字段。
  • 在 InstanceName 字段中为您的事件 API 网关实例命名:

实例名称字段

  • 选中 I acknowledge that AWS CloudFormation might create IAM resources with custom names. (我确认 AWS CloudFormation 可能会创建带有自定义名称的 IAM 资源) 复选框。
  • 点击 Create stack (创建堆栈) 以开始安装。

创建堆栈

部署过程通常需要 30 到 40 分钟。完成后,新的 AWS 实例将在 Outputs(输出) 标签页下显示三个输出项。当 Stack info(堆栈信息) 标签页中的状态显示为 CREATE_COMPLETE 时,表示部署已完成。

CREATE_COMPLETE

完成后,进入 Outputs(输出) 标签页,您将看到以下信息: - BastionHost(用于在 AWS 控制台查看堡垒主机的 URL) - EapigHomePage(事件 API 网关 UI 的主页 URL) - InstallationLogLocation(安装状态和进度将在此 CloudWatch 日志组中可以查看)

如果在部署过程中出现任何问题,系统将自动启动回滚流程。当 Stack info(堆栈信息) 标签页中的状态显示为 ROLLBACK_COMPLETE 时,表示回滚已完成。您可以进入 Events(事件) 标签页进行更详细的分析,该标签页会列出部署过程中发生的所有事件,说明失败发生的具体步骤及原因。

ROLLBACK_COMPLETE

CloudWatch 中的 EventsAPIGateway/cloud-init-output.log 文件显示了详细的安装日志。

CloudWatch 安装日志

首个租户数据源

复制 Pixel 代码

内容来源:TikTok API for Business 官方文档 · 本地归档

在接这个接口时卡住了?
Stuck wiring this API into production? We build ad-delivery tooling on these platforms — campaign automation, reporting pipelines, error-handling and migration between API versions.
联系我们 · Talk to us 每日平台更新简报 →