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

术语表

术语	定义
目录	A catalog holds the products you intend to sell. AppLovin recommends that you have only one catalog for all your products.
款式	Variants are individual SKUs to sell. Every SKU should be its own variant. The catalog manager considers variants that have the same itemId to be variants of the same item. For example, a Red Small Shirt, Red Large Shirt, and Blue Large Shirt by the same brand are each their own variant but share the same 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 的另一个款式时会被忽略。不能超过 256 个字符。
categoryId	Integer	是	Google 类别 ID
description	String	是	款式的简短描述。描述应简明扼要、信息完整，且不得超过 8192 个字符。
gender	String	否	FEMALE、MALE 或 UNISEX 之一
id	String	是	款式 ID。必须与像素代码中的 item_variant_id 相匹配。不能超过 64 个字符。
isAvailable	Boolean	是	款式是否有货或缺货
isBundle	Boolean	是	此款式是否为多个商品的组合套装销售。
itemId	String	是	商品不同款式共用的 ID。必须与像素代码中的 item_id 相匹配。不能超过 64 个字符。
multipackQuantity	Number	否	单独一包中相同物品的数量
name	String	是	款式的名称。不能超过 1024 个字符。
numberOfReviews	Number	否	该款式的评论总数
price	Decimal	是	款式的价格。如果该商品款式正在促销，价格应填写促销前的原价。
primaryImageUrl	String	是	The primary image associated with the variant, shown by default when the variant displays. Valid extensions are .jpg, .jpeg, and .png. Must be no longer than 2048 characters.
primaryVideoUrl	String	否	The primary video associated with the variant, shown by default when the variant displays. Valid extension is mp4. Must be no longer than 2048 characters.
rating	Decimal	否	款式的评分范围从 0 到 5。如果没有评分，则为 null。
rewardEndDate	DateTime	否	When the rewardPercent validity ends. Format this as a UTC time according to ISO-8601, without a time zone offset (for example: 2025-01-07T00:00:00). If rewardStartDate and rewardEndDate are both null, the rewardPercent is not active. If only rewardEndDate is null, the rewardPercent is active beginning at the rewardStartDate.
rewardPercent	Number	否	客户因购买该款式而获得的奖励百分比以 0 - 100 之间的数字表示
rewardStartDate	DateTime	否	When the rewardPercent begins to be valid. Format this as a UTC time according to ISO-8601, without a time zone offset (for example: 2025-01-01T00:00:00). If rewardStartDate and rewardEndDate are both null, the rewardPercent is not active. If only rewardEndDate is null, the rewardPercent is active beginning at the 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。该页面必须运行像素代码并触发查看商品事件。

警告

如果您的 CSV 数据中的某个条目包含双引号字符 (")，而又没有正确进行转义处理，可能会导致 CSV 解析器报错。您可以通过在双引号前添加反斜杠 (\) 来对其进行转义，例如：

id,name,itemId…
v0001,Lee \"Scratch\" Perry,i001…
v1234,Never Say \"Never Again\",i987…
⋮