📦 目录（Catalog）
目录 是包含商品信息的对象（或容器），您可以将自己的库存上传到该目录中。目录可用于在所有 Meta 技术中销售和推广您的商品。
常见用途
- 精品栏广告： 展示商品目录中的商品
- 电商： 在 Marketplace 上发布商品
- 进阶赋能型目录广告： 自动展示相关商品
- Instagram 购物： 在 Instagram 上标记商品
- WhatsApp 对话式电商体验
上传方式
- 商品信息库： CSV、TSV、RSS、ATOM 或 Google Sheets
- 批量 API： 实时更新商品
- Pixel 像素代码： 通过网站自动捕获商品信息
目录基础知识
商品属性
| 属性 | 描述 | 必需 |
|---|---|---|
id | 唯一商品标识符 | 是 |
title | 商品名称 | 是 |
description | 商品描述 | 推荐 |
availability | 库存状态（in stock/out of stock） | 是 |
condition | 新旧程度（new/used/refurbished） | 推荐 |
price | 价格（含货币代码） | 是 |
link | 商品详情页 URL | 是 |
image_link | 商品图片 URL | 是 |
brand | 品牌名称 | 推荐 |
google_product_category | Google 商品类别 | 推荐 |
fb_product_category | Facebook 商品类别 ID | 推荐 |
item_group_id | 变体组 ID（用于关联多款式商品） | 变体商品必需 |
color | 颜色 | 变体推荐 |
size | 尺寸 | 变体推荐 |
gender | 适用性别 | 可选 |
inventory | 库存数量 | 推荐 |
立即开始
前提条件
catalog_management权限- Meta Business Manager 账户
- 商品信息数据（CSV/TSV/RSS/ATOM）
3 步设置
- 创建商品信息库： 上传包含商品数据的文件
- 选择商品类别： 指定商品的 Google 或 Facebook 类别
- 设置更新排期： 定期自动同步或手动更新
API 端点
# 创建目录
POST /{business_id}/product_catalogs
# 上传商品
POST /{catalog_id}/products
# 批处理更新
POST /{catalog_id}/batch
# 创建商品信息库
POST /{catalog_id}/product_feeds指南
类别管理
使用 Google 商品分类法或 Facebook 自定义分类对商品进行分类。类别影响广告投放和商品在 Marketplace 中的展示。
商品变体
使用 item_group_id 将同一商品的不同变体（如颜色、尺寸）关联。系统会将这些变体归为一组，用户可在广告中选择具体变体。
库存管理
通过实时 API 更新库存数量和上架状态，避免展示已售罄的商品。
商品信息库 API
支持 CSV、TSV、RSS、ATOM XML 和 Google Sheets 格式。可设置定期获取排期（每日/每周）。
深度链接
在 link 和 mobile_link 字段中使用深度链接，引导用户直达应用内的商品详情页。
微数据
在网站商品页面添加结构化微数据标记，帮助 Facebook 自动抓取和理解商品信息。
参考文档
| 端点 | 描述 |
|---|---|
/product_catalog | 目录对象管理 |
/products | 商品 CRUD |
/product_feeds | 商品信息库管理 |
/product_sets | 商品系列管理 |
/product_groups | 商品组管理 |
/batch | 批量商品更新 |
/check_batch_request_status | 检查批处理状态 |
/categories | 商品类别 |
/diagnostics | 目录诊断 |
/data_sources | 数据源管理 |