创意创建 API 端点

概述

创意创建 API 端点允许开发者创建新创意并自动管理活动和广告集。
此端点智能处理现有资源并根据需要创建新资源。

端点详情

URL: POST /v1/creatives
身份验证: 必需（Audiencelab-Token 标头）
Content-Type: application/json

身份验证

在请求标头中包含您的团队访问令牌：

Audiencelab-Token: your_team_access_token_here

请求体

必需字段

creative (string) – 您的创意名称
app_api_key (string) – 您的应用程序 API 密钥，用于标识创意所属的应用

可选字段

campaign (string) – 活动名称（如果未提供，将创建基于周的活动）
adset (string) – 广告集名称（如果未提供，将创建基于天的广告集）

请求体示例

{
  "creative": "夏季促销横幅",
  "app_api_key": "your_app_api_key_here",
  "campaign": "Q4 活动",
  "adset": "Facebook 广告"
}

行为

当提供活动和广告集名称时

现有活动 + 现有广告集 → 重用两个现有资源
现有活动 + 新广告集 → 重用活动，创建新广告集
新活动 + 新广告集 → 创建两个新资源

当未提供活动和广告集名称时

活动：自动创建 "第 X 周"（例如，"第 45 周"）
广告集：自动创建日期名称（例如，"星期一"、"星期二"）

响应格式

成功响应 (201 Created)

{
  "message": "创意创建成功",
  "creative": {
    "name": "夏季促销横幅",
    "tracking_link": "https://appstore-download.com/creative_token"
  },
  "campaign": {
    "name": "Q4 活动",
    "is_new": false
  },
  "adset": {
    "name": "Facebook 广告",
    "is_new": true
  },
  "application": {
    "name": "您的应用名称"
  }
}

响应字段说明

creative.name → 您为创意提供的名称
creative.tracking_link → 为创意生成的跟踪 URL
campaign.name → 活动名称（提供或自动生成）
campaign.is_new → 布尔值，指示是否创建了新活动
adset.name → 广告集名称（提供或自动生成）
adset.is_new → 布尔值，指示是否创建了新广告集
application.name → 您的应用程序名称

错误响应

400 Bad Request

{ "message": "需要创意名称" }

{ "message": "需要 API 密钥" }

{ "message": "无效的 API 密钥或未找到应用程序" }

401 Unauthorized

{ "message": "身份验证令牌不正确" }

使用示例

示例 1：创建具有特定活动和广告集的创意

curl -X POST https://app.audiencelab.ai/api/v1/creatives \
  -H "Content-Type: application/json" \
  -H "Audiencelab-Token: your_team_token" \
  -d '{
    "creative": "假日促销",
    "app_api_key": "your_app_key",
    "campaign": "2024 假日",
    "adset": "Instagram Stories"
  }'

示例 2：创建具有自动生成活动和广告集的创意

curl -X POST https://app.audiencelab.ai/api/v1/creatives \
  -H "Content-Type: application/json" \
  -H "Audiencelab-Token: your_team_token" \
  -d '{
    "creative": "产品发布视频",
    "app_api_key": "your_app_key"
  }'

示例 3：JavaScript/Fetch

const response = await fetch("/v1/creatives", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Audiencelab-Token": "your_team_token",
  },
  body: JSON.stringify({
    creative: "品牌知名度广告",
    app_api_key: "your_app_key",
    campaign: "品牌活动",
    adset: "Facebook Feed",
  }),
});

const result = await response.json();
console.log("创意已创建:", result);

最佳实践

命名约定
- 为创意使用描述性、有意义的名称
- 活动名称应代表营销计划或时间段
- 广告集名称应指示定位或展示策略
资源管理
- 检查 is_new 标志以了解创建了哪些资源
- 尽可能重用现有活动和广告集以保持组织性
- 使用一致的命名模式以更好地管理资源
错误处理
- 始终检查错误响应
- 在发送请求之前验证必需字段
- 优雅地处理身份验证错误
速率限制
- 在请求之间实施适当的延迟
- 监控 API 使用情况以避免达到速率限制

集成说明

跟踪链接

每个创意都会获得一个唯一的跟踪链接
将 tracking_link 用作广告的最终目标 URL
链接格式：https://appstore-download.com/{creative_token}

资源 ID

活动和广告集名称用作标识符
对于创意，这些不必是唯一的
对于活动和广告集，将重用现有项目

应用程序隔离

应用程序 API 密钥根据您团队的应用程序进行验证

故障排除

常见问题

身份验证失败
- 验证您的 Audiencelab-Token 是否正确
- 确保令牌未过期或已被撤销
无效的 API 密钥
- 验证是否已在 Audiencelab 控制台中创建应用程序
- 确保 app_api_key 已正确复制且未被撤销
缺少必需字段
- 确保提供了 creative 字段
- 确保提供了 app_api_key 字段
- 检查 JSON 语法和 Content-Type 标头

支持

有关此 API 端点的其他支持或问题，请联系开发团队或参考内部 API 文档。

创意创建 API 端点

创意创建 API 端点

On this page