# `ad extension lead-form` JSON 配置说明

为**已创建的 PMax 活动**挂载潜在客户表单（`LEAD_FORM`）。不走 `pmax-create` 主流程。

模板 JSON：同目录 [`pmax-lead-form-template.json`](pmax-lead-form-template.json)。

---

## 推荐命令顺序

```bash
# 1. 确认 PMax 活动 ID
siluzan-tso ad campaigns -a <accountId> --json-out ./snap

# 2. 查看 PMax 支持的扩展类型
siluzan-tso ad extension pmax-types --json-out ./snap

# 3. 检查活动上是否已有 Lead Form
siluzan-tso ad extension list -a <accountId> --type LEAD_FORM --campaign-id <campaignId> --json-out ./snap

# 4. 创建
siluzan-tso ad extension lead-form -a <accountId> --config-file ./lead-form.json --json-out ./snap

# 5. 更新（须带完整 leadForm 对象）
siluzan-tso ad extension update -a <accountId> --id <extensionId> --config-file ./lead-form.json
```

---

## 字段说明

| 字段                               | 类型     | 必填 | 说明                                                           |
| ---------------------------------- | -------- | :--: | -------------------------------------------------------------- |
| `account`                          | string   |  ✅  | Google 媒体客户 ID                                             |
| `campaignId`                       | string   |  ✅  | PMax 活动 ID（`channelTypeV2=PERFORMANCE_MAX`）                |
| `leadForm.businessName`            | string   |  ✅  | 商家名称                                                       |
| `leadForm.headline`                | string   |  ✅  | 表单标题                                                       |
| `leadForm.description`             | string   |  ✅  | 表单描述                                                       |
| `leadForm.privacyPolicyUrl`        | string   |  ✅  | 隐私政策 URL                                                   |
| `leadForm.finalUrl`                | string   |  ✅  | 落地页 URL                                                     |
| `leadForm.callToActionType`        | string   |      | 默认 `LEARN_MORE`                                              |
| `leadForm.callToActionDescription` | string   |      | 默认 `Contact us`                                              |
| `leadForm.fields`                  | object[] |  ✅  | 至少 1 项；`inputType` 如 `FULL_NAME`、`EMAIL`、`PHONE_NUMBER` |
| `leadForm.webhook`                 | object   |      | 写入 Google 的 Webhook（非平台接收端）                         |

---

## PMax 附加资产对照

| 中文          | 类型                 | CLI 命令                                                        |
| ------------- | -------------------- | --------------------------------------------------------------- |
| 宣传信息      | `CALLOUT`            | `ad extension callout`                                          |
| 结构化摘要    | `STRUCTURED_SNIPPET` | `ad extension snippet`                                          |
| 潜在客户表单  | `LEAD_FORM`          | `ad extension lead-form`                                        |
| 附加链接      | `SITELINK`           | `ad extension sitelink`                                         |
| 附加电话      | `CALL`               | `ad extension call`                                             |
| 私信 WhatsApp | `BUSINESS_MESSAGE`   | `ad extension whatsapp` 或 `campaignExtensions.businessMessage` |

**层级**：PMax 仅 `Account` / `Campaign`；`Ad Group` 会 **400**。

**副作用**：创建 Lead Form 后，后端会自动尝试将 `SUBMIT_LEAD_FORM` + `GOOGLE_HOSTED` 转化目标设为 `biddable=true`。

详见 `references/google-ads/pmax-api.md` § 附加资产。
