使用目录管理器 (Catalog Manager) 配置动态广告

术语表

术语	定义
目录	目录中包含您要销售的产品。AppLovin 建议您在一个目录中包含所有产品。
款式	产品款式是可供销售的独立商品 SKU。每个 SKU 都应视为一个独立的款式。目录管理器会将带有相同 itemId 的款式视为同一产品的不同款式。例如同一品牌的红色小号衬衫、红色大号衬衫和蓝色大号衬衫分别是自己的款式但共用相同的 itemId。

开始使用

如果您是通过 Shopify 方法集成像素代码 (Pixel)，请联系您的客户经理。否则，请采取下列步骤：

1. 验证您的像素代码是否能发送 item_variant_id。
2. 下载 Catalog CSV 模板 并在其中填写您的产品目录信息。确保所有字段中都不包含逗号 (逗号只能用于分隔字段)。
3. 将 CSV 上传至可公开访问的位置。请参阅此示例。
4. 与您的 AppLovin 代表分享 CSV 下载链接。
5. 如有变更，请及时更新上传的 CSV。AppLovin 会在 UTC 每天 18:00 时自动同步新的变更至您的产品目录。

Variant 对象

字段	类型	是否必要？	描述
additionalImageUrls	String[]	否	与该变体关联的附加图片。有效的扩展名包括 .jpg、.jpeg 以及 .png。
additionalVideoUrls	String[]	否	与该变体关联的附加视频。有效的扩展名为 mp4。
ageGroup	String	否	ADULTS、 ALL_AGES、 INFANT、 KIDS、 NEWBORN 或 TODDLER 之一
brand	String	否	存在带有相同 itemId 的另一个款式时会被忽略
categoryId	Integer	是	Google 类别 ID
description	String	是	款式的简短描述
gender	String	否	FEMALE、MALE 或 UNISEX 之一
id	String	是	款式 ID。必须与像素代码中的 item_variant_id 相匹配。
isAvailable	Boolean	是	款式是否有货或缺货
isBundle	Boolean	是	此款式是否为多个商品的组合套装销售。
itemId	String	是	商品不同款式共用的 ID。必须与像素代码中的 item_id 相匹配。
multipackQuantity	Number	否	单独一包中相同物品的数量
name	String	是	款式的名称
numberOfReviews	Number	否	该款式的评论总数
price	Decimal	是	款式的价格
primaryImageUrl	String	是	与该变体关联的主图像，默认情况下在展示该变体时显示。有效的扩展名包括 .jpg、.jpeg 以及 .png。
primaryVideoUrl	String	否	与该变体关联的主视频，默认情况下在展示该变体时显示。有效的扩展名为 mp4。
rating	Decimal	否	款式的评分范围从 0 到 5。如果没有评分，则为 null。
rewardEndDate	DateTime	否	rewardPercent 有效期结束时间。请按照 ISO-8601 标准将其格式化为 UTC 时间，不包含时区偏移(例如：2025-01-07T00:00:00)。如果 rewardStartDate 和 rewardEndDate 均为 null，则 rewardPercent 处于非激活状态。如果只有 rewardEndDate 是 null，则 rewardPercent 从 rewardStartDate 开始处于激活状态。
rewardPercent	Number	否	客户因购买该款式而获得的奖励百分比以 0 - 100 之间的数字表示
rewardStartDate	DateTime	否	rewardPercent 生效的时间。请按照 ISO-8601 标准将其格式化为 UTC 时间，不包含时区偏移(例如：2025-01-01T00:00:00)。如果 rewardStartDate 和 rewardEndDate 均为 null，则 rewardPercent 处于非激活状态。如果只有 rewardEndDate 是 null，则 rewardPercent 从 rewardStartDate 开始处于激活状态。
salePrice	Decimal	否	该款式的促销价格。如果该款式未参与促销，则 null。
salePriceEndDate	DateTime	否	salePrice 有效期结束时间。请按照 ISO-8601 标准将其格式化为 UTC 时间，不包含时区偏移(例如：2025-01-07T00:00:00)。如果 salePriceStartDate 和 salePriceEndDate 均为 null，则 salePrice 处于非激活状态。如果只有 salePriceEndDate 是 null，则 salePrice 从 salePriceStartDate 开始处于激活状态。
salePriceStartDate	DateTime	否	salePrice 生效的时间。请按照 ISO-8601 标准将其格式化为 UTC 时间，不包含时区偏移(例如：2025-01-01T00:00:00)。如果 salePriceStartDate 和 salePriceEndDate 均为 null，则 salePrice 处于非激活状态。如果只有 salePriceStartDate 为 null，则 salePrice 将保持激活状态，直到 salePriceEndDate。
webUrl	String	是	产品登陆页 URL。该页面必须运行像素代码并触发查看商品事件。